Content-type: text/html Man page of NSRRETRIEVE


Section: Maintenance Commands (8)
Updated: Dec 11, 01m
Index Return to Main Contents


nsrretrieve - retrieve NetWorker archive save sets  


nsrretrieve [ -fnqu ] [ -i {nNyYrR} ] [ -d destination ]
[ -s server ] { [ -S ssid[/cloneid] ]...
[ -A annotation ]... } [ path ... ]


is used to restore archive save sets from a NetWorker server. No browsing is available via nsrretrieve. Use of nsrretrieve is restricted to listed administrators and users of an archive client resource. See the nsr_client(5) man page for further details. When not running as root, only the files that the user owns can be retrieved.

When no path arguments are specified, the entire save set contents will be retrieved. To restrict the archive save set retrieval to only particular directories or files matching a given path prefix, exact matching path's can be specified to limit which directories and files are retrieved.  


-A annotation
The annotation is a regular expression which uniquely identifies a single archive save set. See nsrarchive(1m). The regular expression is as used by grep(1). At least one annotation or ssid (see below) must be specified.
-S ssid[/cloneid]
The ssid specifies the save set IDs for the save sets to be retrieved. When there are multiple clone instances for an archive save set, you can specify the cloneid to select the particular clone instance to be retrieved. At least one annotation (see above) or ssid must be specified.
-d destination
Specifies the destination directory to relocate retrieved files.
-s server
Selects which NetWorker server to use.
The nsrretrieve command normally runs with verbose output. This flag turns off the verbose output.
Indicates that retrieved files will overwrite existing files whenever a name conflict occurs.
Does not actually create any directories or files while retrieving.
-i {nNyYrR}
Specifies the initial default overwrite response to use when retrieving files and the file already exists. You may specify only one letter. This option is the same as the uasm -i option when running in recover mode. See the uasm(1m) man page for a detailed explanation of this option.
Stop when an error occurs during retrieval. Normally, nsrretrieve treats errors as warnings and tries to continue to retrieve the rest of the files requested. However, when this option is used, nsrretrieve will stop recovering on the first error it encounters.


grep(1), nsrarchive(1m), nsr_client(5), nsr_service(5), nsr(1m), nsrd(1m), uasm(1m).  



Exit Codes

Normal exit. This means that all of the requested data was successfully retrieved.
Abnormal exit.


The nsrretrieve command reports invalid options by printing a ``usage'' message describing the available options.

Cannot contact media database on server
This message indicates that some problem was encountered connecting to the NetWorker server on the named machine.
cannot retrieve backup save sets
The nsrretrieve command can only be used to restore archive save set data.
cannot retrieve migration save sets
The nsrretrieve command can only be used to restore archive save set data.
more than one saveset have the annotation
The specified annotation matched more than one archive save set. Use nwretrieve(1m) for retrieving save set that has non-unique annotation key.
cannot find saveset with unique annotation
The specified annotation matched no archive save set.



Exit Codes

This document was created by man2html, using the manual pages.
Time: 02:36:50 GMT, October 02, 2010