NAME

tkadmin retain backups - retains information about the specified number of complete, independent backups

SYNOPSIS

tkadmin retain backups -server servername lvolname numbackups

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. 

numbackups Specifies the number of complete, independent backups about which to retain information. 

DESCRIPTION

The tkadmin retain backups command retains information about a specified number of complete, independent backups, starting with the most recent backup, and invalidates information about older backups. This command does not actually remove backup files; it frees recoverable storage used by the server to maintain information about the backups. Upon successful completion, this command lists the backup files about which information was invalidated. These files can be deleted safely by operating system commands. After old backups are invalidated and removed, the associated log archive files can also be deleted. 

Two backups are independent if they do not overlap or share any files. For example, assume the volume testVol has several complete backups: the first backup consists of files 0 through 4, the second backup consists of files 1 through 5, and so on. Files 0 through 4 and 5 through 9 are independent backups. If you issue the tkadmin retain backups command and specify a value of 2 for the argument numbackups, the server keeps information about the last 2 independent backups and invalidates files all older backup files, which can then be safely deleted. 

You can remove all backup information for a volume by specifying 0 (zero) as the numbackups argument. Note that if you delete all backup information for a volume, you can no longer restore the volume from a backup in the event of media failure. 

EXAMPLES

The following command retains information for the last two independent backups (consisting of files 5 through 9 and 10 through 14) for volume testVol :

% tkadmin retain backups testVol 2

Truncated backup for volume testVol
The following files are no longer needed.
numfiles: 5
     0: testVol.TRB.000000
     1: testVol.TRB.000001
     2: testVol.TRB.000002
     3: testVol.TRB.000003
     4: testVol.TRB.000004

As the output indicates, backup files 0 through 4 are 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 backup lvol

tkadmin query backup

tkadmin truncate backup

  —  March 1997