nsrmm

The nsrmm program provides a command line interface to manage the media and backup devices used by Backup servers and storage nodes.

The following examples describe the format and options available for the nsrmm program:

nsrmm [-C] [-v | -q] [-s server] [-f device]
nsrmm -m [-v | -q] [-s server] [-f device] [-r]

[volume-name]
nsrmm -l [-v | -q] [-s server] [-f device] [-myB] [-e expiration] [-c
capacity] [-o mode] [-b pool] [-R | volume-name]
nsrmm {-u | -j} [-v | -q] [-s server] [-y]

[-f device | volume-name]
nsrmm -p [-v | -q] [-s server] [-f device]
nsrmm {-d | -o mode} [-v | -q] [-s server] [-Py] [S ssid[/cloneid] |
-V volume-id | volume-name...] 

• Use the -B option to verify that the volume you want to label does not have a readable Backup label. If you specify this option and the volume has a valid Backup label, the label operation is canceled and an error message is displayed.

• Use the -b pool option to specify the pool to which the volume should be assigned. If you omit this option, the volume is automatically assigned to the Default pool. If you specify a pool name without specifying a volume name, the next volume name associated with the pool's label template resource is used.

• Use the -C option to display a list of Backup-configured devices and the volumes currently mounted in them. The information is gathered from what the server inventory shows, and does not perform an actual volume operation, unlike the -p option described later. The -C option is the default.

• Use the -c option to override a volume's default capacity. Backup normally uses built-in default capacities, based on the device's type. The format of the specification is number multiplier. Number may be any value, including an integer or real number, with up to three decimal places. Multiplier may be one of "K" (1024 bytes), "M" (1000K), or "G" (1000M). Lowercase letters are acceptable, as are extra characters.

• Use the -d option to delete the client file indexes and media database entries from the Backup databases. This action does not destroy the data contained on the volume: instead, it removes all references used by Backup to the volume and the user files contained on it. You can use this option to control the size of the Backup databases.

• Use the -e expiration option to set the expiration date for volume relabel. This option overrides the default label expiration, which is two years. The value of expiration is entered in the format described in a special value of forever that is used for migration and archive volumes means that the volume label never expires.

• Use the -f device option to explicitly specify a device. When you configure more than one device, the nsrmm program selects the first device by default.

• Use the -j option to eject a volume from the device. This is similar to performing an unmount operation, except that the volume is also physically ejected from the device, if possible. This option is not available with many devices and media types.

• Use the -l option to label a volume for Backup to recognize and use. You must physically load the volume into the device, either by an operator or autochanger, before the label operation can proceed.

• Use the -m option to mount a volume in a device. The mount operation is performed after the volume is placed in the device and labeled; therefore, only labeled volumes can be mounted. You can combine the label and mount operation in one command line.

• Use the -o mode option to set the mode of a volume, save set, or save set instance (clone). Choose one valid mode value: [not]recyclable, [not]readonly, [not]full, [not]manual, or [not]suspect. The [not]recyclable mode applies to volumes or save sets, but not to clones. The [not]readonly, [not]full, and [not]manual modes are the only valid modes you can use with the -l option. The [not]suspect mode applies only to clones. You must specify the [not]suspect mode if you use the -S option with an ssid/cloneid specification. You do not need to specify the [not]suspect mode if you only specify ssid with the -S option. The suspect flag is set automatically when a recover operation encounters a media error when attempting to recover data from a particular save set clone.

• Use the -P option in conjunction with the -d option to purge the corresponding client file index entries, without deleting the entries in the media database. You can then use the scanner command to recover the file index entries.

• Use the -p option to verify and print a volume's label. When you use this option, mounted volumes are unmounted to verify the label.

• Use the -R option to relabel a volume. This option rewrites the volume's label and purges the client file index entries for all of the user files saved on the volume. Some of the volume usage information is maintained.

• Use the -r option to mount a volume as read-only. Volumes that are marked as full and volumes whose mode is set as read-only with the -o option are automatically mounted as read-only.

• Use the -s server option to specify the Backup server on which you want to invoke nsrmm.

• Use the -S ssid option with the -o option to change or the -d option to remove a save set from the Backup databases. The save set is specified by an ssid. A save set instance (clone) can only be specified with the -o option, using the format ssid/cloneid. You can use the mminfo program to determine the ssid and cloneid values.

• Use the -u option to unmount a volume. You should always unmount a volume before you unload it from a device.

• Use the -V volid option in conjunction with the -d option to remove a volume from the Backup server's media database. You can determine the value of the volume identifier (volid) with the mminfo program.

• Use the -v option to run the nsrmm program in verbose mode.

• Use the -y option to turn off confirmation of potentially destructive operations before nsrmm performs them. Use this option with extreme caution.