nsrstage

The nsrstage program is used on a manual basis to migrate existing save sets from one volume to another. The process begins with a clone of the specific save sets to the new volume specified, followed by deletion of the save set entries from the media database, and finally a removal of the save sets from the original source volume, if possible. The media database entries and save sets are not removed if the clone to the new volume does not succeed.

You can migrate save sets onto volumes that belong to any of the media types supported by Backup (for example, save sets on a file volume may be migrated to an optical disk). However, all volumes used as the destination of a nsrstage operation must belong to a Clone pool type. Refer to the nsr_pool(1m) man page for a description of the various pool types.

The nsrstage program does not perform simple volume migration; it migrates complete save sets. You can specify the copy (clone) of a save set to use as the migration source with the -S ssid option.

The following example describes the format and options available for the nsrstage program:

nsrstage [-v] [-s server] [-b pool] -m

[-S {ssid/cloneid}]
nsrstage [-v] [-s server] -C -V volume

• Use the -b pool option to specify the name of the clone pool to which the data should be migrated. If you omit this option, the cloned save sets are automatically sent to the Default Clone pool.

• Use the -C option to instruct nsrstage to perform a volume cleaning operation after the save sets have been migrated and their associated entries removed from the media database. You can only use this option with entries that are migrated from a file volume.

• Use the -m option to perform the actual migration.

• Use the -s server option to specify a Backup server to migrate save sets from. If you omit this option, the current machine is selected by default.

• Use the -S ssid (or ssid/cloneid) option to specify one or more specific ssids and clone IDs that you want to migrate. The ssid option is useful when you want to migrate individual save sets from a volume. The cloneid option is useful when you want to specify a particular copy of a save set for migration. The value of either identifier is an unsigned integer; when you specify both you must separate them with a slash (/)character. You can issue the mminfo -v command to determine the value to use for ssid or cloneid (see "mminfo " for details).

• Use the -v option to run nsrstage in verbose mode. This mode provides additional information during the process, for example, messages about save sets that cross volumes.

• Use the -V volume option to specify the name of the volume that nsrstage should clean. You cannot use this option in conjunction with the -S or -m options.

  Refer to the nsrstage(1m) man page for examples and error messages for the nsrstage program.