2 .\" Author: James da Silva <jds@amanda.org>
3 .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
5 .\" Manual: System Administration Commands
6 .\" Source: Amanda 2.6.1
9 .TH "AMCHECK" "8" "01/22/2009" "Amanda 2\&.6\&.1" "System Administration Commands"
10 .\" -----------------------------------------------------------------
11 .\" * (re)Define some macros
12 .\" -----------------------------------------------------------------
13 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
14 .\" toupper - uppercase a string (locale-aware)
15 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
17 .tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ
19 .tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz
21 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
22 .\" SH-xref - format a cross-reference to an SH section
23 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
32 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
33 .\" SH - level-one heading that works better for non-TTY output
34 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
36 .\" put an extra blank line of space above the head in non-TTY output
43 .nr an-prevailing-indent \\n[IN]
47 .HTML-TAG ".NH \\n[an-level]"
49 .nr an-no-space-flag 1
51 \." make the size of the head bigger
56 .\" if n (TTY output), use uppercase
61 .\" if not n (not TTY), use normal case (not uppercase)
65 .\" if not n (not TTY), put a border/line under subheading
70 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
71 .\" SS - level-two heading that works better for non-TTY output
72 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
77 .nr an-prevailing-indent \\n[IN]
82 .nr an-no-space-flag 1
85 \." make the size of the head bigger
91 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
92 .\" BB/BE - put background/screen (filled box) around block of text
93 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
106 .if "\\$2"adjust-for-leading-newline" \{\
114 .nr BW \\n(.lu-\\n(.i
117 .ie "\\$2"adjust-for-leading-newline" \{\
118 \M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
121 \M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
132 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
133 .\" BM/EM - put colored marker in margin next to block of text
134 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
151 \M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[]
159 .\" -----------------------------------------------------------------
160 .\" * set default formatting
161 .\" -----------------------------------------------------------------
162 .\" disable hyphenation
164 .\" disable justification (adjust text to left margin only)
166 .\" -----------------------------------------------------------------
167 .\" * MAIN CONTENT STARTS HERE *
168 .\" -----------------------------------------------------------------
170 amcheck \- run \fIAmanda\fR self\-checks
173 .HP \w'\fBamcheck\fR\ 'u
174 \fBamcheck\fR [\-am] [\-w] [\-sclt] [\-M\ \fIaddress\fR] \fIconfig\fR [\fIhost\fR\ [\fIdisk\fR...]...] [\-o\ \fIconfigoption\fR]...
179 runs a number of self\-checks on both the
181 tape server host and the
185 On the tape server host,
187 can go through the same tape checking used at the start of the nightly
189 run to verify the correct tape for the next run is mounted\&.
192 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\&.
194 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\&.
198 man page for more details about
204 Run the tape server local and tape checks (same as
210 Run the client host checks\&. Multiple specific clients can be checked by specifying the client name\&.
215 Run the local tests (e\&.g\&. permissions) on the server host\&.
220 Run the tape tests on the server host\&.
225 Enables a DESTRUCTIVE check for write\-protection on the tape (which would otherwise cause the subsequent
227 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\&.
232 Nothing is printed, but mail is sent if any errors are detected\&. The mail goes to the
234 address specified in the
247 but the mail is always sent\&.
250 \fB\-M\fR \fIaddress\fR
257 \fIamanda\&.conf\fR\&. Implies
261 \fIhost\fR [\fIdisk\fR]*
263 Specify the host and disk on which the command will work\&.
266 \fB\-o\fR \fIconfigoption\fR
268 See the "\fBCONFIGURATION OVERRIDE\fR" section in
276 In this example, both the tape server and client tests are run\&. The results are displayed on standard output\&.
279 \fIAmanda\fR Tape Server Host Check
280 \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
281 /amanda2/amanda/work: 911475 KB disk space available, that\'s plenty\&.
282 NOTE: skipping tape\-writable test\&.
283 Tape VOL10 label ok\&.
284 Server check took 34\&.966 seconds\&.
286 \fIAmanda\fR Backup Client Hosts Check
287 \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
288 WARNING: northstar: selfcheck request timed out\&. Host down?
289 WARNING: drinkme: selfcheck request timed out\&. Host down?
290 WARNING: scruffy: selfcheck request timed out\&. Host down?
291 Client check: 136 hosts checked in 51\&.945 seconds, 3 problems found\&.
293 (brought to you by \fIAmanda\fR 2\&.5\&.0)
296 In this example, if the line
297 \fBmailto csd\-amanda\fR
299 \fIamanda\&.conf\fR, mail will be sent to
301 if the server check returns an error\&.
303 % amcheck \-s \-m daily
307 fatal slot \fIslot\fR: \fIerror message\fR
309 (error) The tape changer detected some kind of fatal error while trying to load slot
313 slot \fIslot\fR: \fIerror message\fR
315 (warning) The tape changer detected some kind of non\-fatal error (e\&.g\&. an empty slot was detected) while trying to load slot
316 \fIslot\fR, or an error was detected trying to read the tape label\&.
319 slot \fIslot\fR: date \fIYYYYMMDD\fR label \fIlabel\fR (\fIresult\fR)
325 was loaded and found to have been last written on
326 \fIYYYYMMDD\fR\&. If the tape is new, the date field will be an
333 This is the expected tape\&.
338 This label does not match the
341 \fIamanda\&.conf\fR\&. Tape scanning will continue\&.
346 This tape is still active and cannot be overwritten\&. Tape scanning will continue\&.
351 This tape is the first one that matches the
354 \fIamanda\&.conf\fR\&. Tape scanning will continue if necessary\&.
359 This tape is the next one that matches the
362 \fIamanda\&.conf\fR\&. Tape scanning will continue\&.
367 ERROR: cannot look up dump user \fIuser\fR
373 could not be found in the system password information\&.
376 ERROR: cannot look up my own uid (\fIuid\fR)
382 could not be found in the system password information\&.
385 ERROR: running as user \fIrunuser\fR instead of \fIdumpuser\fR
389 should be run as the dump user
397 ERROR: program dir \fIdirectory\fR: not accessible
399 (error) The directory
401 expects to find its auxiliary programs in,
402 \fIdirectory\fR, is not accessible\&.
405 ERROR: program \fIprogram\fR: does not exist
409 needed on the tape server could not be found\&.
412 ERROR: program \fIprogram\fR: not a file
416 needed on the tape server exists but is not a file\&.
419 ERROR: program \fIprogram\fR: not executable
423 needed on the tape server exists but is not executable\&.
426 WARNING: program \fIprogram\fR: not setuid\-root
430 needed on the tape server exists but should be owned by user "root" and setuid\&.
433 ERROR: \fIXXX\fR dir \fIdirectory\fR: not writable
437 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
453 for the directory that holds the old log files (see
463 database information directory (see
466 \fBamanda\&.conf\fR) or
487 NOTE: \fIXXX\fR dir \fIdirectory\fR: does not exist
489 (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\&.
492 NOTE: it will be created on the next run
494 (info) This indicates the info directory listed in the previous message will be created on the next run\&.
497 ERROR: \fIXXX\fR dir \fIname\fR: not a directory
503 to be a directory, but it is something else (e\&.g\&. file)\&.
506 WARNING: info file \FCfile\F[]: does not exist
510 does not exist in the text format database\&. Since the parent directories do exist, the file should already have been created\&.
513 ERROR: info file \FCname\F[]: not a file
519 to be a file, but it is something else (e\&.g\&. file)\&.
522 ERROR: info file \FCfile\F[]: not readable
524 (error) The text format database file
529 ERROR: log file \FCfile\F[]: not writable
538 \fBamanda\&.conf\fR) is either not writable, or cannot be accessed, perhaps because a parent directory does not allow search permission\&.
541 ERROR: tape list \fItapelist\fR: not writable
545 is not writable or was not found\&.
548 ERROR: tape list \fItapelist\fR: parse error
552 could not be read or parsed\&.
555 WARNING: tapedev is /dev/null, dumps will be thrown away
565 uses that when debugging to throw all the dump images away\&.
568 WARNING: hold file \FCfile\F[] exists
572 exists and will cause
574 to pause at the beginning until it is removed\&.
577 ERROR: holding disk \fIdisk\fR: statfs: \fIerror message\fR
579 (error) An error was returned from the
581 system call on holding disk
583 (maybe because it does not exist)\&.
586 ERROR: holding disk \fIdisk\fR: not writable
589 \fIdisk\fR, is not writable, probably because the caller does not have write permission or a parent directory does not allow search permission\&.
592 WARNING: holding disk \fIdisk\fR: available space unknown \fIN\fR KB requested\&.
596 could not determine the amount of available space on holding disk
598 to see if there were at least
603 WARNING: holding disk \fIdisk\fR: only \fIF\fR KB free (\fIR\fR KB requested)\&.
609 KBytes of free space on holding disk
612 KBytes were available\&. 10 MBytes is subtracted for each backup process (see the
615 option) to allow for unexpected overruns\&.
622 .nr an-no-space-flag 1
629 Even though this message is listed as a warning, it causes
631 to exit with a non\-zero status\&.
637 Holding disk \fIdisk\fR: \fIN\fR KB disk space available, that\'s plenty\&.
639 (info) There was sufficient free space on holding disk
643 WARNING: holding disk \fIdisk\fR: only \fIF\fR KB free, using nothing
645 (warning) Holding disk
649 KBytes of free space, but that is not enough for what is requested in
650 \fIamanda\&.conf\fR\&.
653 Holding disk \fIdisk\fR: \fIF\fR KB disk space available, using \fIU\fR KB
659 KBytes of free space and
666 WARNING: if a tape changer is not available, runtapes must be set to 1\&.
671 option must be set to 1 if the
677 ERROR: \fIerror message\fR\&.
679 (error) An error was detected while initializing the tape changer\&.
682 ERROR: \fItape device\fR: \fIerror message\fR\&.
684 (error) An error was detected while processing the tape label\&.
687 ERROR: cannot overwrite active tape \fIlabel\fR\&.
691 is still active and cannot be used\&.
694 ERROR: label \fIlabel\fR doesn\'t match labelstr \fIpattern\fR \&.
696 (error) The label on tape
704 (expecting a new tape)
706 (info) The tape is not OK and a new tape was expected\&.
709 (expecting tape \fIlabel\fR or a new tape)
711 (info) The tape is not OK and either tape
713 or a new tape was expected\&.
716 ERROR: tape \fIlabel\fR label ok, but is not writable\&.
720 is OK, but the write enable test failed\&.
723 Tape \fIlabel\fR is writable\&.
727 is OK and the write enable test succeeded\&.
730 NOTE: skipping tape\-writable test\&.
732 (info) The tape write test (see the
734 option) was not enabled\&.
737 WARNING: skipping tape test because amdump or amflush seem to be running, WARNING: if they are not, you must run amcleanup
739 (warning) It looked to
745 were running because a log file or amdump file exists\&. If they are not running, you probably need to run
747 to clear up a previous failure\&. Otherwise, you need to wait until they complete before running
748 \fBamcheck\fR\FC\&.\F[]
751 NOTE: skipping tape checks
753 (info) The tape tests are being skipped because you used the
755 command line option\&.
758 WARNING: \fIcompress\fR is not executable, server\-compression and indexing will not work
760 (warning) Compression program
762 is not executable, so compression on the tape server host and creating index files will not work\&.
765 Tape \fIlabel\fR label ok\&.
769 is OK for the next run\&.
772 Server check took \fIS\fR seconds\&.
774 (info) Reports how long the tape server host checks took\&.
777 ERROR: \fIhost\fR: could not resolve hostname
779 (error) Could not look up client hostname
783 Client check: \fIH\fR hosts checked in \fIS\fR seconds, \fIN\fR problems found\&.
785 (info) Reports the number of client hosts checked, how long it took and the number of errors detected\&.
788 WARNING: \fIhost\fR: selfcheck request timed out\&. Host down?
790 (warning) There was no response from
792 when trying to do the client checks\&. The host might really be down or it might not be configured properly\&.
795 ERROR: \fIhost\fR NAK: \fImessage\fR
799 reported a negative acknowledgment error of
801 to the status check request\&.
804 ERROR: \fIhost\fR NAK: [NAK parse failed]
808 could not parse the negative acknowledgment error from
809 \fIhost\fR\&. There might be an
811 version mismatch between the host running
817 ERROR: \fIhost\fR [mutual\-authentication failed]
819 (error) Kerberos authentication failed while contacting
823 ERROR: \fIhost\fR: \fImessage\fR
827 was reported by the status check on
832 The exit code of \fBamcheck\fR is one of:
841 : http://wiki.zmanda.com
844 \fBJames da Silva\fR <\&jds@amanda\&.org\&>
846 \fBStefan G\&. Weichinger\fR <\&sgw@amanda\&.org\&>