amrecover

Start recovery session with a configuration

$ amrecover [config_name]

$ amrecover -s [index_server] [config_name]

$ amrecover -t [tape_server] -d [/dev/nst0] [config_name]

$ amrecover -h [hostname] [config_name]

$ sethost [hostname]
setdisk [/home]
setdate [2024-01-15]
cd [path/to/restore]
add [filename]
extract

amrecover [-C config] [-s index-server] [-t tape-server] [-d tape-device] [-h hostname]

amrecover is an interactive tool for browsing Amanda backup indexes and restoring files. It provides an FTP-like interface for navigating through backup snapshots, selecting files for recovery, and extracting them from tape or other backup media.
The tool connects to the Amanda index server to browse the backup catalog and determine which tapes contain the desired files. Users build a restore list by navigating directories and adding files, then initiate extraction which contacts the tape server to retrieve the data.
For in-place restores, run amrecover from the root of the backed-up filesystem or use lcd to change to that directory before extraction. Otherwise, a directory tree replicating the backup structure will be created in the current directory.
The GNU readline library provides command history and editing when available.

-C config

Amanda configuration name to use

Host running the index daemon

Host running the tape server daemon

Tape device to use on the tape server

Hostname to restore; defaults to current system hostname

sethost hostname

Set the host to browse and restore from

Set the disk (filesystem) to browse

Set the date to view the backup state

Change directory within the backup

List contents of current backup directory with dates

Add files or directories to restore list (supports wildcards)

Remove items from restore list

Display current restore list

Clear the restore list

Begin extraction of files in restore list

Show backup history for current host and disk

Change local working directory

Display local working directory

Exit amrecover

Requires running amrecover from the appropriate directory for in-place restores. The index server and tape server must be accessible over the network. For client-encrypted or client-custom-compressed backups, use amrestore instead. Authentication must be properly configured between client and servers.

Amanda (Advanced Maryland Automatic Network Disk Archiver) was developed at the University of Maryland starting in 1991. The amrecover tool provides the primary user interface for file-level recovery, designed to make restores accessible without requiring direct tape manipulation. It has evolved to support various storage backends beyond traditional tape.

amcheck(8), amdump(8), amrestore(8), amfetchdump(8), amanda(8)