AMRECOVER(8) System Administration Commands AMRECOVER(8)
NAME
amrecover - Amanda index database browser
SYNOPSIS
amrecover [-s index-server] [-t tape-server] [-d tape-device] [-h hostname] [-o configoption...] [-C config]
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.
Amrecover will read the amanda-client.conf file and the config/amanda-client.conf file. If no configuration name is supplied on the command
line, Amrecover will try the compiled-in default configuration ,usually DailySet1.
See the amanda(8) man page for more details about Amanda.
OPTIONS
Note
The Default values are those set at compile-time. Use amrestore to recover client-encrypted or client-custom-compressed tapes.
[ -C ] config
Amanda configuration.
-s index-server
Host that runs the index daemon.
-t tape-server
Host that runs the tape server daemon.
-d tape-device
Tape device to use on the tape server host.
-h hostname
Hostname to begin restoring; defaults to the system's hostname.
-o clientconfigoption
See the "CONFIGURATION OVERRIDE" section in amanda(8).
AUTH
The default auth is 'BSDTCP', you can set a different auth in the amanda-client.conf file or by specifying the '-oauth=bsd' command line
argument.
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-HH-MM[-SS] | YYYY-MM-DD
Set the restore time (default: now). 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 the command setdate 1997-07-08-00 would yield files from the following days:
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(5). 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.
listhost [diskdevice]
List all host
listdisk [diskdevice]
List all diskname
listproperty
List all property
setproperty [append] [priority] name [value ...]
Set the property name to the value value. The append keyword appends the value to the values already set for this property. Without
value, the property is unset. The priority keyword is unused, it is present for ease of copy/paste from application definition.
setdevice [[-h tape-server] tapedev]
Specifies the host to use as the tape server, and which of its tape devices to use. If the server is omitted, the server name reverts
to the configure-time default. If the tape device is omitted, the default is used.
If you want amrecover to use your changer, the tapedev must be equal to the amrecover-changer setting on the server.
Since device names contain colons, you must always 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.
settranslate [on|off]
Default: on. Translate escaped octal value ('