nsrmig

The nsrmig program migrates files to the volumes labeled for a Migration pool type. The migrated files are replaced with a stub (a symbolic link) that points to a copy of the file made during premigration with the nsrpmig program. If you access the stub later, the file is automatically recalled to disk from the migration volume by the Backup server or storage node.

The criteria for migration is defined in the Migration resource on the Backup server. Migration is usually an automatic process controlled by the Backup server. The criteria most often employed is last access time. Only regular files are premigrated and, ultimately, migrated.

If you do not specify a path argument, the current directory is migrated. The nsrmig program does not cross mount points, and it does not follow symbolic links.

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

nsrmig [-nvx] [-l percent] -s server] [-t savetime] [-W width] [path]

• Use the -l percent option to specify a goal percentage for the nsrmig program to use. Migration stops when the goal percentage is reached. If the goal percentage is already reached before you invoke nsrmig, the program exits without performing any further migration. If you do not specify the -l option, the goal percentage is read from the appropriate migration client resource.

• Use the -n option to estimate the number of files and total size that are freed by replacing the files that qualify for migration with a stub, but do not replace the files with stubs.

• 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 -t savetime option to migrate files that were premigrated at the specified savetime.

• 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 nsrmig should use to format summary information to standard output. The default width used is 80.

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

  Refer to the nsrmig(1m) man page for further details and common error messages encountered.