X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=docs%2Famcheck.8.txt;h=e69de29bb2d1d6434b8b29ae775ad8c2e48c5391;hb=d92f70685083588e2a7ce6bc312a735f6937b5a6;hp=f043cf959a35b8857e29276f5fd87aa612d55b57;hpb=6c1f39091444e58c33362f0cc086375d9d273e77;p=debian%2Famanda diff --git a/docs/amcheck.8.txt b/docs/amcheck.8.txt index f043cf9..e69de29 100644 --- a/docs/amcheck.8.txt +++ b/docs/amcheck.8.txt @@ -1,375 +0,0 @@ - - amcheck -Prev Chapter 36. The Amanda Manual Pages. Next - -------------------------------------------------------------------------------- - -Name - -amcheck  run Amanda self-checks - -Synopsis - -amcheck [-am] [-w] [-sclt] [-M address] config [ host [disk...] ...] [ - -o configoption]... - -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. - -OPTIONS - - - - -s - Run the tape server local and tape checks (same as -lt). - - -c - Run the client host checks. Multiple specific clients can be checked by - specifying the client name. - - -l - Run the local tests (e.g. permissions) on the server host. - - -t - Run the tape tests on the server host. - - -w - Enables a DESTRUCTIVE check for write-protection on the tape (which would - otherwise cause the subsequent amdump 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. - - -m - Nothing is printed, but mail is sent if any errors are detected. The mail - goes to the mailto address specified in the amanda.conf file or the - address value if -M is set. - - -a - Like -m but the mail is always sent. - - -M address - Mail the report to address instead of the mailto value from amanda.conf. - Implies -m. - - host [disk]* - Specify the host and disk on which the command will work. - - -o configoption - See the "CONFIGURATION OVERRIDE" section in amanda(8). - -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 - (error) The tape changer detected some kind of fatal error while trying - to load slot slot. - - slot slot: error message - (warning) The tape changer detected some kind of non-fatal error (e.g. an - empty slot was detected) while trying to load slot slot, or an error was - detected trying to read the tape label. - - slot slot: date YYYYMMDD label label (result) - (info) Tape label in slot slot was loaded and found to have been last - written on YYYYMMDD. If the tape is new, the date field will be an X. The - result may be one of: - - - exact label match - This is the expected tape. - - no match - This label does not match the labelstr pattern in amanda.conf. Tape - scanning will continue. - - active tape - This tape is still active and cannot be overwritten. Tape scanning - will continue. - - first labelstr match - This tape is the first one that matches the labelstr pattern in - amanda.conf. Tape scanning will continue if necessary. - - labelstr match - This tape is the next one that matches the labelstr pattern in - amanda.conf. Tape scanning will continue. - - - ERROR: cannot look up dump user user - (error) Dump user user from amanda.conf could not be found in the system - password information. - - ERROR: cannot look up my own uid (uid) - (error) User id uid running amcheck could not be found in the system - password information. - - ERROR: running as user runuser instead of dumpuser - (error) Amcheck should be run as the dump user dumpuser from amanda.conf - instead of runuser. - - ERROR: program dir directory: not accessible - (error) The directory Amanda expects to find its auxiliary programs in, - directory, is not accessible. - - ERROR: program program: does not exist - (error) Program program needed on the tape server could not be found. - - ERROR: program program: not a file - (error) Program program needed on the tape server exists but is not a - file. - - ERROR: program program: not executable - (error) Program program needed on the tape server exists but is not - executable. - - WARNING: program program: not setuid-root - (warning) Program program needed on the tape server exists but should be - owned by user "root" and setuid. - - ERROR: XXX dir directory: not writable - (error) Directory directory 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 - XXX may be: - - - log - for the Amanda log directory (see logdir in amanda.conf) - - oldlog - for the directory that holds the old log files (see logdir in - amanda.conf) - - info - for an Amanda database information directory (see curinfo in - amanda.conf) or - - index - for an Amanda index directory (see indexdir in amanda.conf) - - tapelist - for the Amanda tapelist directory (see tapelist in amanda.conf) - - - NOTE: XXX dir directory: does not exist - (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. - - NOTE: it will be created on the next run - (info) This indicates the info directory listed in the previous message - will be created on the next run. - - ERROR: XXX dir name: not a directory - (error) Amcheck expected name to be a directory, but it is something else - (e.g. file). - - WARNING: info file file: does not exist - (warning) File file does not exist in the text format database. Since the - parent directories do exist, the file should already have been created. - - ERROR: info file name: not a file - (error) Amcheck expected name to be a file, but it is something else - (e.g. file). - - ERROR: info file file: not readable - (error) The text format database file file is not readable. - - ERROR: log file file: not writable - (error) Log file file (file log in logdir from amanda.conf) is either not - writable, or cannot be accessed, perhaps because a parent directory does - not allow search permission. - - ERROR: tape list tapelist: not writable - (error) Amanda tape list file tapelist (see tapelist in amanda.conf) is - not writable or was not found. - - ERROR: tape list tapelist: parse error - (error) Amanda tape list file tapelist (see tapelist in amanda.conf) - could not be read or parsed. - - WARNING: tapedev is /dev/null, dumps will be thrown away - (warning) The tapedev parameter in amanda.conf is set to /dev/null and - Amanda uses that when debugging to throw all the dump images away. - - WARNING: hold file file exists - (info) Hold file file exists and will cause amdump to pause at the - beginning until it is removed. - - ERROR: holding disk disk: statfs: error message - (error) An error was returned from the statfs system call on holding disk - disk (maybe because it does not exist). - - ERROR: holding disk disk: not writable - (error) Holding disk disk, is not writable, probably because the caller - does not have write permission or a parent directory does not allow - search permission. - - WARNING: holding disk disk: available space unknown N KB requested. - (warning) Amcheck could not determine the amount of available space on - holding disk disk to see if there were at least N KBytes available. - - WARNING: holding disk disk: only F KB free (R KB requested). - (warning) amanda.conf requested R KBytes of free space on holding disk - disk, but only F KBytes were available. 10 MBytes is subtracted for each - backup process (see the inparallel amanda.conf option) to allow for - unexpected overruns. - - Note - - 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. - (info) There was sufficient free space on holding disk disk. - - WARNING: holding disk disk: only F KB free, using nothing - (warning) Holding disk disk has F KBytes of free space, but that is not - enough for what is requested in amanda.conf. - - Holding disk disk: F KB disk space available, using U KB - (info) Holding disk disk has F KBytes of free space and Amanda will be - using up to U Kbytes. - - WARNING: if a tape changer is not available, runtapes must be set to 1. - (warning) The runtapes amanda.conf option must be set to 1 if the - tpchanger amanda.conf option is not set. - - ERROR: error message. - (error) An error was detected while initializing the tape changer. - - ERROR: tape device: error message. - (error) An error was detected while processing the tape label. - - ERROR: cannot overwrite active tape label. - (error) Tape label is still active and cannot be used. - - ERROR: label label doesn't match labelstr pattern . - (error) The label on tape label does not match the labelstr amanda.conf - option. - - (expecting a new tape) - (info) The tape is not OK and a new tape was expected. - - (expecting tape label or a new tape) - (info) The tape is not OK and either tape label or a new tape was - expected. - - ERROR: tape label label ok, but is not writable. - (error) Tape label is OK, but the write enable test failed. - - Tape label is writable. - (info) Tape label is OK and the write enable test succeeded. - - NOTE: skipping tape-writable test. - (info) The tape write test (see the -w option) was not enabled. - - WARNING: skipping tape test because amdump or amflush seem to be running, - WARNING: if they are not, you must run amcleanup - (warning) It looked to amcheck like either amdump or amflush were running - because a log file or amdump file exists. If they are not running, you - probably need to run amcleanup to clear up a previous failure. Otherwise, - you need to wait until they complete before running amcheck. - - NOTE: skipping tape checks - (info) The tape tests are being skipped because you used the -t command - line option. - - WARNING: compress is not executable, server-compression and indexing will not - work - (warning) Compression program compress is not executable, so compression - on the tape server host and creating index files will not work. - - Tape label label ok. - (info) Tape label is OK for the next run. - - Server check took S seconds. - (info) Reports how long the tape server host checks took. - - ERROR: host: could not resolve hostname - (error) Could not look up client hostname host. - - Client check: H hosts checked in S seconds, N problems found. - (info) Reports the number of client hosts checked, how long it took and - the number of errors detected. - - WARNING: host: selfcheck request timed out. Host down? - (warning) There was no response from host when trying to do the client - checks. The host might really be down or it might not be configured - properly. - - ERROR: host NAK: message - (error) Host reported a negative acknowledgment error of message to the - status check request. - - ERROR: host NAK: [NAK parse failed] - (error) Amcheck could not parse the negative acknowledgment error from - host. There might be an Amanda version mismatch between the host running - amcheck and host. - - ERROR: host [mutual-authentication failed] - (error) Kerberos authentication failed while contacting host. - - ERROR: host: message - (error) Error message was reported by the status check on host. - - -AUTHOR - -James da Silva, : Original text -Stefan G. Weichinger, , maintainer of the Amanda-documentation: -XML-conversion - -SEE ALSO - -amanda(8), amdump(8) -------------------------------------------------------------------------------- - -Prev Up Next -amanda-client.conf Home amcheckdb -