--- /dev/null
+
+ amrecover
+Prev Chapter 35. The AMANDA Manual Pages. Next
+
+-------------------------------------------------------------------------------
+
+Name
+
+amrecover \14 AMANDA index database browser
+
+Synopsis
+
+amrecover [[-C ] config ] [ -s index-server ] [ -t tape-server ] [ -d tape-
+device ]
+
+DESCRIPTION
+
+Amrecover browses the database of AMANDA index files to determine which tapes
+contain files to recover. Furthermore, it is able to recover files.
+In order to restore files in place, you must invoke amrecover from the root of
+the backed up filesystem, or use lcd to move into that directory, otherwise a
+directory tree that resembles the backed up filesystem will be created in the
+current directory. See the examples below for details.
+See the amanda(8) man page for more details about AMANDA.
+
+OPTIONS
+
+
+Note
+
+The listed defaults map to the values you ran the configure-script with.
+
+
+ [ -C ] config
+ AMANDA configuration (default: daily).
+
+ -s index-server
+ Host that runs the index daemon (default: oops).
+
+ -t tape-server
+ Host that runs the tape server daemon (default: 192.168.0.10).
+
+ -d tape-device
+ Tape device to use on the tape server host (default: /dev/nst0).
+
+
+COMMANDS
+
+Amrecover connects to the index server and then presents a command line prompt.
+Usage is similar to an ftp client. The GNU readline library is used to provide
+command line history and editing if it was built in to amrecover.
+The purpose of browsing the database is to build up a restore list of files to
+be extracted from the backup system. The following commands are available:
+
+
+ sethost hostname
+ Specifies which host to look at backup files for (default: the local
+ host).
+
+ setdate YYYY-MM-DD
+ Set the date (default: today). File listing commands only return
+ information on backup images for this day, for the day before with the
+ next lower dump level, and so on, until the most recent level 0 backup on
+ or before the specified date is encountered.
+ For example, if:
+
+ 1996-07-01 was a level 0 backup
+ 1996-07-02 through 1996-07-05 were level 1 backups
+ 1996-07-06 through 1997-07-08 were level 2 backups
+ then if 1997-07-08 is the requested date, files from the following days
+ would be used:
+
+ 1997-07-08 (the latest level 2 backup)
+ 1997-07-05 (the latest level 1 backup)
+ 1997-07-01 (the latest level 0 backup)
+ Only the most recent version of a file will be presented.
+ The following abbreviated date specifications are accepted:
+
+
+ --MM-DD
+ dates in the current year
+
+ ---DD
+ dates in the current month of the current year
+
+
+
+
+ setdisk diskname mountpoint
+ Specifies which disk to consider (default: the disk holding the working
+ directory where amrecover is started). It can only be set after the host
+ is set with sethost. Diskname is the device name specified in the
+ amanda.conf or disklist configuration file. The disk must be local to the
+ host. If mountpoint is not specified, all pathnames will be relative to
+ the (unknown) mount point instead of full pathnames.
+
+ listdisk [diskdevice]
+ List all diskname
+
+ settape [[server]:][tapedev|default]
+ Specifies the host to use as the tape server, and which of its tape
+ devices to use. If the server is omitted, but the colon is not, the
+ server name reverts to 192.168.0.10, the configure-time default. If the
+ tape device is omitted, it remains unchanged. To use the default tape
+ device selected by the tape server, the word default must be specified.
+ If no argument is specified, or the argument is an empty string, no
+ changes occur, and the current settings are displayed.
+ If you want amrecover to use your changer, the tapedev must be equal to
+ the amrecover_changer setting on the server.
+ If you need to change the protocol (tape:, rait:, file:, null:) then you
+ must specify the hostname.
+
+ settape 192.168.0.10:file:/file1
+
+ You can change the tape device when amrecover ask you to load the tape:
+
+ Load tape DMP014 now
+ Continue? [Y/n/t]: t
+ Tape device: server2:/dev/nst2
+ Continue? [Y/n/t]: Y
+ Using tape /dev/nst2 from server server2.
+
+
+
+
+ setmode mode
+ Set the extraction mode for Samba shares. If mode is smb, shares are sent
+ to the Samba server to be restored back onto the PC. If mode is tar, they
+ are extracted on the local machine the same way tar volumes are
+ extracted.
+
+ mode
+ Displays the extracting mode for Samba shares.
+
+ history
+ Show the backup history of the current host and disk. Dates, levels,
+ tapes and file position on tape of each backup are displayed.
+
+ pwd
+ Display the name of the current backup working directory.
+
+ cd dir
+ Change the backup working directory to dir. If the mount point was
+ specified with setdisk, this can be a full pathname or it can be relative
+ to the current backup working directory. If the mount point was not
+ specified, paths are relative to the mount point if they start with "/",
+ otherwise they are relative to the current backup working directory. The
+ dir can be a shell style wildcards.
+
+ cdx dir
+ Like the cd command but allow regular expression.
+
+ lpwd
+ Display the amrecover working directory. Files will be restored under
+ this directory, relative to the backed up filesystem.
+
+ lcd path
+ Change the amrecover working directory to path.
+
+ ls
+ List the contents of the current backup working directory. See the
+ description of the setdate command for how the view of the directory is
+ built up. The backup date is shown for each file.
+
+ add item1 item2 ...
+ Add the specified files or directories to the restore list. Each item may
+ have shell style wildcards.
+
+ addx item1 item2 ...
+ Add the specified files or directories to the restore list. Each item may
+ be a regular expression.
+
+ delete item1 item2 ...
+ Delete the specified files or directories from the restore list. Each
+ item may have shell style wildcards.
+
+ deletex item1 item2 ...
+ Delete the specified files or directories from the restore list. Each
+ item may be a regular expression.
+
+ list file
+ Display the contents of the restore list. If a file name is specified,
+ the restore list is written to that file. This can be used to manually
+ extract the files from the AMANDA tapes with amrestore.
+
+ clear
+ Clear the restore list.
+
+ quit
+ Close the connection to the index server and exit.
+
+ exit
+ Close the connection to the index server and exit.
+
+ extract
+ Start the extract sequence (see the examples below). Make sure the local
+ working directory is the root of the backed up filesystem, or another
+ directory that will behave like that. Use lpwd to display the local
+ working directory, and lcd to change it.
+
+ help
+ Display a brief list of these commands.
+
+
+EXAMPLES
+
+The following shows the recovery of an old syslog file.
+
+ # cd /var/log
+ # ls -l syslog.7
+ syslog.7: No such file or directory
+ # amrecover
+ AMRECOVER Version 2.4.2. Contacting server on oops ...
+ 220 oops AMANDA index server (2.4.2) ready.
+ Setting restore date to today (1997-12-09)
+ 200 Working date set to 1997-12-09.
+ 200 Config set to daily.
+ 200 Dump host set to this-host.some.org.
+ $CWD '/var/log' is on disk '/var' mounted at '/var'.
+ 200 Disk set to /var.
+ /var/log
+ WARNING: not on root of selected filesystem, check man-page!
+ amrecover> ls
+ 1997-12-09 daemon.log
+ 1997-12-09 syslog
+ 1997-12-08 authlog
+ 1997-12-08 sysidconfig.log
+ 1997-12-08 syslog.0
+ 1997-12-08 syslog.1
+ 1997-12-08 syslog.2
+ 1997-12-08 syslog.3
+ 1997-12-08 syslog.4
+ 1997-12-08 syslog.5
+ 1997-12-08 syslog.6
+ 1997-12-08 syslog.7
+ amrecover> add syslog.7
+ Added /log/syslog.7
+ amrecover> lpwd
+ /var/log
+ amrecover> lcd ..
+ /var
+ amrecover> extract
+
+ Extracting files using tape drive /dev/nst0 on host 192.168.0.10
+
+ The following tapes are needed: DMP014
+
+ Restoring files into directory /var
+ Continue? [Y/n]: y
+
+ Load tape DMP014 now
+ Continue? [Y/n/t]: y
+ set owner/mode for '.'? [yn] n
+ amrecover> quit
+ 200 Good bye.
+ # ls -l syslog.7
+ total 26
+ -rw-r--r-- 1 root other 12678 Oct 14 16:36 syslog.7
+
+If you do not want to overwrite existing files, create a subdirectory to run
+amrecover from and then move the restored files afterward.
+
+ # cd /var
+ # (umask 077 ; mkdir .restore)
+ # cd .restore
+ # amrecover
+ AMRECOVER Version 2.4.2. Contacting server on oops ...
+ ...
+ amrecover> cd log
+ /var/log
+ amrecover> ls
+ ...
+ amrecover> add syslog.7
+ Added /log/syslog.7
+ amrecover> lpwd
+ /var/.restore
+ amrecover> extract
+
+ Extracting files using tape drive /dev/nst0 on host 192.168.0.10
+ ...
+ amrecover> quit
+ 200 Good bye.
+ # mv -i log/syslog.7 ../log/syslog.7-restored
+ # cd ..
+ # rm -fr .restore
+
+If you need to run amrestore by hand instead of letting amrecover control it,
+use the list command after browsing to display the needed tapes.
+
+ # cd /var/log
+ # amrecover
+ AMRECOVER Version 2.4.2. Contacting server on oops ...
+ ...
+ amrecover> ls
+ ...
+ amrecover> add syslog syslog.6 syslog.7
+ Added /log/syslog
+ Added /log/syslog.6
+ Added /log/syslog.7
+ amrecover> list
+ TAPE DMP014 LEVEL 0 DATE 1997-12-08
+ /log/syslog.7
+ /log/syslog.6
+ TAPE DMP015 LEVEL 1 DATE 1997-12-09
+ /log/syslog
+ amrecover> quit
+
+The history command shows each tape that has a backup of the current disk along
+with the date of the backup, the level, the tape label and the file position on
+the tape. All active tapes are listed, not just back to the most recent full
+dump.
+Tape file position zero is a label. The first backup image is in file position
+one.
+
+ # cd /var/log
+ # amrecover
+ AMRECOVER Version 2.4.2. Contacting server on oops ...
+ ...
+ amrecover> history
+ 200- Dump history for config "daily" host "this-host.some.org" disk "/var"
+ 201- 1997-12-09 1 DMP015 9
+ 201- 1997-12-08 1 DMP014 11
+ 201- 1997-12-07 0 DMP013 22
+ 201- 1997-12-06 1 DMP012 16
+ 201- 1997-12-05 1 DMP011 9
+ 201- 1997-12-04 0 DMP010 11
+ 201- 1997-12-03 1 DMP009 7
+ 201- 1997-12-02 1 DMP008 7
+ 201- 1997-12-01 1 DMP007 9
+ 201- 1997-11-30 1 DMP006 6
+ ...
+ amrecover> quit
+
+
+ENVIRONMENT
+
+PAGER The ls and list commands will use $PAGER to display the file lists.
+Defaults to more if PAGER is not set.
+
+AUTHOR
+
+Alan M. McIvor <alan@kauri.auck.irl.cri.nz> : Original text
+Stefan G. Weichinger, <sgw@amanda.org>, maintainer of the AMANDA-documentation:
+XML-conversion
+
+SEE ALSO
+
+amanda(8), amrestore(8), readline(3)
+-------------------------------------------------------------------------------
+
+Prev Up Next
+amplot Home amreport
+