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 2.6.1p2
10 .TH "AMCHECK" "8" "11/05/2009" "Amanda 2\&.6\&.1p2" "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 \fIAmanda\fR self\-checks
24 .HP \w'\fBamcheck\fR\ 'u
25 \fBamcheck\fR [\-am] [\-w] [\-sclt] [\-M\ \fIaddress\fR] \fIconfig\fR [\fIhost\fR\ [\fIdisk\fR...]...] [\-o\ \fIconfigoption\fR]...
29 runs a number of self\-checks on both the
31 tape server host and the
35 On the tape server host,
37 can go through the same tape checking used at the start of the nightly
39 run to verify the correct tape for the next run is mounted\&.
42 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\&.
44 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\&.
48 man page for more details about
54 Run the tape server local and tape checks (same as
60 Run the client host checks\&. Multiple specific clients can be checked by specifying the client name\&.
65 Run the local tests (e\&.g\&. permissions) on the server host\&.
70 Run the tape tests on the server host\&.
75 Enables a DESTRUCTIVE check for write\-protection on the tape (which would otherwise cause the subsequent
77 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\&.
82 Nothing is printed, but mail is sent if any errors are detected\&. The mail goes to the
84 address specified in the
97 but the mail is always sent\&.
100 \fB\-M\fR \fIaddress\fR
107 \fIamanda\&.conf\fR\&. Implies
111 \fIhost\fR [\fIdisk\fR]*
113 Specify the host and disk on which the command will work\&.
116 \fB\-o\fR \fIconfigoption\fR
118 See the "\fBCONFIGURATION OVERRIDE\fR" section in
126 In this example, both the tape server and client tests are run\&. The results are displayed on standard output\&.
129 \fIAmanda\fR Tape Server Host Check
130 \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
131 /amanda2/amanda/work: 911475 KB disk space available, that\'s plenty\&.
132 NOTE: skipping tape\-writable test\&.
133 Tape VOL10 label ok\&.
134 Server check took 34\&.966 seconds\&.
136 \fIAmanda\fR Backup Client Hosts Check
137 \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
138 WARNING: northstar: selfcheck request timed out\&. Host down?
139 WARNING: drinkme: selfcheck request timed out\&. Host down?
140 WARNING: scruffy: selfcheck request timed out\&. Host down?
141 Client check: 136 hosts checked in 51\&.945 seconds, 3 problems found\&.
143 (brought to you by \fIAmanda\fR 2\&.5\&.0)
146 In this example, if the line
147 \fBmailto csd\-amanda\fR
149 \fIamanda\&.conf\fR, mail will be sent to
151 if the server check returns an error\&.
153 % amcheck \-s \-m daily
157 fatal slot \fIslot\fR: \fIerror message\fR
159 (error) The tape changer detected some kind of fatal error while trying to load slot
163 slot \fIslot\fR: \fIerror message\fR
165 (warning) The tape changer detected some kind of non\-fatal error (e\&.g\&. an empty slot was detected) while trying to load slot
166 \fIslot\fR, or an error was detected trying to read the tape label\&.
169 slot \fIslot\fR: date \fIYYYYMMDD\fR label \fIlabel\fR (\fIresult\fR)
175 was loaded and found to have been last written on
176 \fIYYYYMMDD\fR\&. If the tape is new, the date field will be an
183 This is the expected tape\&.
188 This label does not match the
191 \fIamanda\&.conf\fR\&. Tape scanning will continue\&.
196 This tape is still active and cannot be overwritten\&. Tape scanning will continue\&.
201 This tape is the first one that matches the
204 \fIamanda\&.conf\fR\&. Tape scanning will continue if necessary\&.
209 This tape is the next one that matches the
212 \fIamanda\&.conf\fR\&. Tape scanning will continue\&.
217 ERROR: cannot look up dump user \fIuser\fR
223 could not be found in the system password information\&.
226 ERROR: cannot look up my own uid (\fIuid\fR)
232 could not be found in the system password information\&.
235 ERROR: running as user \fIrunuser\fR instead of \fIdumpuser\fR
239 should be run as the dump user
247 ERROR: program dir \fIdirectory\fR: not accessible
249 (error) The directory
251 expects to find its auxiliary programs in,
252 \fIdirectory\fR, is not accessible\&.
255 ERROR: program \fIprogram\fR: does not exist
259 needed on the tape server could not be found\&.
262 ERROR: program \fIprogram\fR: not a file
266 needed on the tape server exists but is not a file\&.
269 ERROR: program \fIprogram\fR: not executable
273 needed on the tape server exists but is not executable\&.
276 WARNING: program \fIprogram\fR: not setuid\-root
280 needed on the tape server exists but should be owned by user "root" and setuid\&.
283 ERROR: \fIXXX\fR dir \fIdirectory\fR: not writable
287 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
303 for the directory that holds the old log files (see
313 database information directory (see
316 \fBamanda\&.conf\fR) or
337 NOTE: \fIXXX\fR dir \fIdirectory\fR: does not exist
339 (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\&.
342 NOTE: it will be created on the next run
344 (info) This indicates the info directory listed in the previous message will be created on the next run\&.
347 ERROR: \fIXXX\fR dir \fIname\fR: not a directory
353 to be a directory, but it is something else (e\&.g\&. file)\&.
356 WARNING: info file file: does not exist
360 does not exist in the text format database\&. Since the parent directories do exist, the file should already have been created\&.
363 ERROR: info file name: not a file
369 to be a file, but it is something else (e\&.g\&. file)\&.
372 ERROR: info file file: not readable
374 (error) The text format database file
379 ERROR: log file file: not writable
388 \fBamanda\&.conf\fR) is either not writable, or cannot be accessed, perhaps because a parent directory does not allow search permission\&.
391 ERROR: tape list \fItapelist\fR: not writable
395 is not writable or was not found\&.
398 ERROR: tape list \fItapelist\fR: parse error
402 could not be read or parsed\&.
405 WARNING: tapedev is /dev/null, dumps will be thrown away
415 uses that when debugging to throw all the dump images away\&.
418 WARNING: hold file file exists
422 exists and will cause
424 to pause at the beginning until it is removed\&.
427 ERROR: holding disk \fIdisk\fR: statfs: \fIerror message\fR
429 (error) An error was returned from the
431 system call on holding disk
433 (maybe because it does not exist)\&.
436 ERROR: holding disk \fIdisk\fR: not writable
439 \fIdisk\fR, is not writable, probably because the caller does not have write permission or a parent directory does not allow search permission\&.
442 WARNING: holding disk \fIdisk\fR: available space unknown \fIN\fR KB requested\&.
446 could not determine the amount of available space on holding disk
448 to see if there were at least
453 WARNING: holding disk \fIdisk\fR: only \fIF\fR KB free (\fIR\fR KB requested)\&.
459 KBytes of free space on holding disk
462 KBytes were available\&. 10 MBytes is subtracted for each backup process (see the
465 option) to allow for unexpected overruns\&.
471 .nr an-no-space-flag 1
478 Even though this message is listed as a warning, it causes
480 to exit with a non\-zero status\&.
485 Holding disk \fIdisk\fR: \fIN\fR KB disk space available, that\'s plenty\&.
487 (info) There was sufficient free space on holding disk
491 WARNING: holding disk \fIdisk\fR: only \fIF\fR KB free, using nothing
493 (warning) Holding disk
497 KBytes of free space, but that is not enough for what is requested in
498 \fIamanda\&.conf\fR\&.
501 Holding disk \fIdisk\fR: \fIF\fR KB disk space available, using \fIU\fR KB
507 KBytes of free space and
514 WARNING: if a tape changer is not available, runtapes must be set to 1\&.
519 option must be set to 1 if the
525 ERROR: \fIerror message\fR\&.
527 (error) An error was detected while initializing the tape changer\&.
530 ERROR: \fItape device\fR: \fIerror message\fR\&.
532 (error) An error was detected while processing the tape label\&.
535 ERROR: cannot overwrite active tape \fIlabel\fR\&.
539 is still active and cannot be used\&.
542 ERROR: label \fIlabel\fR doesn\'t match labelstr \fIpattern\fR \&.
544 (error) The label on tape
552 (expecting a new tape)
554 (info) The tape is not OK and a new tape was expected\&.
557 (expecting tape \fIlabel\fR or a new tape)
559 (info) The tape is not OK and either tape
561 or a new tape was expected\&.
564 ERROR: tape \fIlabel\fR label ok, but is not writable\&.
568 is OK, but the write enable test failed\&.
571 Tape \fIlabel\fR is writable\&.
575 is OK and the write enable test succeeded\&.
578 NOTE: skipping tape\-writable test\&.
580 (info) The tape write test (see the
582 option) was not enabled\&.
585 WARNING: skipping tape test because amdump or amflush seem to be running, WARNING: if they are not, you must run amcleanup
587 (warning) It looked to
593 were running because a log file or amdump file exists\&. If they are not running, you probably need to run
595 to clear up a previous failure\&. Otherwise, you need to wait until they complete before running
599 NOTE: skipping tape checks
601 (info) The tape tests are being skipped because you used the
603 command line option\&.
606 WARNING: \fIcompress\fR is not executable, server\-compression and indexing will not work
608 (warning) Compression program
610 is not executable, so compression on the tape server host and creating index files will not work\&.
613 Tape \fIlabel\fR label ok\&.
617 is OK for the next run\&.
620 Server check took \fIS\fR seconds\&.
622 (info) Reports how long the tape server host checks took\&.
625 ERROR: \fIhost\fR: could not resolve hostname
627 (error) Could not look up client hostname
631 Client check: \fIH\fR hosts checked in \fIS\fR seconds, \fIN\fR problems found\&.
633 (info) Reports the number of client hosts checked, how long it took and the number of errors detected\&.
636 WARNING: \fIhost\fR: selfcheck request timed out\&. Host down?
638 (warning) There was no response from
640 when trying to do the client checks\&. The host might really be down or it might not be configured properly\&.
643 ERROR: \fIhost\fR NAK: \fImessage\fR
647 reported a negative acknowledgment error of
649 to the status check request\&.
652 ERROR: \fIhost\fR NAK: [NAK parse failed]
656 could not parse the negative acknowledgment error from
657 \fIhost\fR\&. There might be an
659 version mismatch between the host running
665 ERROR: \fIhost\fR [mutual\-authentication failed]
667 (error) Kerberos authentication failed while contacting
671 ERROR: \fIhost\fR: \fImessage\fR
675 was reported by the status check on
680 The exit code of \fBamcheck\fR is one of:
689 : http://wiki.zmanda.com
692 \fBJames da Silva\fR <\&jds@amanda\&.org\&>
694 \fBStefan G\&. Weichinger\fR <\&sgw@amanda\&.org\&>