nsrim

The nsrim program manages the Backup server's client file indexes and media database. Typically, the nsrim program is run automatically by the nsrmmdbd daemon when a scheduled backup starts, by the savegrp program upon completion of the backup, and by nsrd as a result of selecting the option to remove the oldest index cycle. Ordinarily, you should not run the nsrim program manually.

The nsrim program accesses the defined policies to determine how to manage each client's file index. Entries that have existed in the index longer than the period specified by the client's defined browse policy are removed from the client's file index. Save sets that have existed in the media database longer than the period specified by the client's defined retention policy are marked as recyclable in the media database. When all of the save sets contained on a single volume are marked recyclable, the volume itself is considered recyclable. Recyclable volumes may be selected and, in the case of volumes managed by an autochanger, automatically relabeled for use by Backup when a writable volume is requested for another backup. After you relabel the recycled volume, the data once contained on it is destroyed. Until you relabel the volume, you can still use the scanner program to recover the save sets. See "scanner " for information on how to use the scanner program.

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

nsrim [-b browse] [-c client] [-N saveset]

[- r retention] [-x percent] [-lnqvMX] 

• Use the -b browse option to use the policy specified by browse instead of the browse policy defined in the client's resource. This option is useful when combined with the -n option to determine the potential effect of a modified policy on the client file indexes.

• Use the -c client option to process only the client file index for the client specified. If you do not specify this option, all the client file indexes managed by the Backup server are processed. You can repeat multiple -c client options on the same command-line.

• Use the -l option to remove the oldest level full save and all save sets that depend on it from the client file index. This option is only acted on if there is more than one cycle of the save set in the client file index. This option ignores the browse and retention policies assigned to the client's resource. The save set's header information prints out the number of browsable full cycles that are currently maintained in the client file index. This option ignores any archive or migration save sets contained in the index. Manual save set entries are treated as if they were run as an incremental level save set. The -l option sets the utilization threshold to 30 percent.

• Use the -M option to use the nsrim program in master mode (which is not advised for manual operation). This option advises nsrim that nsrd or another Backup daemon invoked nsrim, and logs messages with timestamps, as well as performs any other behavior expected by nsrd.

• Use the -N saveset option to process only the named saveset; all other save sets encountered are skipped. This option may be repeated multiple times on the same command line.

• Use the -q option to run nsrim in quiet mode. This option omits the generation of header, trailer, or save set messages.

• Use the -r retention option to instruct nsrim to use the policy specified for retention rather than the retention policy defined by the client's resource. This option is useful when combined with the -n option to determine the potential effect of a modified policy on the client file indexes.

• Use the -x percent option to set the utilization threshold. If, after removing entries, a client file index's utilization is less than the specified amount, the value of percent is passed to nsrindexd when a cross-check is requested. The default value of percent is 50. If you specify either the -X or -l options, the utilization threshold changes to 30 percent.

• Use the -v option to run nsrim in verbose mode. This option may produce an especially large amount of output. If you specify both the -q and -v option together, the options cancel out each other's effect.

• Use the -X option to check the consistency of the save set data structures with the volume data structures. The only time you would need this option is if a Backup were to crash occur. This option sets the utilization threshold to 30 percent.

  Refer to the nsrim(1m) man page for further details and a list of the most common error messages encountered.