3 .\" Author: James da Silva <jds@amanda.org>
4 .\" Generator: DocBook XSL Stylesheets vsnapshot_8273 <http://docbook.sf.net/>
6 .\" Manual: System Administration Commands
7 .\" Source: Amanda 3.1.0
10 .TH "AMCHECK" "8" "06/01/2010" "Amanda 3\&.1\&.0" "System Administration Commands"
11 .\" -----------------------------------------------------------------
12 .\" * set default formatting
13 .\" -----------------------------------------------------------------
14 .\" disable hyphenation
16 .\" disable justification (adjust text to left margin only)
18 .\" -----------------------------------------------------------------
19 .\" * MAIN CONTENT STARTS HERE *
20 .\" -----------------------------------------------------------------
22 amcheck \- run Amanda self\-checks
24 .HP \w'\fBamcheck\fR\ 'u
25 \fBamcheck\fR [\-am] [\-w] [\-sclt] [\-M\ \fIaddress\fR] \fIconfig\fR [\fIhost\fR\ [\fIdisk\fR...]...] [{\fB\-o\fR\ \fIconfigoption\fR}...]
29 runs a number of self\-checks on both the Amanda tape server host and the Amanda client hosts\&.
31 On the tape server host,
33 can go through the same tape checking used at the start of the nightly
35 run to verify the correct tape for the next run is mounted\&.
38 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\&.
40 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\&.
44 man page for more details about Amanda\&.
49 Run the tape server local and tape checks (same as
55 Run the client host checks\&. Multiple specific clients can be checked by specifying the client name\&.
60 Run the local tests (e\&.g\&. permissions) on the server host\&.
65 Run the tape tests on the server host\&.
70 Enables a DESTRUCTIVE check for write\-protection on the tape (which would otherwise cause the subsequent
72 to fail)\&. If the tape is writable, this check causes all data after the tape label to be erased\&. If the label_new_tapes option is enabled, this check may ERASE any non\-Amanda tape in the drive or changer\&. The check enable the tape tests on the server host and is only made if the tape is otherwise correct\&.
77 Nothing is printed, but mail is sent if any errors are detected\&. The mail goes to the
79 address specified in the
92 but the mail is always sent\&.
95 \fB\-M\fR \fIaddress\fR
102 \fIamanda\&.conf\fR\&. Implies
106 \fIhost\fR [\fIdisk\fR]*
108 Specify the host and disk on which the command will work\&.
111 \fB\-o \fR\fB\fIconfigoption\fR\fR
113 See the "CONFIGURATION OVERRIDE" section in
121 In this example, both the tape server and client tests are run\&. The results are displayed on standard output\&.
124 Amanda Tape Server Host Check
125 \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
126 /amanda2/amanda/work: 911475 KB disk space available, that\'s plenty\&.
127 NOTE: skipping tape\-writable test\&.
128 Tape VOL10 label ok\&.
129 Server check took 34\&.966 seconds\&.
131 Amanda Backup Client Hosts Check
132 \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
133 WARNING: northstar: selfcheck request timed out\&. Host down?
134 WARNING: drinkme: selfcheck request timed out\&. Host down?
135 WARNING: scruffy: selfcheck request timed out\&. Host down?
136 Client check: 136 hosts checked in 51\&.945 seconds, 3 problems found\&.
138 (brought to you by Amanda 2\&.5\&.0)
141 In this example, if the line
142 \fBmailto csd\-amanda\fR
144 \fIamanda\&.conf\fR, mail will be sent to
146 if the server check returns an error\&.
148 % amcheck \-s \-m daily
152 fatal slot \fIslot\fR: \fIerror message\fR
154 (error) The tape changer detected some kind of fatal error while trying to load slot
158 slot \fIslot\fR: \fIerror message\fR
160 (warning) The tape changer detected some kind of non\-fatal error (e\&.g\&. an empty slot was detected) while trying to load slot
161 \fIslot\fR, or an error was detected trying to read the tape label\&.
164 slot \fIslot\fR: date \fIYYYYMMDD\fR label \fIlabel\fR (\fIresult\fR)
170 was loaded and found to have been last written on
171 \fIYYYYMMDD\fR\&. If the tape is new, the date field will be an
178 This is the expected tape\&.
183 This label does not match the
186 \fIamanda\&.conf\fR\&. Tape scanning will continue\&.
191 This tape is still active and cannot be overwritten\&. Tape scanning will continue\&.
196 This tape is the first one that matches the
199 \fIamanda\&.conf\fR\&. Tape scanning will continue if necessary\&.
204 This tape is the next one that matches the
207 \fIamanda\&.conf\fR\&. Tape scanning will continue\&.
212 ERROR: cannot look up dump user \fIuser\fR
218 could not be found in the system password information\&.
221 ERROR: cannot look up my own uid (\fIuid\fR)
227 could not be found in the system password information\&.
230 ERROR: running as user \fIrunuser\fR instead of \fIdumpuser\fR
234 should be run as the dump user
242 ERROR: program dir \fIdirectory\fR: not accessible
244 (error) The directory Amanda expects to find its auxiliary programs in,
245 \fIdirectory\fR, is not accessible\&.
248 ERROR: program \fIprogram\fR: does not exist
252 needed on the tape server could not be found\&.
255 ERROR: program \fIprogram\fR: not a file
259 needed on the tape server exists but is not a file\&.
262 ERROR: program \fIprogram\fR: not executable
266 needed on the tape server exists but is not executable\&.
269 WARNING: program \fIprogram\fR: not setuid\-root
273 needed on the tape server exists but should be owned by user "root" and setuid\&.
276 ERROR: \fIXXX\fR dir \fIdirectory\fR: not writable
280 is either not writable, i\&.e\&. the dump user will not be able to create or remove files, or cannot be accessed, perhaps because a parent directory does not allow search permission\&. The
286 for the Amanda log directory (see
294 for the directory that holds the old log files (see
302 for an Amanda database information directory (see
305 \fBamanda\&.conf\fR) or
310 for an Amanda index directory (see
324 NOTE: \fIXXX\fR dir \fIdirectory\fR: does not exist
326 (info) A database (info) or index directory does not exist or cannot be accessed\&. This might just mean this is a new client or disk, but if that is not the case, this should be treated as an error\&.
329 NOTE: it will be created on the next run
331 (info) This indicates the info directory listed in the previous message will be created on the next run\&.
334 ERROR: \fIXXX\fR dir \fIname\fR: not a directory
340 to be a directory, but it is something else (e\&.g\&. file)\&.
343 WARNING: info file file: does not exist
347 does not exist in the text format database\&. Since the parent directories do exist, the file should already have been created\&.
350 ERROR: info file name: not a file
356 to be a file, but it is something else (e\&.g\&. file)\&.
359 ERROR: info file file: not readable
361 (error) The text format database file
366 ERROR: log file file: not writable
375 \fBamanda\&.conf\fR) is either not writable, or cannot be accessed, perhaps because a parent directory does not allow search permission\&.
378 ERROR: tape list \fItapelist\fR: not writable
382 is not writable or was not found\&.
385 ERROR: tape list \fItapelist\fR: parse error
389 could not be read or parsed\&.
392 WARNING: tapedev is /dev/null, dumps will be thrown away
400 and Amanda uses that when debugging to throw all the dump images away\&.
403 WARNING: hold file file exists
407 exists and will cause
409 to pause at the beginning until it is removed\&.
412 ERROR: holding disk \fIdisk\fR: statfs: \fIerror message\fR
414 (error) An error was returned from the
416 system call on holding disk
418 (maybe because it does not exist)\&.
421 ERROR: holding disk \fIdisk\fR: not writable
424 \fIdisk\fR, is not writable, probably because the caller does not have write permission or a parent directory does not allow search permission\&.
427 WARNING: holding disk \fIdisk\fR: available space unknown \fIN\fR KB requested\&.
431 could not determine the amount of available space on holding disk
433 to see if there were at least
438 WARNING: holding disk \fIdisk\fR: only \fIF\fR KB free (\fIR\fR KB requested)\&.
444 KBytes of free space on holding disk
447 KBytes were available\&. 10 MBytes is subtracted for each backup process (see the
450 option) to allow for unexpected overruns\&.
456 .nr an-no-space-flag 1
463 Even though this message is listed as a warning, it causes
465 to exit with a non\-zero status\&.
470 Holding disk \fIdisk\fR: \fIN\fR KB disk space available, that\'s plenty\&.
472 (info) There was sufficient free space on holding disk
476 WARNING: holding disk \fIdisk\fR: only \fIF\fR KB free, using nothing
478 (warning) Holding disk
482 KBytes of free space, but that is not enough for what is requested in
483 \fIamanda\&.conf\fR\&.
486 Holding disk \fIdisk\fR: \fIF\fR KB disk space available, using \fIU\fR KB
492 KBytes of free space and Amanda will be using up to
497 WARNING: if a tape changer is not available, runtapes must be set to 1\&.
502 option must be set to 1 if the
508 ERROR: \fIerror message\fR\&.
510 (error) An error was detected while initializing the tape changer\&.
513 ERROR: \fItape device\fR: \fIerror message\fR\&.
515 (error) An error was detected while processing the tape label\&.
518 ERROR: cannot overwrite active tape \fIlabel\fR\&.
522 is still active and cannot be used\&.
525 ERROR: label \fIlabel\fR doesn\'t match labelstr \fIpattern\fR \&.
527 (error) The label on tape
535 (expecting a new tape)
537 (info) The tape is not OK and a new tape was expected\&.
540 (expecting tape \fIlabel\fR or a new tape)
542 (info) The tape is not OK and either tape
544 or a new tape was expected\&.
547 ERROR: tape \fIlabel\fR label ok, but is not writable\&.
551 is OK, but the write enable test failed\&.
554 Tape \fIlabel\fR is writable\&.
558 is OK and the write enable test succeeded\&.
561 NOTE: skipping tape\-writable test\&.
563 (info) The tape write test (see the
565 option) was not enabled\&.
568 WARNING: skipping tape test because amdump or amflush seem to be running, WARNING: if they are not, you must run amcleanup
570 (warning) It looked to
576 were running because a log file or amdump file exists\&. If they are not running, you probably need to run
578 to clear up a previous failure\&. Otherwise, you need to wait until they complete before running
582 NOTE: skipping tape checks
584 (info) The tape tests are being skipped because you used the
586 command line option\&.
589 WARNING: \fIcompress\fR is not executable, server\-compression and indexing will not work
591 (warning) Compression program
593 is not executable, so compression on the tape server host and creating index files will not work\&.
596 Tape \fIlabel\fR label ok\&.
600 is OK for the next run\&.
603 Server check took \fIS\fR seconds\&.
605 (info) Reports how long the tape server host checks took\&.
608 ERROR: \fIhost\fR: could not resolve hostname
610 (error) Could not look up client hostname
614 Client check: \fIH\fR hosts checked in \fIS\fR seconds, \fIN\fR problems found\&.
616 (info) Reports the number of client hosts checked, how long it took and the number of errors detected\&.
619 WARNING: \fIhost\fR: selfcheck request timed out\&. Host down?
621 (warning) There was no response from
623 when trying to do the client checks\&. The host might really be down or it might not be configured properly\&.
626 ERROR: \fIhost\fR NAK: \fImessage\fR
630 reported a negative acknowledgment error of
632 to the status check request\&.
635 ERROR: \fIhost\fR NAK: [NAK parse failed]
639 could not parse the negative acknowledgment error from
640 \fIhost\fR\&. There might be an Amanda version mismatch between the host running
646 ERROR: \fIhost\fR [mutual\-authentication failed]
648 (error) Kerberos authentication failed while contacting
652 ERROR: \fIhost\fR: \fImessage\fR
656 was reported by the status check on
661 The exit code of \fBamcheck\fR is one of:
669 \fBamanda.conf\fR(5),
673 : http://wiki.zmanda.com/
676 \fBJames da Silva\fR <\&jds@amanda\&.org\&>
678 \fBStefan G\&. Weichinger\fR <\&sgw@amanda\&.org\&>