NAME

tkadmin query restore - obtains information about a restore

SYNOPSIS

tkadmin query restore -server servername

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. 

DESCRIPTION

The tkadmin query restore command can be used to monitor the progress of an ongoing restore at the server that initiated the restore. Restoring a set of volumes is a two-step process. The first step is to copy the contents of each volume in from one or more backup files. Second, the log records corresponding to the volume updates performed after the backup was taken are replayed.  The information displayed by this command can help you monitor the restore process. 

The tkadmin query restore command displays several lines of general information, including

The number of volumes being restored. 

The number of log records that have been replayed. 

The archive file being processed. (If the archive files are not yet in use, the first archive file required is listed.) 

Following the general information, specific information about each volume being restored is displayed, including

The name of the volume. 

The state of the restore for this volume. The states include “not yet started”, “copying file x of y ”, “copied all files”, “replaying log records”, or “volume is restored”. 

The backup number used to restore the volume. 

The current backup file being copied (if any). 

The next backup file to be copied (if any). 

EXAMPLES

In the following examples, an ongoing restore of the testVol volume is queried. 

% tkadmin query restore

Number of volumes being restored by the server: 1
So far, 0 log records have been replayed
Processing MRA file: MRA00000000
Restore of Volume testVol:
        State: copied 2 out of 4 files.
        Backup Number: 18
        Current File: <directory path> testVol.TRB.000017
        Next File Required:
         <directory path> testVol.TRB.000018

% tkadmin query restore

Number of volumes being restored by the server: 1
So far, 9000 log records have been replayed
Processing MRA file: MRA00000002
Restore of Volume testVol:
        State: replaying log records.
        Backup Number: 18

% tkadmin query restore

Number of volumes being restored by the server: 1
So far, 60850 log records have been replayed
Processing MRA file: MRA00000003
Restore of Volume testVol:
        State: replaying log records.
        Backup Number: 18

PRIVILEGE REQUIRED

Encina RQS query (q) permission to the RQS server

Encina SFS query (Q) permission to the SFS server

RELATED INFORMATION

tkadmin restore lvols

tkadmin query backup

  —  March 1997