SysTutorials

Linux Manual Pages › Section 8

amrecover(8)

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 (‘