3 .\" Author: James da Silva <jds@amanda.org>
4 .\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
6 .\" Manual: System Administration Commands
7 .\" Source: Amanda 3.3.2
10 .TH "AMCHECK" "8" "07/25/2012" "Amanda 3\&.3\&.2" "System Administration Commands"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
25 .\" disable justification (adjust text to left margin only)
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
31 amcheck \- run Amanda self\-checks
33 .HP \w'\fBamcheck\fR\ 'u
34 \fBamcheck\fR [\-am] [\-w] [\-sclt] [\-M\ \fIaddress\fR] [\-\-client\-verbose] [\fB\-o\fR\ \fIconfigoption\fR...] \fIconfig\fR [\fIhost\fR\ [\fIdisk\fR...]...]
38 runs a number of self\-checks on both the Amanda tape server host and the Amanda client hosts\&.
40 On the tape server host,
42 can go through the same tape checking used at the start of the nightly
44 run to verify the correct tape for the next run is mounted\&.
47 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\&.
49 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\&.
53 man page for more details about Amanda\&.
58 Run the tape server local and tape checks (same as
64 Run the client host checks\&. Multiple specific clients can be checked by specifying the client name\&.
69 Run the local tests (e\&.g\&. permissions) on the server host\&.
74 Run the tape tests on the server host\&.
79 Enables a DESTRUCTIVE check for write\-protection on the tape (which would otherwise cause the subsequent
81 to fail)\&. If the tape is writable, this check causes all data after the tape label to be erased\&. If the
83 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\&.
88 Nothing is printed, but mail is sent if any errors are detected\&. The mail goes to the
90 address specified in the
103 but the mail is always sent\&.
106 \fB\-M\fR \fIaddress\fR
113 \fIamanda\&.conf\fR\&. Implies
117 \fB\-\-client\-verbose\fR
119 Print all client messages\&.
122 \fIhost\fR [\fIdisk\fR]*
124 Specify the host and disk on which the command will work\&.
127 \fB\-o \fR\fB\fIconfigoption\fR\fR
129 See the "CONFIGURATION OVERRIDE" section in
137 In this example, both the tape server and client tests are run\&. The results are displayed on standard output\&.
140 Amanda Tape Server Host Check
141 \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
142 /amanda2/amanda/work: 911475 KB disk space available, that\*(Aqs plenty\&.
143 NOTE: skipping tape\-writable test\&.
144 Tape VOL10 label ok\&.
145 Server check took 34\&.966 seconds\&.
147 Amanda Backup Client Hosts Check
148 \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
149 WARNING: northstar: selfcheck request timed out\&. Host down?
150 WARNING: drinkme: selfcheck request timed out\&. Host down?
151 WARNING: scruffy: selfcheck request timed out\&. Host down?
152 Client check: 136 hosts checked in 51\&.945 seconds, 3 problems found\&.
154 (brought to you by Amanda 2\&.5\&.0)
157 In this example, if the line
158 \fBmailto csd\-amanda\fR
160 \fIamanda\&.conf\fR, mail will be sent to
162 if the server check returns an error\&.
164 % amcheck \-s \-m daily
168 fatal slot \fIslot\fR: \fIerror message\fR
170 (error) The tape changer detected some kind of fatal error while trying to load slot
174 slot \fIslot\fR: \fIerror message\fR
176 (warning) The tape changer detected some kind of non\-fatal error (e\&.g\&. an empty slot was detected) while trying to load slot
177 \fIslot\fR, or an error was detected trying to read the tape label\&.
180 slot \fIslot\fR: date \fIYYYYMMDD\fR label \fIlabel\fR (\fIresult\fR)
186 was loaded and found to have been last written on
187 \fIYYYYMMDD\fR\&. If the tape is new, the date field will be an
194 This is the expected tape\&.
199 This label does not match the
202 \fIamanda\&.conf\fR\&. Tape scanning will continue\&.
207 This tape is still active and cannot be overwritten\&. Tape scanning will continue\&.
212 This tape is the first one that matches the
215 \fIamanda\&.conf\fR\&. Tape scanning will continue if necessary\&.
220 This tape is the next one that matches the
223 \fIamanda\&.conf\fR\&. Tape scanning will continue\&.
228 ERROR: cannot look up dump user \fIuser\fR
234 could not be found in the system password information\&.
237 ERROR: cannot look up my own uid (\fIuid\fR)
243 could not be found in the system password information\&.
246 ERROR: running as user \fIrunuser\fR instead of \fIdumpuser\fR
250 should be run as the dump user
258 ERROR: program dir \fIdirectory\fR: not accessible
260 (error) The directory Amanda expects to find its auxiliary programs in,
261 \fIdirectory\fR, is not accessible\&.
264 ERROR: program \fIprogram\fR: does not exist
268 needed on the tape server could not be found\&.
271 ERROR: program \fIprogram\fR: not a file
275 needed on the tape server exists but is not a file\&.
278 ERROR: program \fIprogram\fR: not executable
282 needed on the tape server exists but is not executable\&.
285 WARNING: program \fIprogram\fR: not setuid\-root
289 needed on the tape server exists but should be owned by user "root" and setuid\&.
292 ERROR: \fIXXX\fR dir \fIdirectory\fR: not writable
296 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
302 for the Amanda log directory (see
310 for the directory that holds the old log files (see
318 for an Amanda database information directory (see
321 \fBamanda\&.conf\fR) or
326 for an Amanda index directory (see
340 NOTE: \fIXXX\fR dir \fIdirectory\fR: does not exist
342 (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\&.
345 NOTE: it will be created on the next run
347 (info) This indicates the info directory listed in the previous message will be created on the next run\&.
350 ERROR: \fIXXX\fR dir \fIname\fR: not a directory
356 to be a directory, but it is something else (e\&.g\&. file)\&.
359 WARNING: info file file: does not exist
363 does not exist in the text format database\&. Since the parent directories do exist, the file should already have been created\&.
366 ERROR: info file name: not a file
372 to be a file, but it is something else (e\&.g\&. file)\&.
375 ERROR: info file file: not readable
377 (error) The text format database file
382 ERROR: log file file: not writable
391 \fBamanda\&.conf\fR) is either not writable, or cannot be accessed, perhaps because a parent directory does not allow search permission\&.
394 ERROR: tape list \fItapelist\fR: not writable
398 is not writable or was not found\&.
401 ERROR: tape list \fItapelist\fR: parse error
405 could not be read or parsed\&.
408 WARNING: tapedev is /dev/null, dumps will be thrown away
416 and Amanda uses that when debugging to throw all the dump images away\&.
419 WARNING: hold file file exists
423 exists and will cause
425 to pause at the beginning until it is removed\&.
428 ERROR: holding disk \fIdisk\fR: statfs: \fIerror message\fR
430 (error) An error was returned from the
432 system call on holding disk
434 (maybe because it does not exist)\&.
437 ERROR: holding disk \fIdisk\fR: not writable
440 \fIdisk\fR, is not writable, probably because the caller does not have write permission or a parent directory does not allow search permission\&.
443 WARNING: holding disk \fIdisk\fR: available space unknown \fIN\fR KB requested\&.
447 could not determine the amount of available space on holding disk
449 to see if there were at least
454 WARNING: holding disk \fIdisk\fR: only \fIF\fR KB free (\fIR\fR KB requested)\&.
460 KBytes of free space on holding disk
463 KBytes were available\&. 10 MBytes is subtracted for each backup process (see the
466 option) to allow for unexpected overruns\&.
472 .nr an-no-space-flag 1
479 Even though this message is listed as a warning, it causes
481 to exit with a non\-zero status\&.
486 Holding disk \fIdisk\fR: \fIN\fR KB disk space available, that\*(Aqs plenty\&.
488 (info) There was sufficient free space on holding disk
492 WARNING: holding disk \fIdisk\fR: only \fIF\fR KB free, using nothing
494 (warning) Holding disk
498 KBytes of free space, but that is not enough for what is requested in
499 \fIamanda\&.conf\fR\&.
502 Holding disk \fIdisk\fR: \fIF\fR KB disk space available, using \fIU\fR KB
508 KBytes of free space and Amanda will be using up to
513 WARNING: if a tape changer is not available, runtapes must be set to 1\&.
518 option must be set to 1 if the
524 ERROR: \fIerror message\fR\&.
526 (error) An error was detected while initializing the tape changer\&.
529 ERROR: \fItape device\fR: \fIerror message\fR\&.
531 (error) An error was detected while processing the tape label\&.
534 ERROR: cannot overwrite active tape \fIlabel\fR\&.
538 is still active and cannot be used\&.
541 ERROR: label \fIlabel\fR doesn\*(Aqt match labelstr \fIpattern\fR \&.
543 (error) The label on tape
551 (expecting a new tape)
553 (info) The tape is not OK and a new tape was expected\&.
556 (expecting tape \fIlabel\fR or a new tape)
558 (info) The tape is not OK and either tape
560 or a new tape was expected\&.
563 ERROR: tape \fIlabel\fR label ok, but is not writable\&.
567 is OK, but the write enable test failed\&.
570 Tape \fIlabel\fR is writable\&.
574 is OK and the write enable test succeeded\&.
577 NOTE: skipping tape\-writable test\&.
579 (info) The tape write test (see the
581 option) was not enabled\&.
584 WARNING: skipping tape test because amdump or amflush seem to be running, WARNING: if they are not, you must run amcleanup
586 (warning) It looked to
592 were running because a log file or amdump file exists\&. If they are not running, you probably need to run
594 to clear up a previous failure\&. Otherwise, you need to wait until they complete before running
598 NOTE: skipping tape checks
600 (info) The tape tests are being skipped because you used the
602 command line option\&.
605 WARNING: \fIcompress\fR is not executable, server\-compression and indexing will not work
607 (warning) Compression program
609 is not executable, so compression on the tape server host and creating index files will not work\&.
612 Tape \fIlabel\fR label ok\&.
616 is OK for the next run\&.
619 Server check took \fIS\fR seconds\&.
621 (info) Reports how long the tape server host checks took\&.
624 ERROR: \fIhost\fR: could not resolve hostname
626 (error) Could not look up client hostname
630 Client check: \fIH\fR hosts checked in \fIS\fR seconds, \fIN\fR problems found\&.
632 (info) Reports the number of client hosts checked, how long it took and the number of errors detected\&.
635 WARNING: \fIhost\fR: selfcheck request timed out\&. Host down?
637 (warning) There was no response from
639 when trying to do the client checks\&. The host might really be down or it might not be configured properly\&.
642 ERROR: \fIhost\fR NAK: \fImessage\fR
646 reported a negative acknowledgment error of
648 to the status check request\&.
651 ERROR: \fIhost\fR NAK: [NAK parse failed]
655 could not parse the negative acknowledgment error from
656 \fIhost\fR\&. There might be an Amanda version mismatch between the host running
662 ERROR: \fIhost\fR [mutual\-authentication failed]
664 (error) Kerberos authentication failed while contacting
668 ERROR: \fIhost\fR: \fImessage\fR
672 was reported by the status check on
677 The exit code of \fBamcheck\fR is one of:
685 \fBamanda.conf\fR(5),
689 : http://wiki.zmanda.com/
692 \fBJames da Silva\fR <\&jds@amanda\&.org\&>
694 \fBStefan G\&. Weichinger\fR <\&sgw@amanda\&.org\&>