ENCINA(8) — Maintenance

NAME

tkadmin query backup - displays information about a backup of a volume

SYNOPSIS

tkadmin query backup -server servername lvolname [-all] [-backupfilenum backupfilenum] [-count count]

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.

[-all] Displays information for all backups of the volume.

[-backupfilenum backupfilenum]
Specifies the sequence number of the backup file name for which to display information. The default is the sequence number of the last complete backup of the volume.

[-countcount] Specifies the number of complete, independent backups for which to display information, starting with the most recent backup.

DESCRIPTION

The tkadmin query backup command displays information about the last complete backup for the specified volume. Where multiple backups of a volume exist, information about a specific backup can be displayed by using the -backupfilenum option. Alternatively, information about a specified number of complete, independent backups can be displayed with the -count option, or information about all backups of a volume can be displayed with the -all option.

The command displays the following information for each backup file:

The directory in which the backup file was or is being written.

The backup file name.

The date the backup was started.

The state of the backup file. The state of a backup file can be in progress if the file is not complete, or end of backup if the file ends a complete backup. If no state is displayed, the file is complete.

For each complete backup, the output displays the earliest log archive file required to restore the volume with the backup.

EXAMPLES

Enter the following command to display information about the most recent backup of the volume testVol:

% tkadmin query backup testVol

A backup for volume testVol comprises 4 files:
In directory <directory path>:
    testVol.TRB.000015 (started Tue Oct 3 19:14:32 1995,
                                end of backup 15)
    testVol.TRB.000016 (started Tue Oct 3 19:21:31 1995,
                                end of backup 16)
    testVol.TRB.000017 (started Tue Oct 3 19:28:32 1995,
                                end of backup 17)
    testVol.TRB.000018 (started Tue Oct 3 19:35:30 1995,
                                end of backup 18)
Earliest MRA file required for this backup: log/logvol.LA.92

Enter the following command to display information about all backups of the volume Lvol:

% tkadmin query backup Lvol -all

Volume Lvol contains the following complete backups.
(The most recent backup appears first.)
1: The first complete backup comprises the following 3 files:
In directory <directory path>:
        Lvol.TRB.000047 (started Wed Oct 4 16:47:55 1995)
        Lvol.TRB.000048 (started Wed Oct 4 16:47:57 1995)
        Lvol.TRB.000049 (started Wed Oct 4 16:48:00 1995)
Earliest MRA file required for this backup: log/logvol.LA.92
2: The second complete backup comprises the following 3 files:
In directory <directory path>:
        Lvol.TRB.000044 (started Wed Oct 4 16:47:38 1995)
        Lvol.TRB.000045 (started Wed Oct 4 16:47:40 1995)
        Lvol.TRB.000046 (started Wed Oct 4 16:47:41 1995)
Earliest MRA file required for this backup: log/logvol.LA.91
3: The next complete backup comprises the following 3 files:
In directory <directory path>:
        Lvol.TRB.000041 (started Wed Oct 4 16:45:28 1995)
        Lvol.TRB.000042 (started Wed Oct 4 16:47:34 1995)
        Lvol.TRB.000043 (started Wed Oct 4 16:47:36 1995)
Earliest MRA file required for this backup: log/logvol.LA.88
4: The next complete backup comprises the following 3 files:
In directory <directory path>:
        Lvol.TRB.000038 (started Wed Oct 4 16:45:22 1995)
        Lvol.TRB.000039 (started Wed Oct 4 16:45:24 1995)
        Lvol.TRB.000040 (started Wed Oct 4 16:45:26 1995)
Earliest MRA file required for this backup: log/logvol.LA.88
5: The next complete backup comprises the following 3 files:
In directory <directory path>:
        Lvol.TRB.000035 (started Wed Oct 4 16:45:15 1995)
        Lvol.TRB.000036 (started Wed Oct 4 16:45:17 1995)
        Lvol.TRB.000037 (started Wed Oct 4 16:45:18 1995)
Earliest MRA file required for this backup: log/logvol.LA.88

Enter the following command to display information about the last two complete, independent backups of the volume Lvol:

% tkadmin query backup Lvol -count 2

PRIVILEGE REQUIRED

Encina RQS query (q) permission to the RQS server

Encina SFS query (Q) permission to the SFS server

RELATED INFORMATION

tkadmin backup lvol

tkadmin query restore

tkadmin retain backups

— March 1997

Museum