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
recover
recover - browse and recover NetWorker filesSYNOPSIS
recover [-f] [-n] [-q] [-u] [-i {nNyYrR}] [-d destination] [-c client] [-x index-namespace] [-t date] [ -s server] [ dir] recover [-f] [-n] [-u] [-q] [-i {nNyYrR}] [-I input file] [-d destina- tion] [-c client] [-x index-namespace] [-t date] [ -s server] -a path... recover [-f] [-n] [-u] [-q] [-i {nNyYrR}] [-d destination] -s server -S ssid[/cloneid] [-S ssid[/cloneid]]... [ path]... recover [-f] [-q] -i {NYR} -R recover-target [-c client] [-d destina- tion] [-x index-namespace] [-t date] [ -s server] [ dir ] recover [-f] [-n] [-q] [-i {nNyYrR}] [-t date] [-s server] [-N system save set]
DESCRIPTION
recover browses the saved file index and recovers selected files from the NetWorker system. The file index is created in the backup index namespace when files are saved with save(1). If files are saved into an index-storing archive pool using nsrarchive(1), the file index is created in the archive index namespace. When in interactive mode (the default), the user is presented with a view of the index similar to a UNIX filesystem, and may move through the index to select and recover files or entire directories. In automatic mode (-a option), the files specified on the command line are recovered immediately without brows- ing. While in save set recover mode (-S option), the save set(s) spec- ified are retrieved directly without browsing the NetWorker file index. Use of save set recover mode is restricted to root. When using recover without the -S option, users who are root may recover any file. The remaining permission checking rules described in the paragraph apply to users who are not root. For files that don't have an Access Control List (ACL), the normal Unix mode bits must allow you to read the file in order to recover it. Files with an ACL can only be recovered by their owner or by root.
OPTIONS
-a Specifies automatic file recovery with no interactive browsing. Path specifies one or more files or directories to be recovered. Symbolic links are not followed, though the link file itself will be recovered. Mount points are also not followed unless the most recent save(1) was performed with the '-x' option. -S ssid[/cloneid] Specifies save set recover mode and can only be used by root. This mode can be used to implement fast batch file recovery without requiring the NetWorker file index entries. ssid speci- fies the save set id's for the save set(s) to be recovered. When there are multiple clone instances for a save set, the cloneid can also be specified to select the particular clone instance to be recovered from. When no path arguments are spec- ified, the entire save set contents will be recovered. One more or more path's can be specified to limit which directories and files are actually recovered. If path's are supplied, then the -d destination Specifies the destination directory to relocate recovered files. Using this option is equivalent to using the relocate command when in interactive mode (see usage). Relative paths are inter- preted relative to the current working directory. -s server Selects which NetWorker server to use. -c client Client is the name of the machine that saved the files. When browsing a directory that was saved by another client, the path- names will reflect the file tree of the client that saved the files. By default save and recover determine the client name from the filesystem table. This option might be necessary if the -L option was used on the save command. This option cannot be used in conjunction with the -S ssid option (save set recover mode). -x index-namespace Browse/recover files in the specified file index namespace. By default the backup namespace is used. The other recognized index namespace is: archive. This field is case sensitive. -t date Display/recover files as of the specified date (in nsr_getdate(3) format). Using this option is equivalent to using the changetime command with the given date when in interactive mode (see usage). This option cannot be used in conjunction with the -S ssid option (save set recover mode). -q Turns off the verbose output. The recover command normally runs with verbose output. -f Forces recovered files to overwrite any existing files whenever a name conflict occurs. This is the same as specifying -iY. -n Does not write or create any files or directories when recover- ing. -i {nNyYrR} Specifies the initial default overwrite response to use when recovering existing files. Only one letter may be specified. This option is the same as the uasm -i option when running in recover mode. See the uasm(1) man page for a detailed explana- tion of this option. For directed recovers (see the -R option), only 'N', 'Y', and 'R' are valid values. -I input file Takes the paths to recover from the command line, and read paths to recover from the named file. The paths must be listed one per line. If no paths are specified on the command line, then only those paths specified in the file will be recovered. To be used in conjunction with -a option. -R recover-target Specifies the name of the remote machine to direct the recovery. This is used in conjunction with the -c option to specify brows- -N system save set Used to recover the following system save sets: SYSTEM DB, SYS- TEM FILES, or SYSTEM STATE. (Windows Only) -u Stops when an error occurs during recovery. Normally, recover treats errors as warnings and tries to continue to recover the rest of the files requested. However, when this option is used, recover will stop recovering on the first error it encounters. This option is not valid for directed recovers.
USAGE
When using recover in the interactive mode, an image of the filesystem at a particular time is presented. Using commands similar to the shell, you can change the view and traverse the filesystem. Files may be selected for recovering, and the actual recover command issued. The following commands manipulate the view of the filesystem and build the list of files to recover. In all of the commands that take a name argument pattern matching characters can be used. The pattern matching characters and regular expression format are the same as for the UNIX shell sh(1). ls [ options ] [ name ... ] List information about the given files and directories. When no name arguments are given, ls lists the contents of the current directory. When a name is given and name is a directory, its contents are displayed. If name is a file, then just that file is displayed. The current directory is represented by a '.' (period). The options to this command correspond to those of the UNIX command, ls(1). An additional recover specific -S option can be used to select the save time instead of the last modified time for sorting (with the -t option) and/or printing (with the -l option). Files that have been added to the recover list are preceded by a '+'. Files that have an ACL have a trailing '+' (e.g. -rw-r--r--+) after the mode bits when view- ing file details. lf [ name ... ] is the same as ls -F. Directories are marked with a trailing '/', symbolic links with a trailing '@', sockets with a trailing '=', FIFO special files with a trailing '|', and executable files with a trailing '*'. ll [ name ... ] is the same as ls -lgsF. Generates a long format listing of files and directories. This command can be used to find the value of a symbolic link. cd [ directory ] Change the current working directory to [ directory ]. The default directory is the directory recover was executed in. If directory is a simple symbolic link, cd will follow the symbolic link. However, if directory is a path containing symbolic links anywhere but at the end of the path, the cd command will fail; you should cd a component of the path at a time instead. pwd Print the full pathname of the current working directory. debug [ level ] Turn on or turn off debugging. Level must be a number. If level is 0, debugging is off. As the debug level goes higher, the recover command prints out more messages. By default, debugging is off. delete [ name ... ] Delete the current directory, or the named file(s) or direc- tory(s) from the recover list. If a directory is specified, that directory and all its descendents are deleted from the list. The most expedient way to recover a majority of files from a directory is to add the directory to the recover list, and then delete the unwanted files. dir [ w ] [ filename... ] This command is similar to the "ll" command with the following differences. The dir command uses the display format used by "dir" command in DOS command prompt. Also this command does not add a + to the files selected for recovery. With w option, the names of the files or directories only are displayed. list [ -l ] | [ -c ] Display the files on the recover list. With no arguments the recover list is displayed as a list of full path names, one per line, followed but a total count of the files to be recovered. The -c argument prints just the total count of files to be recovered. The -l argument prints the files in the same format as the ll command with the -dS options. volumes Prints a list of the volumes needed to recover the current set of files on the recover list. recover Recover all of the files on the recover list from the NetWorker server. Upon completion the recover list is empty. verbose Toggle the status of the 'verbose' option. When verbose mode is on, recover displays information about each file as it is recovered. When verbose mode is off, recover only prints infor- mation when a problem occurs. The default is verbose mode on. force If name conflicts exist, overwrite any existing files with recovered files. noforce Cancel the force option. When in 'noforce' mode, a prompt is issued each time a naming conflict arises between a file being recovered and an existing file. At each prompt, six choices are presented: 'y', 'Y', 'n', 'N', 'r' and 'R'. To overwrite the existing file, select 'y'. To rename the file to an automati- cally generated alternative name, select 'r'. Selecting 'n' causes the recovered file to be discarded. The capital letters invoke the same action for all subsequent conflicts without fur- ther prompting. Hence, selecting 'Y' will cause all existing conflicting files to be overwritten, 'N' will cause all con- flicting recovered files to be discarded, and 'R' will automati- to the current working directory within the recover program. The recovered files will be placed into this directory, which will be created if necessary. When files from multiple directo- ries are being recovered, they will be placed below this direc- tory with a path relative to the first common parent of all the files to be recovered. For example, if /usr/include/sys/errno.h and /usr/include/stdio.h are being recovered, and the relocation directory is set to /tmp, then the first common parent of these two files is include, so the recovered files will be named /tmp/sys/errno.h, and /tmp/stdio.h. destination Print destination location for recovered file. exit Immediately exit from recover. help Display a summary of the available commands. ? Same as help. quit Immediately exit from recover. Files on the recover list are not recovered. changetime [ time ] Display the filesystem as it existed at a different time. If no time is specified the 'current' time is displayed, and a prompt is issued for a 'new' time. The new time is given in nsr_getdate(3) format. This format is very flexible. It accepts abso- lute dates, such as March 17, 1997, and relative dates, such as last Tuesday. Absolute dates can be given in two formats: MM/DD[/YY], and Month DD[, YYYY]. Times can also be specified as either absolute or relative, with absolute times in the for- mat: HH[[:MM][:SS]] [am|pm] [time zone]. For example, 12:30 am, 14:21, and 10 pm PST. The current time is used to calculate unspecified parts of a relative date (e.g. 2 days ago means 2 days ago at the current time), and the end of the day is assumed for unspecified times on an absolute date (e.g. July 2 means July 2 at 11:59:59 PM). By default, the present is used as the current time. The resolution of the filesystem image at a time in the past depends on how often save was run and how far back the NetWorker file index information goes. versions [ name ] All instances of the current directory, if name is not speci- fied, or the named file or directory, found in the NetWorker file index are listed. For each instance, three lines of data are displayed. The first line is similar to the ll output. The second line lists the instance's save time. The third line specifies which tape(s) this instance may be recovered from. With appropriate use of the changetime command, any one of the entries may be added to the recover list. As with ls, lf, and ll, files that have been added to the recover list are preceded by a '+'.
SEE ALSO
ls(1), nsr_getdate(3), nsr_service(5), nsr(1), nsrd(1), nsrindexd(1), nwrecover(1), save(1) Recover automatically re-submits its recover request to the server, if any files remain to be recovered. Path name is within machine:export-point An informative message that lets you know that the given path name is mounted from a network file server and that the recovery will use the index for the named file server. If the machine is not a NetWorker client, then the -c option may be necessary. Browsing machine's on-line file index An informative message that explicitly states which NetWorker client's index is being browsed for interactive recovers that resolve to another machine. Using server as server for client An informative message that lets you know which NetWorker server was selected for client's index. Cannot open recover session with server This message indicates that some problem was encountered con- necting to the NetWorker server on the named machine. error, name is not on client list This message indicates that the client invoking the recover com- mand is not in the server's client list. See nsr_service(5) for details. path: Permission denied The file name cannot be recovered because you are not root, and you don't have read permission for the file. path: Permission denied (has acl) The file name cannot be recovered because you are not root, the file has an ACL (Access Control List), and you are not the owner of the file.
ADVERTISEMENT
Legato NetWorker 7.xMan(1) output converted with man2html, sed, awk