Storix Software SBAdmin Commands Reference - Manual (Page 32)

Storix System Backup Administrator - 32 - Version 8.2 Commands Reference
This command requires that a library is already configured. Steps to configuring a random
library must be performed using the SBAdmin user interface. Refer to the
SBAdmin User
Guide for details.
Operations which require access to the tape drive itself require that you specify the device
name. For instance, you can display the inventory for a library by specifying the library name,
but to check if a tape is loaded in the library device, you must use the device name (only then
do we know the names of the physical devices attached to the library).
If using the Network Edition, you must also supply the server name with the –server flag.
To check if a tape is currently loaded in the library, use the command:
stlibary –c –s servername vdev
To display the tape inventory on the library, use the command:
stlibrary –I libname
Set or Reset the next tape to use for backups/restores:
SBAdmin backup jobs performed to a device configured as a tape library require that the next
tape to use, or the current tape in the drive, be known before the backup begins. SBAdmin will
then keep track of the tape that is in the drive, or the next/last one used as the backup
progresses. If you have manually moved a tape in the library, or ejected a tape for the drive,
you must reset the current or next tape to use when the next backup or restore is performed.
To do so, use the command:
stlibrary –r –tape tapenum –drive drivenum libname
Note that the tapenum and drivenum are numbers, starting with 1, which represent the tape
slots and drive slots in the library. It is assumed that tapenum is in its current slot in the library
and will be moved to its drive the next time a backup is performed. If tapenum is already
inserted in the drive, you must add the –inserted flag.
To move tapes in the library:
You need only specify the tapenum to move and the direction (load from slot to drive or
unload from drive to slot) and whether or not the tape must first be ejected from the drive.
This assumes that the current positions of the tapes in the library are correct (refer to Set or
Reset next tape” above). For example:
stlibrary –Uet3 libname
or
stlibrary –Ue --tape 3 libname
The above commands will move tape number 3 from the drive to its original slot in the library
after ejecting it from the drive. If using Network Edition, add the –server option if remote. Note
that you can also specify a device name to use in place of the library name.