NAME

tkadmin truncate backup- invalidates information about old backups

SYNOPSIS

tkadmin truncate backup -server servername lvolname backupfilenum

ARGUMENTS

-server servername Specifies the server affected by the command. The server name is the name that is registered with the DCE Directory Service. If the server name is not specified in the command line, it is retrieved from an environment variable, ENCINA_TK_SERVER. 

lvolname Specifies the logical volume that was backed up. 

backupfilenum Specifies the number of the earliest complete backup for which to retain information. The number of the backup corresponds to the file sequence number of the backup file that ends the complete backup.  For example, a backup consisting of files 1 through 5 is referred to as backup 5. 

DESCRIPTION

The tkadmin truncate backup command invalidates information about all backup files that are older than the complete backup specified for the backupfilenum argument. This command does not actually remove any backup files; it simply frees recoverable storage used by the server to maintain information about the backups.  Upon successful completion, the command lists the backup files about which information was invalidated. These files can be deleted safely by using operating system commands. After old backups are invalidated and removed, the associated log archive files can also be deleted. 

EXAMPLES

Suppose that a volume named debitvol has two complete backups, one consisting of files 0 through 4 and the other consisting of files 1 through 5. Enter the following command to remove information about backups older than backup 5 for the volume:

% tkadmin truncate backup debitvol 5

The following 1 files are no longer needed:
0: /etc/backup/debitvol.TRB.000000

As the output indicates, backup file 0 is no longer needed and can be deleted safely. 

PRIVILEGE REQUIRED

Encina Monitor administer (a) permission to the node manager

Encina RQS administer (a) permission to the RQS server

Encina SFS administer (A) permission to the SFS server

RELATED INFORMATION

tkadmin retain backups

tkadmin query backup

  —  March 1997