|AMCHECK(8)||System Administration Commands||AMCHECK(8)|
NAME¶amcheck - run Amanda self-checks
amcheck [-am] [-w] [-sclt] [-M address] [--client-verbose] [--exact-match] [-o configoption...] config [host [disk...]...]
DESCRIPTION¶Amcheck runs a number of self-checks on both the Amanda tape server host and the Amanda client hosts.
On the tape server host, amcheck can go through the same tape checking used at the start of the nightly amdump run to verify the correct tape for the next run is mounted.
Amcheck can also do a self-check on all client hosts to make sure each host is running and that permissions on filesystems to be backed up are correct.
You can specify many host/disk expressions, only disks that match an expression will be checked. All disks are checked if no expressions are given.
See the amanda(8) man page for more details about Amanda.
The default is -cs.
EXAMPLES¶In this example, both the tape server and client tests are run. The results are displayed on standard output.
% amcheck daily Amanda Tape Server Host Check ----------------------------- /amanda2/amanda/work: 911475 KB disk space available, that's plenty. NOTE: skipping tape-writable test. Tape VOL10 label ok. Server check took 34.966 seconds. Amanda Backup Client Hosts Check -------------------------------- WARNING: northstar: selfcheck request timed out. Host down? WARNING: drinkme: selfcheck request timed out. Host down? WARNING: scruffy: selfcheck request timed out. Host down? Client check: 136 hosts checked in 51.945 seconds, 3 problems found. (brought to you by Amanda 2.5.0)
In this example, if the line mailto csd-amanda is in amanda.conf, mail will be sent to csd-amanda if the server check returns an error.
% amcheck -s -m daily
MESSAGES¶fatal slot slot: error message
slot slot: error message
slot slot: date YYYYMMDD label label (result)
exact label match
first labelstr match
ERROR: cannot look up dump user user
ERROR: cannot look up my own uid (uid)
ERROR: running as user runuser instead of dumpuser
ERROR: program dir directory: not accessible
ERROR: program program: does not exist
ERROR: program program: not a file
ERROR: program program: not executable
WARNING: program program: not setuid-root
ERROR: XXX dir directory: not writable
NOTE: XXX dir directory: does not exist
NOTE: it will be created on the next run
ERROR: XXX dir name: not a directory
WARNING: info file file: does not exist
ERROR: info file name: not a file
ERROR: info file file: not readable
ERROR: log file file: not writable
ERROR: tape list tapelist: not writable
ERROR: tape list tapelist: parse error
WARNING: tapedev is /dev/null, dumps will be thrown away
WARNING: hold file file exists
ERROR: holding disk disk: statfs: error message
ERROR: holding disk disk: not writable
WARNING: holding disk disk: available space unknown N KB requested.
WARNING: holding disk disk: only F KB free (R KB requested).
Even though this message is listed as a warning, it causes amcheck to exit with a non-zero status.
Holding disk disk: N KB disk space available, that's plenty.
WARNING: holding disk disk: only F KB free, using nothing
Holding disk disk: F KB disk space available, using U KB
WARNING: if a tape changer is not available, runtapes must be set to 1.
ERROR: error message.
ERROR: tape device: error message.
ERROR: cannot overwrite active tape label.
ERROR: label label doesn't match labelstr pattern .
(expecting a new tape)
(expecting tape label or a new tape)
ERROR: tape label label ok, but is not writable.
Tape label is writable.
NOTE: skipping tape-writable test.
WARNING: skipping tape test because amdump or amflush seem to be running, WARNING: if they are not, you must run amcleanup
NOTE: skipping tape checks
WARNING: compress is not executable, server-compression and indexing will not work
Tape label label ok.
Server check took S seconds.
ERROR: host: could not resolve hostname
Client check: H hosts checked in S seconds, N problems found.
WARNING: host: selfcheck request timed out. Host down?
ERROR: host NAK: message
ERROR: host NAK: [NAK parse failed]
ERROR: host [mutual-authentication failed]
ERROR: host: message
EXIT CODE¶The exit code of amcheck is one of:
0 = success 1 = error
SEE ALSO¶amanda(8), amanda.conf(5), amdump(8)
The Amanda Wiki: : http://wiki.zmanda.com/
AUTHORS¶James da Silva <firstname.lastname@example.org>
Stefan G. Weichinger <email@example.com>