Command Line Documentation

NAME

recover - browse and recover NetWorker files

SYNOPSIS

recover [OPTIONS] [-d destination] [-c client] [ -s server] [ dir]

recover [OPTIONS] [-d dest] [-c client] [-t date] [ -s server] -a path

DESCRIPTION

Recover browses the saved file index and recovers selected files from the NetWorker backup server. The file index is created when files are saved with save(1m). 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 and no browsing takes place. While in save set recover mode (-S option), the save set(s) specified 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. General users may only recover rules described in the paragraph apply to users who are not their own files or files with access permission o:r. Files with an ACL can only be recovered by their owner.

The recover program provides an interactive interface that allows you to browse files and control recovers. When you enter the recover command, the recover> prompt appears.

NOTE: filename can be either a file or a directory

Command	Description
add filename	add filename to the recover list
cd dir	change to the dir that contains the file to be recovered
changetime	change the browse time of online index
delete filename	delete filename from the recover list
dest	verify destination directory for recovered files
force	overwrite existing files
help or '?'	display list of recover program commands
list	list the files in the recover list
ls -f filename	list filename with file type information
ls -l filename	list filename using long format
ls	list filename
noforce	do not overwrite existing files
nsrwatch	monitor NetWorker server activity
pwd	display name of current directory
quit	exit the recover program
recover	start the recover program when entered at the system prompt: start the recovery when entered at the recover> prompt
relocate dir	specify new directory location for recovered files
verbose	toggle verbose or quite mode for recover status messages
versions filename	display backup history of filename (filename can be tither a file or a directory
volumes filename	list volumes needed to recover marked files ( filename can be either a file or a directory)

If the recover operation detects a file by the same name in the target directory, it will prompt you with the following question:

file exists, overwrite (n, y, N, Y) or rename (r, R) [n]?

The following responses are valid:

• y - overwrite the file, continue to prompt if more duplicates are found
• Y - overwrite the file, do NOT continue to prompt
• n - do NOT overwrite, continue to prompt
• N - do NOT overwrite the file, do NOT continue to prompt
• r - rename recovered file, continue to prompt
• R - rename recovered file, do NOT continue to prompt

For more detailed information on the recover command and its options, please refer to the Unix man page or the NT Networker User's Guide (PDF format) which is found on the NT client CD guide.

Summary of the Recover Operation

These are the general steps to recover a file.

recover -i -s beacon.cc.vt.edu

1. cd directory name
2. versions filename
3. changetime date
4. add directory name
5. list
6. recover
7. quit

See man page for detailed info on the recover command.

EXAMPLE 1 - Recovering a Single File and a Directory

The following example shows how to recover a single file from the backup server. The user wants to recover the latest backup of the file named syslog.conf from his home directory. He wants to restore the file to the same directory. He also wants to recover the sub-directory and its contents to its original location.

% /usr/bin/nsr/recover
		recover: Using beacon.cc.vt.edu as server for client.vt.edu
		recover: Current working directory is /home/marchany/
		recover>ls
		 backup.install.script1   patches                  syslog.conf
		 kernel.drv.le            sendmail.pkg             tapes.manpage
		 license.info             sendmail.tar             test
		recover>add test
		/home/marchany/test
		2 file(s) marked for recovery
		recover> add syslog.conf
		3 file(s) marked for recovery
		recover>recover
		Recovering 3 files into their original locations
		Total estimated disk space needed for recover is 23 KB.
		Volumes needed (all on-line):
		        22222302 at jukebox
		Requesting 3 file(s), this may take a while...
		./syslog.conf
		./test/dodo
		./test/
		Received 3 file(s) from NSR server `beacon.cc.vt.edu'
		Recover completion time: Tue Jun 30 10:49:20 1998
		recover>quit