NAME

tkadmin restore logvol - restores the data of a logical volume storing log data

SYNOPSIS

tkadmin restore logvol -server servername logVolName archDevName archFileName

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. 

logVolName Specifies log volume to be restored. 

archDevName Specifies archive device associated with the log volume to be restored. 

archFileName Specifies the latest archive file to use in the restore. 

DESCRIPTION

The tkadmin restore logvol command restores a log volume that was damaged by media failure using archive files associated with the log volume. The command requires the user to specify the latest archive file to be used in the restore.  Typically, this is the last complete archive file generated during normal server operation. (Online archive files may not be destroyed in the media failure. You should attempt to save and use the latest complete archive files available.) 

Before restoring a damaged log volume, the server must be restarted in administrative mode and the volume must be relocated onto functional physical storage. 

The server’s log service component first reads the specified archive file from the archive device. Then, a range of archive files are read in, ending with the specified file. For example, if the user specifies logvol.LA.12 as the latest archive file to use in the restore, the server reads that file and then a range of files from logvol.LA.n to logvol.LA.12, where n is less than or equal to 12. 

Messages are displayed by the server naming the required archive file, if the required archive file is not available online. After fetching the named archive file, you must inform the server of its accessibility via the tkadmin enable archfile command. 

EXAMPLES

UNIX

The following command restores the sfs1logvol log volume using archive files in the /opt/encinalocal/branch1/server/sfs1/archives directory. The latest archive file used in the restore is number 32. 

% tkadmin restore logvol sfs1logvol /opt/encinalocal/branch1/server/sfs1/archives sfslogvol.LA.32

Windows NT

The following command restores the sfs1logvol log volume using archive files in the D:\opt\encinalocal\branch1\server\sfs1\archives directory. The latest archive file used in the restore is number 32. 

C:\> tkadmin restore logvol sfs1logvol D:\opt\encinalocal\branch1\server\sfs1\archives sfslogvol.LA.32

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 query logvol

  —  March 1997