Legato NetWorker Commands Index:
ansrdascdcode
cdi_block_limits
cdi_bsf
cdi_bsr
cdi_eod
cdi_filemark
cdi_fsf
cdi_fsr
cdi_get_config
cdi_get_status
cdi_inq
cdi_load_unload
cdi_locate
cdi_offline
cdi_rewind
cdi_set_compression
cdi_space
cdi_ta
cdi_tapesize
cdi_tur
changers
dasadmin
ddmgr
EMASS_silo
erase
generate_test_tape
hadump
hafs
hagentd
hagetconf
haprune
hascsi
hasubmit
hasys
hpflip
IBM_silo
ielem
inquire
jbconfig
jbexercise
jbverify
ldunld
lgtolic
lgtolmd
libcdi
libscsi
libsji
libstlemass
libstlibm
libstlstk
lrescan
lreset
lus_add_fp_devs
lusbinfo
lusdebug
mini_el
mm_data
mminfo
mmlocate
mmpool
mmrecov
msense
mt
ndmpjbconf
networker
nsr (1)
nsr (5)
nsr_archive_request
nsr_client
nsr_crash
nsr_data
nsr_device
nsr_directive
nsr_getdate
nsr_group
nsr_ize
nsr_jukebox
nsr_label
nsr_layout
nsr_license
nsr_migration
nsr_notification
nsr_policy
nsr_pool
nsr_regexp
nsr_resource
nsr_schedule
nsr_service
nsr_shutdown
nsr_stage
nsr_storage_node
nsr_support
nsr_usergroup
nsradmin
nsralist
nsrarchive
nsrcap
nsrcat
nsrck
nsrclone
nsrcnct
nsrd
nsrexec
nsrexecd
nsrhsmck
nsrhsmclear
nsrhsmd
nsrhsmls
nsrhsmnfs
nsrhsmrc
nsrhsmrecall
nsrib
nsriba
nsrim
nsrindexasm
nsrindexd
nsrinfo
nsrjb
nsrlic
nsrls
nsrmig
nsrmm
nsrmmd
nsrmmdbasm
nsrmmdbd
nsrmon
nsrndmp_clone
nsrndmp_recover
nsrndmp_save
nsrpmig
nsrports
nsrretrieve
nsrssc
nsrstage
nsrtrap
nsrwatch
nwadmin
nwarchive
nwbackup
nwrecover
nwretrieve
pathownerignore
pmode
preclntsave
pstclntsave
read_a_block
recover
relem
resource
save
savefs
savegrp
savepnpc
scanner
sjiielm
sjiinq
sjimm
sjirdp
sjirdtag
sjirelem
sjirjc
sjisn
sn
ssi
stk_eject
STK_silo
stli
sym2xdm
tapeexercise
tur
uasm
writebuf
* - Windows Only
* mt
* nsrlpr
* nsrperf
savepnpc
save - save files to long term storage with NetWorker savepnpc - save files to long term storage with NetWorker and performs pre and post processing commands on a NetWorker client.SYNOPSIS
command [ -BEiKLnquSVvx ] [ -s server ] [ -c client-name ] [ -N name ] [ -e expiration ] [ -f dirfile ] [ -o save_operations ] [ -b pool ] [ -F file ] [ -I input_file ] [ -g group ] [ -l level ] [ -t date ] [ -m masquerade ] [ -w browse_time ] [ -y retention_time ] [ -W width ] [ path ... ] where command is either save or savepnpc.
DESCRIPTION
save saves files, including directories or entire filesystems, to the NetWorker server (see nsr(1)). The progress of a save can be monitored using the X Window System based nwadmin(1) program or the curses(3X) based nsrwatch(1) program for other terminal types. The user of this command may retain root privileges if the command's modes are properly set as described in nsr(1). If no path arguments are specified on the command line or via the -I option, the current directory will be saved. save will save a direc- tory by saving all the files and subdirectories it contains, but it will not cross mount points, or follow symbolic links. If the paths to be saved are mounted from a network file server, save instructs the user to run the save on the remote machine or use the -L option. The directive files (see nsr(5)) encountered in each directory are read by default, and they contain special instructions directing how partic- ular files are to be saved (i.e. compressed, skipped, etc.). These files are named '.nsr' on UNIX or 'nsr.dir' on Windows. Each file in the subdirectory structures specified by the path argu- ments is encapsulated in a NetWorker save stream. This stream of data is sent to a receiving process (see nsrd(1)) on the NetWorker server, which processes the data, adding entries to the on-line index (see nsrindexd(1)) for each file in the stream, with the data finally ending up on a long term storage media (see nsrmmd(1)). By default, these on- line index entries are stored in the "backup" index namespace. Details about handling media are discussed in nsrmm(1) and nsr_device(5). savepnpc consists of the same command options as save but requires the -g group to run. Apart from running the actual save, it also performs the pre and post processing commands, if any. Prior to the actual save of the first saveset on a NetWorker client, savepnpc performs pre-pro- cessing commands if any exists in the /nsr/res/<grpname>.res file, and at the end of the save of the last save set on the client, the post- processing commands (if any) will be invoked. It is possible to setup multiple clients in a savegroup such that each client can run different pre and post commands. The <grpname>.res file resides on the nsr_getdate(3)). Also, abort precmd with group attribute exists in the /nsr/res/<grpname>.res file. This can be set to Yes or No. If set to Yes, the precmd will terminate if the particular savegrp is aborted. If it is set to No, the precmd will run to completion even after the abnormal exit of the savegrp session. An example of /nsr/res/<grpname>.res can be described as: type: savepnpc; precmd: /bin/true; pstcmd: /bin/true, "/bin/sleep 5"; timeout: "12:00pm"; abort precmd with group: No; The precmd field can be manually modified to contain any number of com- mands that are needed to be run at the beginning of the save of the 1st save set. The pstcmd is to hold any commands that are needed to be run at the end of the save of the last save set. The post-processing com- mands are run after the save of the last save set or the timeout condi- tion, whichever comes first. Note that on Windows Networker Clients, the shell should be set to "cmd.exe"and the Shell flag should be set to "/c", for running the precmd and postcmd. This will force the OS to close all the opened File Descriptors and other resources in a timely manner, after the execution of the commands. Also, for both the precmd and the pstcmd, on all Networker Clients, its best to redirect the out- put(stdout and stderr) to another file, to avoid unclosed File Descrip- tors, after the commands have completed executing. An example of precmd and pstcmd for Windows Clients is shown below: precmd: cmd.exe /c start_pre_cmd > pre_result.txt 2>&1 pstcmd: cmd.exe /c start_post_cmd > post_result.txt 2>&1
OPTIONS
-b pool Specifies a particular destination pool for the save. -c client-name Specifies the client name for starting the save session. This is useful on clients with multiple network interfaces, and mul- tiple host names. It can be used to create multiple index databases for the same physical client. This does not specify the network interface to use. This is specified in the server network interface attribute of the client resource (see nsr_client(5)). This option can also be used on a cluster when performing manual saves, or in specifying a non-default backup command for scheduled saves. This option directs NetWorker to override the cluster path-ownership rules, saving the path argu- ment(s) as belonging to client-name and making index entries in the index for client-name instead of using the name of the phys- ical host or virtual host which owns the path, according to the cluster management software. Refer to pathownerignore(5) for more information about path-ownership rules. -e expiration Set the date (in nsr_getdate(3) format) when the saved data will expire. When a save set has an explicit expiration date, the save set remains both browsable and non-recyclable until it expires Thus, the explicitly provided expiration overrides the existing browse and retention times specified in the client pol- nsr(5)). A dirfile of - causes the default directives to be read from standard input. -o save_operations Save Operations of the form KEYWORD:TOKEN=STATE. It is used to configure VSS saves on Windows 2003. Examples: "vss:*=off" Turn off VSS. "vss:Microsoft Exchange Writer=off" Disable a writer. "vss:C:=off" Disable VSS for a drive. Please see the Admin Guide for more details. -g group This option is used by savegrp(1) and savefs(1) to denote the group of the save (see nsr_client(5) and nsr_group(5)) and is used by the NetWorker server to select the specific media pool. -i Ignores any .nsr (UNIX) or nsr.dir (Windows) directive files as they are encountered in the subdirectory structures being saved. -l level The level of the save. This option is used by savegrp(1) and savefs(1) to specify a particular level for a scheduled save. This option is ignored by manual save command. -m masquerade Specifies the tag to precede the summary line. This option is used by savegrp(1) and savefs(1) to aid in savegrp summary noti- fications. savepnpc(1) also uses this tag to identify client operations on the savegrp's work list that should complete before pstclntsave(1) will trigger its post-processing. -n No save. Estimate the amount of data which will be generated by the save, but do not perform the actual save. -q Quiet. Displays only summary information and error messages. -s server Specifies which machine to use as the NetWorker server. -t date The date (in nsr_getdate(3) format) by which files must have been modified for them to be saved. This option is used by savegrp(1) and savefs(1) to perform scheduled saves by consult- ing with the media database to determine the appropriate time value based on the previous saves for the save set and the level of the scheduled save. -u Stop the save if an error occurs. The save program normally treats errors as warnings and continues to save the rest of the files in the backup. When this option is set, errors will cause save to exit and abort the save. This option is not recommended for general use, although it can be useful when a group of files needs to be backed up as a set. mines this date for the save set based on the retention policies in effect. This option allows overriding the existing policies on a save by save basis. -w browse_time Sets the date (in nsr_getdate(3) format) after which this save set will no longer be browsable. By default, the server deter- mines the browse date for the save set based on the browse poli- cies in effect. This option allows overriding the existing policies on a save by save basis. -x Cross mount points. This option is only applicable to manual save command. When -x option is specified with a (save set) path, the mount point under this path is crossed and files in the mounted file system are backed up. When -x option is not specified, only the local files and directories of the path are backed up. This option has no effect and is ignored when a mount point (or file/subdirectory path under it) is specified as the (local) path to be backed up for the manual save command, which gener- ally requires the -L option. For example, if /tmp_mnt/pumbaa is a mount point for pum- baa:/space, the following three commands behave differently with the specification of -x option: save -x /tmp_mnt follows mount points, backs up the local files and directories of /tmp_mnt along with files and directories of /tmp_mnt/pumbaa save /tmp_mnt does not cross mount points, only local files and directories of /tmp_mnt are backed up save [-x] /tmp_mnt/pumbaa[/...] when mount point is specified as the (save set) path, "-x" option is ignored and an error message is displayed to indicate "-L" option is required on most platforms -B Force save of all connecting directory information from root ('/') down to the point of invocation. -E Estimate the amount of data which will be generated by the save, then perform the actual save. Note that the estimate is gener- ated from the inode information; thus, the data is only read once. -F file Only save files whose change time is newer than the file modifi- cation date of file. -I input_file even when files are from a network file server. To recover these files, run recover(1) with the -c client arguments, where client is the name of the NetWorker client that did the save. -LL In addition to treating the backup as a local backup, causes an extra line to be printed at the end of the completion output of the form 'complete savetime=number', where number is the save- time of the save set created by this backup. This option is meant to be used by the savegrp(1) command in performing auto- matic cloning. -N name The symbolic name of this save set. By default, the most common prefix of the path arguments is used as the save set name. If the -N option is used when saving any of the SYSTEM save sets (SYSTEM STATE, SYSTEM FILES, and SYSTEM DB), the path must also be specified and must match the name value assigned with the -N option. -S Allows only save set recovery. This performs the save without creating any index entries. This means that the save set will not be browsable, although save set recovery may be used to recover the data. -V Prevent the OFC mechanism from creating a point-in-time copy of the source volume. (Included for compatibility with NT Net- Worker servers.) -W width The width used when formatting the summary information output. Valid values for width are integer values from 1 to 10000. If the supplied width is too small for the summary to fit in, the width will be silently adjusted upwards as necessary. If the supplied width is larger than the minimum needed, then spaces will be used to pad the summary to the correct width. Note that if no -W argument is supplied then there is no fixed width used, and the summary simply expands to whatever minimum width is nec- essary.
SEE ALSO
curses(3X), nsr_getdate(3), nwadmin(1), nsr(5), nsr(1), nsr_client(5), nsr_device(5), nsr_group(5), nsr_service(5), nsrd(1), nsrim(1), nsrindexd(1), nsrmm(1), nsrmmd(1), nsrwatch(1), recover(1), savefs(1), savegrp(1), pathownerignore(5).
DIAGNOSTICS
Exit Codes 0 Normal exit. This means that a save set was correctly created on the server. Messages about individual file backup failures are warnings, and do not cause abnormal exit. <>0 Abnormal exit. A save set was not correctly created on the server. Messages host: saveset level=level, size time count files. This message (with the appropriate client host name, saveset name, level, total save set size, elapsed time, and file count) is printed whenever save is run by savegrp(1) and exits nor-
ADVERTISEMENT
Legato NetWorker 7.xMan(1) output converted with man2html, sed, awk