save

The save program, which resides on each Backup client, saves files. You can monitor the progress of a save operation using the X Window System-based nwadmin program or the curses (3X)-based nsrwatchAdministration program.

If you do not specify a path argument either on the command line or through the -I option, the current directory that save is invoked from is saved. The save program saves a directory by saving all the files and subdirectories it contains. The save program does not cross mount points, and it does not follow symbolic links. If you mount the paths indicated from a network file server, the save program instructs you to run the save program on the remote machine, or use the -L option.

Each file in the subdirectory structures specified by the path option is encapsulated in a Backup save stream. This stream of data is sent to a receiving process on the Backup server, which processes the data and adds entries to the client file index for each file in the stream. The data is then directed to long-term storage, either on the server or the designated storage node.

The server's bootstrap and the client file indexes are only backed up automatically during a scheduled or manual backup that invokes the savegrp program. If you never run the savegrp program, either a scheduled or manually invoked backup, you do not have the server bootstrap or client file indexes that are vital to the disaster recovery process.

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

save [-BEiLnqvx] [-s server] [-c client-name]

[- N name] [-e expiration] [-f directory-file]

[-b pool] [-F file] [-I input-file] [-g group]

[-l level] [-t date] [-m masquerade] [-W width]

[path...]

• Use the -b pool option to specify a particular destination pool for the save sets.

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

• Use the -c client-name option to specify the client name that starts the save session. This is useful for clients with multiple network interfaces and, hence, multiple hostnames. You can use the option to create multiple client file indexes for the same physical client machine. This option does not specify the network interface to use; the network interface is specified in the Network Interface attribute of the nsr_client resource.

• Use the -e expiration option to set the date when the save set expires. When a save set has an explicit expiration date, the save set remains both browsable and nonrecyclable until it expires. After the expiration date, the save set is nonbrowsable. If it has expired and also passed its retention time, the save set becomes recyclable. By default, explicit save set expiration dates are not used.

• Use the -E option to estimate the amount of data that is generated by each save set before the save operation is actually performed. This option results in a double traversal of the filesystems: once to generate an estimate and again to perform the save operation. The data itself is only read from the disk on the final pass, because the estimate is performed by accessing the inode information.

• Use the -f dirfile option to specify the file from which the save program should read the prototype default directives. A dirfile value of - causes the default directives to be read from standard input.

• Use the -F file option to save only files whose change time is newer than the file modification date of the specified file.

• Use the -g group option to denote the group to save. Use this option to determine the specific pool to which save sets from the specified group should be written.

• Use the -i option to instruct the save command to ignore any.nsr directive files encountered in the subdirectory structures saved.

• Use the -I input-file option to read the paths to save from the named text file, in addition to the paths listed on the command line. The paths must be listed one per line. If no paths are listed on the command line, only the files contained in the paths listed in input-file are saved.

• Use the -l level option to specify the level of the save.

• Use the -L option to perform a save from the local Backup client, even when files are from a network fileserver. To recover files, you must run the recover program with the same -c client argument used to save the data.

• Use the -LL option to treat the backup as a local save and print an extra line at the end of the completion report in the form complete savetime=number where number is the savetime of the save set created by this backup. This option is meant for use by the savegrp command for automatic cloning.

• Use the -m masquerade option to specify the tag to precede the summary line in the savegroup completion report.

• Use the -n option to estimate the amount of data that will be saved, without performing a save operation.

• Use the -N option to specify the symbolic name of the save set. By default, the most common prefix of the path argument is used as the save set name.

• Use the -q option to run the save program in quiet mode. This option generates only summary information and error messages.

• Use the -t date option, in nsr_getdate(3) format,to specify the date after which files must have been modified to qualify for a save.

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

• Use the -W width option to format summary information output.

• Use the -x option to cross mount points during the save operation.