Stbuildlabel – Storix Software SBAdmin Commands Reference User Manual

Page 9

Advertising
background image

Storix System Backup Administrator

- 9 -

Version 8.2 Commands Reference

stbuildlabel

Purpose:

Rebuild a backup label that is missing or expired

Use on:

Administrator

Syntax:

stbuildlabel [options] {–d device|directory}

-d device/API,
--device
device

Tape or directory device on the server (i.e. “rmt0”). If rebuilding a label from
backups written to a directory, you must also supply the –l backupid option.

Options:

-l, --label backupid/all

The Backup ID of the backup you want to rebuild the label for or “all”
backups located in the directory. This option is only available for
backups written to disk.

-s --server server

Server on which the backup device is configured. If using a TSM or NFS
server, use the format “TSM@servername” or “NFS@servername”.

-O --owner owner

If backup is on a TSM server, indicate –O original API client (nodename)

-h --help

Show help and usage for the command

Details:

This command is used to rebuild a backup label file by reading each backup header on the
media. For backups written to tape, this process will forward past the backup and check for
additional backups and append backup information to the header file.

Backups written to disk, NFS, or TSM can also be used to recreate backup labels. All backup
files must be available when rebuilding backup labels.

For backups written to disk, you must specify the Backup ID of the backup you want to rebuild
the backup label. If you do not know or have more than one, you can specify “all” and all
backups located on the device without a label with be rebuilt.

For tape backups, the stbuildlabel command will forward through the entire tape to locate all
backups. Use CTRL-C to stop the stbuildlabel command from reading through the entire tape if
you know all labels have been rebuilt.

Advertising