NWRECOVER(8)NWRECOVER(8)NAMEnwrecover - NetWorker graphical recover interface
SYNOPSISnwrecover [ -s server ] [ -c client ] [ -x index namespace ] [ -T
browse time ] [ -p pass phrase ] [ <X-args> ] [ path ]
DESCRIPTIONnwrecover is an X Window System application. It is used to recover
lost files that have been saved with NetWorker. If you are running in
a non-X11 environment, recover(8) can be used to recover files.
The server's name can be specified with the -s server argument. When
no server is specified, nwrecover uses the server selection rules found
in nsr(8). When multiple NetWorker servers are accessible, they can be
selected from within the nwrecover command. If path is specified,
nwrecover will attempt to initialize the current selection to the given
path. The default attempted selection if path is not specified is the
current working directory.
If you are recovering files that were saved with Access Control Lists
(ACLs), you need to be root or the file owner to recover the file.
Files with an ACL have a trailing '+' (e.g., -rw-r--r--+) after the
mode bits when viewing file details. See recover(8) for more informa‐
tion about ACLs.
There are three basic steps to recover a lost file: (1) Browse Net‐
Worker's index in the Recover window to find the lost file, (2) Mark
the file for recovery by selecting its checkbox and (3) Start the
recovery. In addition, there are recover commands for relocating
recovered files (Relocate), finding past versions of a file (Versions),
changing the browse time (Change Browse Time), showing the files you
have marked for recovery (Show Marked), and overwriting or renaming
recovered files that are in conflict with existing files (Conflict Res‐
Opening the Recover window connects the client to its file indexes
maintained on the server. The entries in the index represent previously
saved files and are organized exactly like the filesystem. The file
index is created in the backup index namespace when files are saved
with save(8). If files are saved into an index-storing archive pool
using nsrarchive(8), the file index is created in the archive index
namespace. nwrecover offers command for changing the index namespace
being browsed (Change Index Namespace). To browse the index for
another filesystem, enter the pathname in the Selection field.
To browse the index: The tree view of entries shown in the Recover win‐
dow allows you to browse through your files and directories. You may
use the mouse to open a directory and display its contents.
To mark files: After you have located your files by browsing the index,
mark the files you want to recover by selecting their checkboxes. Or,
highlight a file and use the Mark command from the File menu to mark
files. You can list the files that you have marked for recovery with
the Show Marked command from the View menu.
To start the recovery: Select the Start recover command from the File
menu. The Conflict Resolution dialog box appears, where you indicate to
NetWorker what to do when a conflict occurs between a recovered file
and an existing file. You select whether to be prompted for each indi‐
vidual conflict or to select one global resolution for all conflicts.
Then you indicate to NetWorker whether to Rename the recover file with
a .R extension to preserve both files, to Discard the recover file and
preserve the existing file, or to Overwrite the existing file to pre‐
serve the recover file as the only copy of the file.
After you press OK in the Conflict Resolution dialog box, the recover
continues, and NetWorker automatically determines the media needed to
complete the recovery, prompts the operator to mount the media, and
executes the recovery. You can monitor the status of the recovery in
the Recover Status window.
Before starting the recovery, you have the option of relocating the
recover files with the Relocate command. Enter the pathname of a new or
existing directory in which to place your recovered files.
The Recover window also offers two commands for browsing the index in
the past. Versions shows you the entire backup history for a file.
Change Browse Time allows you to change the time at which you are view‐
ing the on-line index.
A complete explanation of the nwrecover command can be found in the
NetWorker Administrator's Guide.
Set the current NetWorker server to server.
Set the current NetWorker client index to browse to client.
-x index namespace
Set the current file index namespace to index namespace. By
default the backup namespace is used. The other recognized index
namespace is: archive. This field is case sensitive.
-T browse time
Set the current index browse time to browse time (in nsr_get‐
date(3) format). Using this option is equivalent to using the
change browse time dialog within nwrecover.
-p pass phrase
Specifies an additional pass phrase to use when attempting to
recover files backed up using the aes directive. By default the
current datazone encryption key is tried as well as the key gen‐
erated from the default pass phrase. Using this option causes
recover to generate an encryption key from the pass phrase and
try it if the default and datazone pass phrase keys do not work.
This option can be specifie multiple times.
Since it is an X-Windows application, nwrecover may also be
invoked with various arguments that are not specific to nwre‐
cover, but are generic X-Windows arguments. For instance, you
may use the -d option in order to specify which display the
nwrecover application should use. See "man X" or your system's
X-Windows documentation for more details.
The X11 resources for nwrecover.
SEE ALSOnsr_getdate(3), nsr(8), nsradmin(8), nwbackup(8), recover(8)
The NetWorker Administrator's Guide
NetWorker 7.3.2 Aug 23, 06 NWRECOVER(8)