nsrpmig

The nsrpmig program premigrates files that are identified as candidates for migration, as defined in the Backup server's Migration resource. The premigration process invokes the save program to immediately make a copy of the specified file to a backup volume labeled for migration data. When the file is later migrated, the resident file is replaced with a marker that refers to the premigrated copy on volume. You can only premigrate regular files.

The nsrpmig program does not cross mount points or follow symbolic links. If you mount the path to be saved from a network file server, the nsrpmig program issues a message that instructs the user to run the save program on the remote machine or use the -L option with nsrpmig.

The nsrpmig program examines the directive files (.nsrhsm) encountered in each directory to determine any special instructions to apply when saving files (for example, compression and skip directives). The directive files ordinarily used by Backup for save and recover operations (.nsr) are ignored by the nsrpmig program.

The nsrpmig program is only available for use when an enabler code for the Backup HSM is present on the Backup server.

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

nsrpmig [-BEiLnpqvx] [-s server] [-N name]

[- f dirfile] [-b pool] [-g group]

[-m masquerade] [-W width] [-C clone-pool]

[-I input-file] path

• Use the -b pool option to specify the volume pool to which the premigrated data should be saved. Migrated data must reside on separate volumes from either backed-up data or archived data. If you do not specify a pool, the Migration pool is selected by default.

• Use the -B option to force a save of all connecting directory information, from the root (/) to the point of invocation.

• Use the -C clone-pool option to generate a clone of the premigrated save set to the specified clone pool. Clones of migrated data must reside on separate volumes from either backed-up or archived clone data. If you do not specify a clone pool, the Migration Clone pool is selected by default.

• Use the -E option to instruct nsrpmig to estimate the amount of data that the save program generates, then perform the save operation. The estimate is generated from the inode information, so the data is only read once.

• Use the -f dirfile option to specify a file that nsrpmig should read prototype default directives from [refer to the nsr(5) man page for more information on the default directives]. A value of - for dirfile causes the default directives to be read from standard input.

• Use -g group option to denote the group name to which the save set should belong. The Backup server uses this option to select a specific media pool.

• Use the -i option to instruct nsrpmig to ignore any .nsrhsm directive files encountered during the premigration process.

• Use the -I input-file option to instruct nsrpmig to read the paths to save from the file specified as input-file in addition to those listed on the nsrpmig command line. List each path on a separate line in the file specified by input-file. If you do not also specify paths on the command line, only the paths specified in input-file are saved.

• Use the -L option to instruct nsrpmig to perform a local save from the Backup client, even if the files originate from a network fileserver. To recover files that have been locally premigrated, run the recover program with the -c client option, where the value for client is the machine name of the Backup client that performed the save operation.

• Use the -LL option to instruct nsrpmig to perform a local save and print an extra line at the end of the completion in the format complete savetime=number where number is the save time of the save set created. The savegrp program uses this option when you specify automatic cloning.

• Use the -m masquerade option to specify a tag to precede the savegroup summary notification line. The savegrp and savefs programs use this option to aid in savegroup summary notifications.

• Use the -n option to estimate the amount of data that is generated by the save without performing the save. This option is similar to the -E option, except that data is not saved to a volume after the estimate is completed.

• Use the -N name option to instruct nsrpmig to use the symbolic name of the save set. By default, the path argument is used as the save set name.

• Use the -p option to cause the save program invoked by nsrpmig to exit with a status value of 0. The server uses this option to determine whether a client is installed properly.

• Use the -q option to cause the save program invoked by nsrpmig to display only summary information and error messages.

• Use the -s server option to specify the machine to use as the Backup server. If you omit this option, the default machine considered is either the current machine (if it is a Backup server) or a machine with the logical name of nsrhost entered in the host table.

• Use the -v option to cause the save program invoked by nsrpmig to provide detailed information as it proceeds.

• Use the -W width option to specify the width that nsrpmig should use to format summary information to standard output. The default width used is 80.

• Use the -x option to instruct nsrpmig to cross mount points.

  See "save " and "savegrp " for more information on the save and savegrp program options described in this section. Refer to the nsrpmig(1m) man page for further details and common error messages encountered.