NAME

tkadmin backup lvol - backs up a logical volume

SYNOPSIS

tkadmin backup lvol -server servername lvolname [-fileprefix fileprefix] [-filesize filesize] [-nfiles nfiles]

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 to back up. 

[-fileprefix fileprefix] Specifies a prefix used for each backup filename. The prefix can be a complete or relative pathname used to write the backup files to a different location (for example, /bkups/sfsvol1 (UNIX), D:\bkups\sfsvol1 (Windows NT), or sfsvol1). Using the last example, the backup files are named sfsvol1.TRB.000000, sfsvol1.TRB.000001, sfsvol1.TRB.000002, and so on. A relative pathname is interpreted within the context of the server’s working directory. The default file prefix is the volume name. 

[-filesize filesize] Specifies the backup file size. The file size argument can be specified in bytes (an integer) or in kilobytes (an integer followed by the letter k - for example, 51k). The default file size is 1 megabyte. 

[-nfiles nfiles] Specifies the number of backup files to be created. The default number of files is 1. 

DESCRIPTION

The tkadmin backup lvol command backs up a logical volume by dumping its contents to a set of backup files. The tkadmin backup lvol command backs up the data only; it does not back up data structures such as files or queues. To use the command, media archiving must be enabled by using the tkadmin enable mediaarchiving command. You can back up a volume while the server is running, although performance may be slowed. 

You can create a complete backup by reissuing the tkadmin backup lvol command with no options. The command creates one 1-megabyte backup file each time the command is issued and returns a warning until a complete backup containing enough files to restore the entire volume exists. If a volume is very large, you can specify a file size and number of files sufficient to create a complete backup with one or two issues of the command. 

EXAMPLES

Enter the following command to create a complete backup of a 200-kilobyte volume named debitvol with five files of 41 kilobytes each (each file allows 1 kilobyte for header information):

% tkadmin backup lvol debitvol -filesize 41k -nfiles 5

The backup files created are named debitvol.TRB.000000, debitvol.TRB.000001, debitvol.TRB.000002, and so on. 

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 enable mediaarchiving

tkadmin query backup

tkadmin query lvol

  —  March 1997