RECOVER(8) Legato NetWorker 3.0 RECOVER(8)
NAME
recover - browse and recover NetWorker files
SYNOPSIS
recover [-s server] [-f] [-c client] [-d destination] [-q] [-t date]
[ dir]
recover [-s server] [-f] [-c client] [-d destination] [-q] [-t date]
-a path...
DESCRIPTION
Recover browses the saved file index and recovers selected files from
the NetWorker system. The file index is created when files are saved
with save(8). When in interactive mode, 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, the files specified on the command line are recovered
immediately and no browsing takes place.
OPTIONS
-a This option is used when no interactive browsing is required.
The command line arguments specify the files or directories to
be recovered.
-d destination
Specifies the destination directory to relocate recovered
files to. Using this option is equivalent to using the relo
cate command when in interactive mode (discussed below).
-s server
Selects which NetWorker server to use. The default is the
server of the first directory being recovered, if it is a net
work file server and NetWorker server. Otherwise, the current
machine if it is running a server, or the machine with the
logical name ``nsrhost'' in the host table (see hosts(5)).
-c client
Client is the name of the machine that saved the files. Note
that when browsing a directory that was saved by another
client, the pathnames will reflect the file tree of the client
that saved the files. Normally save and recover determine the
client name from the filesystem table, but this option might
be necessary if the -L option was used on the save command.
-t date
Display/recover files as of the specified date (in getdate(3)
format). Using this option is equivalent to using the change
time command with the given date when in interactive mode
(discussed below).
-q The recover command normally runs with verbose output. This
flag turns off the verbose output.
-f Indicates that recovered files will overwrite existing files
whenever a name conflict occurs.
Licensed material--property of copyright holder(s) 1
RECOVER(8) Legato NetWorker 3.0 RECOVER(8)
USAGE
When using recover in the interactive mode, an image of the filesys
tem at a particular time is presented. Using commands similar to the
shell, one 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 cur
rent 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 spe
cific -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 `+'.
lf [ name ... ]
is the same as ls -F. Directories are marked with a trailing
`/', symbolic links 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.
add [ name ... ]
Add the current directory, or the named file or directory to
the recover list. If a directory is specified, it and all of
its descendent files are added to the recover list.
delete [ name ... ]
Delete the current directory, or the named file or directory
Licensed material--property of copyright holder(s) 2
RECOVER(8) Legato NetWorker 3.0 RECOVER(8)
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.
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 recov
ered. 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.
volumes
Prints a list of the volumes need to recover the current set
of files on the recover list.
recover
Recover all of the files on the recover list from the Net
Worker 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
information 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 auto
matically 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 further prompting. Hence, selecting `Y' will cause
all existing conflicting files to be overwritten, `N' will
cause all conflicting recovered files to be discarded, and `R'
will automatically rename all conflicting recovered files.
relocate [ directory ]
Change the target recover location to directory. The recov
ered files will be placed into this directory, which will be
created if necessary. When files from multiple directories
are being recovered, they will be placed below this directory
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
Licensed material--property of copyright holder(s) 3
RECOVER(8) Legato NetWorker 3.0 RECOVER(8)
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 the target directory's path.
help Display a summary of the available commands.
? Same as help.
quit Exit from recover. Files on the recover list are not recov
ered.
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
getdate(3) format. This format is very flexible. It accepts
absolute dates, such as July 19, 1991, and relative dates,
such as last Tuesday. Absolute dates can be given in two for
mats: MM/DD[/YY], and Month DD[, YYYY]. Times can also be
specified as either absolute or relative, with absolute times
in the format: HH[[:MM][:SS]] [am|pm] [time zone]. For exam
ple, 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 midnight is
assumed for unspecified times on an absolute date (e.g. July 2
means July 2 at midnight). 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, 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), getdate(3), hosts(5), nsrservice(5), nsr(8), nsrd(8),
nsrindexd(8), save(8)
DIAGNOSTICS
Recover complains about bad option characters by printing a ``usage''
message describing the available options.
Licensed material--property of copyright holder(s) 4
RECOVER(8) Legato NetWorker 3.0 RECOVER(8)
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 recov
ery will use the index for the named file server. If the
machine is not a NetWorker client, then the -c option may be
necessary.
Using server as server for client
An informative message that lets you know which NetWorker
server is accessed and which client's index will be used.
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
command is not in the server's client list. See
nsrservice(5) for details.
Licensed material--property of copyright holder(s) 5