X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=man%2Famcheck.8;h=d0286b246937fb29979230c7232523b76c3c222c;hb=b116e9366c7b2ea2c2eb53b0a13df4090e176235;hp=4483818789cf5a13b984bc18ac5b7681f1b71aa1;hpb=12179dea039515c06168c0037d048566a3f623de;p=debian%2Famanda diff --git a/man/amcheck.8 b/man/amcheck.8 index 4483818..d0286b2 100644 --- a/man/amcheck.8 +++ b/man/amcheck.8 @@ -1,555 +1,680 @@ -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "AMCHECK" 8 "" "" "" +'\" t +.\" Title: amcheck +.\" Author: James da Silva +.\" Generator: DocBook XSL Stylesheets vsnapshot_8273 +.\" Date: 10/18/2010 +.\" Manual: System Administration Commands +.\" Source: Amanda 3.2.0 +.\" Language: English +.\" +.TH "AMCHECK" "8" "10/18/2010" "Amanda 3\&.2\&.0" "System Administration Commands" +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- .SH "NAME" -amcheck - run Amanda self-checks +amcheck \- run Amanda self\-checks .SH "SYNOPSIS" -.HP 8 -\fBamcheck\fR [-am] [-w] [-sclt] [-M \fIaddress\fR]* - \fIconfig\fR [\fIhost\fR [\fIdisk\fR]*]* - [-o \fIconfigoption\fR]* - +.HP \w'\fBamcheck\fR\ 'u +\fBamcheck\fR [\-am] [\-w] [\-sclt] [\-M\ \fIaddress\fR] \fIconfig\fR [\fIhost\fR\ [\fIdisk\fR...]...] [\fB\-o\fR\ \fIconfigoption\fR...] .SH "DESCRIPTION" .PP \fBAmcheck\fR -runs a number of self-checks on both the -\fBAmanda\fR -tape server host and the -\fBAmanda\fR -client hosts. +runs a number of self\-checks on both the Amanda tape server host and the Amanda client hosts\&. .PP On the tape server host, \fBamcheck\fR can go through the same tape checking used at the start of the nightly \fBamdump\fR -run to verify the correct tape for the next run is mounted. +run to verify the correct tape for the next run is mounted\&. .PP \fBAmcheck\fR -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. +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\&. .PP -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. +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\&. .PP See the \fBamanda\fR(8) -man page for more details about -\fBAmanda\fR. +man page for more details about Amanda\&. .SH "OPTIONS" -.TP -\fB-s\fR +.PP +\fB\-s\fR +.RS 4 Run the tape server local and tape checks (same as -\fB-lt\fR). -.TP -\fB-c\fR -Run the client host checks.Multiple specific clients can be checked by specifying the client name. -.TP -\fB-l\fR -Run the local tests (e.g. permissions) on the server host. -.TP -\fB-t\fR -Run the tape tests on the server host. -.TP -\fB-w\fR -Enables a DESTRUCTIVE check for write-protection on the tape (which would otherwise cause the subsequent +\fB\-lt\fR)\&. +.RE +.PP +\fB\-c\fR +.RS 4 +Run the client host checks\&. Multiple specific clients can be checked by specifying the client name\&. +.RE +.PP +\fB\-l\fR +.RS 4 +Run the local tests (e\&.g\&. permissions) on the server host\&. +.RE +.PP +\fB\-t\fR +.RS 4 +Run the tape tests on the server host\&. +.RE +.PP +\fB\-w\fR +.RS 4 +Enables a DESTRUCTIVE check for write\-protection on the tape (which would otherwise cause the subsequent \fBamdump\fR -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. -.TP -\fB-m\fR -Nothing is printed, but mail is sent if any errors are detected. The mail goes to the +to fail)\&. If the tape is writable, this check causes all data after the tape label to be erased\&. If the +\fBautolabel\fR +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\&. +.RE +.PP +\fB\-m\fR +.RS 4 +Nothing is printed, but mail is sent if any errors are detected\&. The mail goes to the \fBmailto\fR address specified in the -\fBamanda.conf\fR +\fIamanda\&.conf\fR file or the -\fBaddress\fR +\fIaddress\fR value if -\fB-M\fR -is set. -.TP -\fB-a\fR +\fB\-M\fR +is set\&. +.RE +.PP +\fB\-a\fR +.RS 4 Like -\fB-m\fR -but the mail is always sent. -.TP -\fB-M\fR \fIaddress\fR +\fB\-m\fR +but the mail is always sent\&. +.RE +.PP +\fB\-M\fR \fIaddress\fR +.RS 4 Mail the report to -\fBaddress\fR +\fIaddress\fR instead of the \fBmailto\fR value from -\fBamanda.conf\fR. Implies -\fB-m\fR. -.TP +\fIamanda\&.conf\fR\&. Implies +\fB\-m\fR\&. +.RE +.PP \fIhost\fR [\fIdisk\fR]* -Specify the host and disk on which the command will work. -.TP -\fB-o\fR \fIconfigoption\fR -See the "\fBCONFIGURATION OVERWRITE\fR" section in -\fBamanda\fR(8). +.RS 4 +Specify the host and disk on which the command will work\&. +.RE +.PP +\fB\-o \fR\fB\fIconfigoption\fR\fR +.RS 4 +See the "CONFIGURATION OVERRIDE" section in +\fBamanda\fR(8)\&. +.RE .PP The default is -\fB-cs\fR. +\fB\-cs\fR\&. .SH "EXAMPLES" .PP -In this example, both the tape server and client tests are run. The results are displayed on standard output. +In this example, both the tape server and client tests are run\&. The results are displayed on standard output\&. .nf - % amcheck daily -\fBAmanda\fR 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 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\&. -\fBAmanda\fR 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. +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 \fBAmanda\fR 2.5.0) +(brought to you by Amanda 2\&.5\&.0) .fi .PP In this example, if the line -\fBmailto csd-amanda\fR +\fBmailto csd\-amanda\fR is in -\fBamanda.conf\fR, mail will be sent to -\fBcsd-amanda\fR -if the server check returns an error. +\fIamanda\&.conf\fR, mail will be sent to +\fBcsd\-amanda\fR +if the server check returns an error\&. .nf - -% amcheck -s -m daily +% amcheck \-s \-m daily .fi .SH "MESSAGES" -.TP -fatal slot \fBslot\fR: \fBerror message\fR +.PP +fatal slot \fIslot\fR: \fIerror message\fR +.RS 4 (error) The tape changer detected some kind of fatal error while trying to load slot -\fBslot\fR. -.TP -slot \fBslot\fR: \fBerror message\fR -(warning) The tape changer detected some kind of non-fatal error (e.g. an empty slot was detected) while trying to load slot -\fBslot\fR, or an error was detected trying to read the tape label. -.TP -slot \fBslot\fR: date \fBYYYYMMDD\fR label \fBlabel\fR (\fBresult\fR) +\fIslot\fR\&. +.RE +.PP +slot \fIslot\fR: \fIerror message\fR +.RS 4 +(warning) The tape changer detected some kind of non\-fatal error (e\&.g\&. an empty slot was detected) while trying to load slot +\fIslot\fR, or an error was detected trying to read the tape label\&. +.RE +.PP +slot \fIslot\fR: date \fIYYYYMMDD\fR label \fIlabel\fR (\fIresult\fR) +.RS 4 (info) Tape -\fBlabel\fR +\fIlabel\fR in slot -\fBslot\fR +\fIslot\fR was loaded and found to have been last written on -\fBYYYYMMDD\fR. If the tape is new, the date field will be an -\fBX\fR. The -\fBresult\fR +\fIYYYYMMDD\fR\&. If the tape is new, the date field will be an +\fIX\fR\&. The +\fIresult\fR may be one of: -.RS -.TP +.PP exact label match -This is the expected tape. -.TP +.RS 4 +This is the expected tape\&. +.RE +.PP no match +.RS 4 This label does not match the \fBlabelstr\fR pattern in -\fBamanda.conf\fR. Tape scanning will continue. -.TP +\fIamanda\&.conf\fR\&. Tape scanning will continue\&. +.RE +.PP active tape -This tape is still active and cannot be overwritten. Tape scanning will continue. -.TP +.RS 4 +This tape is still active and cannot be overwritten\&. Tape scanning will continue\&. +.RE +.PP first labelstr match +.RS 4 This tape is the first one that matches the \fBlabelstr\fR pattern in -\fBamanda.conf\fR. Tape scanning will continue if necessary. -.TP +\fIamanda\&.conf\fR\&. Tape scanning will continue if necessary\&. +.RE +.PP labelstr match +.RS 4 This tape is the next one that matches the \fBlabelstr\fR pattern in -\fBamanda.conf\fR. Tape scanning will continue. +\fIamanda\&.conf\fR\&. Tape scanning will continue\&. +.RE +.sp .RE -.IP -.TP -ERROR: cannot look up dump user \fBuser\fR +.PP +ERROR: cannot look up dump user \fIuser\fR +.RS 4 (error) Dump user -\fBuser\fR +\fIuser\fR from -\fBamanda.conf\fR -could not be found in the system password information. -.TP -ERROR: cannot look up my own uid (\fBuid\fR) +\fIamanda\&.conf\fR +could not be found in the system password information\&. +.RE +.PP +ERROR: cannot look up my own uid (\fIuid\fR) +.RS 4 (error) User id -\fBuid\fR +\fIuid\fR running \fBamcheck\fR -could not be found in the system password information. -.TP -ERROR: running as user \fBrunuser\fR instead of \fBdumpuser\fR +could not be found in the system password information\&. +.RE +.PP +ERROR: running as user \fIrunuser\fR instead of \fIdumpuser\fR +.RS 4 (error) \fBAmcheck\fR should be run as the dump user -\fBdumpuser\fR +\fIdumpuser\fR from -\fBamanda.conf\fR +\fIamanda\&.conf\fR instead of -\fBrunuser\fR. -.TP -ERROR: program dir \fBdirectory\fR: not accessible -(error) The directory -\fBAmanda\fR -expects to find its auxiliary programs in, -\fBdirectory\fR, is not accessible. -.TP -ERROR: program \fBprogram\fR: does not exist +\fIrunuser\fR\&. +.RE +.PP +ERROR: program dir \fIdirectory\fR: not accessible +.RS 4 +(error) The directory Amanda expects to find its auxiliary programs in, +\fIdirectory\fR, is not accessible\&. +.RE +.PP +ERROR: program \fIprogram\fR: does not exist +.RS 4 (error) Program -\fBprogram\fR -needed on the tape server could not be found. -.TP -ERROR: program \fBprogram\fR: not a file +\fIprogram\fR +needed on the tape server could not be found\&. +.RE +.PP +ERROR: program \fIprogram\fR: not a file +.RS 4 (error) Program -\fBprogram\fR -needed on the tape server exists but is not a file. -.TP -ERROR: program \fBprogram\fR: not executable +\fIprogram\fR +needed on the tape server exists but is not a file\&. +.RE +.PP +ERROR: program \fIprogram\fR: not executable +.RS 4 (error) Program -\fBprogram\fR -needed on the tape server exists but is not executable. -.TP -WARNING: program \fBprogram\fR: not setuid-root +\fIprogram\fR +needed on the tape server exists but is not executable\&. +.RE +.PP +WARNING: program \fIprogram\fR: not setuid\-root +.RS 4 (warning) Program -\fBprogram\fR -needed on the tape server exists but should be owned by user "root" and setuid. -.TP -ERROR: \fBXXX\fR dir \fBdirectory\fR: not writable +\fIprogram\fR +needed on the tape server exists but should be owned by user "root" and setuid\&. +.RE +.PP +ERROR: \fIXXX\fR dir \fIdirectory\fR: not writable +.RS 4 (error) Directory -\fBdirectory\fR -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 -\fBXXX\fR +\fIdirectory\fR +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 +\fIXXX\fR may be: -.RS -.TP +.PP log -for the -\fBAmanda\fR -log directory (see +.RS 4 +for the Amanda log directory (see \fBlogdir\fR in -\fBamanda.conf\fR) -.TP +\fBamanda\&.conf\fR) +.RE +.PP oldlog +.RS 4 for the directory that holds the old log files (see \fBlogdir\fR in -\fBamanda.conf\fR) -.TP +\fBamanda\&.conf\fR) +.RE +.PP info -for an -\fBAmanda\fR -database information directory (see +.RS 4 +for an Amanda database information directory (see \fBcurinfo\fR in -\fBamanda.conf\fR) or -.TP +\fBamanda\&.conf\fR) or +.RE +.PP index -for an -\fBAmanda\fR -index directory (see +.RS 4 +for an Amanda index directory (see \fBindexdir\fR in -\fBamanda.conf\fR) -.TP +\fBamanda\&.conf\fR) +.RE +.PP tapelist +.RS 4 for the -\fBAmanda\fR -tapelist directory (see -\fBtapelist\fR -in -\fBamanda.conf\fR) +\fBtapelist\fR(5) +.RE +.sp +.RE +.PP +NOTE: \fIXXX\fR dir \fIdirectory\fR: does not exist +.RS 4 +(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\&. .RE -.IP -.TP -NOTE: \fBXXX\fR dir \fBdirectory\fR: 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. -.TP +.PP 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. -.TP -ERROR: \fBXXX\fR dir \fBname\fR: not a directory +.RS 4 +(info) This indicates the info directory listed in the previous message will be created on the next run\&. +.RE +.PP +ERROR: \fIXXX\fR dir \fIname\fR: not a directory +.RS 4 (error) \fBAmcheck\fR expected -\fBname\fR -to be a directory, but it is something else (e.g. file). -.TP -WARNING: info file \fIfile\fR: does not exist +\fIname\fR +to be a directory, but it is something else (e\&.g\&. file)\&. +.RE +.PP +WARNING: info file file: does not exist +.RS 4 (warning) File -\fBfile\fR -does not exist in the text format database. Since the parent directories do exist, the file should already have been created. -.TP -ERROR: info file \fIname\fR: not a file +\fIfile\fR +does not exist in the text format database\&. Since the parent directories do exist, the file should already have been created\&. +.RE +.PP +ERROR: info file name: not a file +.RS 4 (error) \fBAmcheck\fR expected -\fBname\fR -to be a file, but it is something else (e.g. file). -.TP -ERROR: info file \fIfile\fR: not readable +\fIname\fR +to be a file, but it is something else (e\&.g\&. file)\&. +.RE +.PP +ERROR: info file file: not readable +.RS 4 (error) The text format database file -\fBfile\fR -is not readable. -.TP -ERROR: log file \fIfile\fR: not writable +\fIfile\fR +is not readable\&. +.RE +.PP +ERROR: log file file: not writable +.RS 4 (error) Log file -\fBfile\fR +\fIfile\fR (file \fBlog\fR in \fBlogdir\fR from -\fBamanda.conf\fR) is either not writable, or cannot be accessed, perhaps because a parent directory does not allow search permission. -.TP -ERROR: tape list \fBtapelist\fR: not writable +\fBamanda\&.conf\fR) is either not writable, or cannot be accessed, perhaps because a parent directory does not allow search permission\&. +.RE +.PP +ERROR: tape list \fItapelist\fR: not writable +.RS 4 (error) -\fBAmanda\fR -tape list file -\fBtapelist\fR -(see -\fBtapelist\fR -in -\fBamanda.conf\fR) is not writable or was not found. -.TP -ERROR: tape list \fBtapelist\fR: parse error +\fBtapelist\fR(5) +is not writable or was not found\&. +.RE +.PP +ERROR: tape list \fItapelist\fR: parse error +.RS 4 (error) -\fBAmanda\fR -tape list file -\fBtapelist\fR -(see -\fBtapelist\fR -in -\fBamanda.conf\fR) could not be read or parsed. -.TP +\fBtapelist\fR(5) +could not be read or parsed\&. +.RE +.PP WARNING: tapedev is /dev/null, dumps will be thrown away +.RS 4 (warning) The \fBtapedev\fR parameter in -\fBamanda.conf\fR +\fBamanda\&.conf\fR is set to -\fI/dev/null\fR -and -\fBAmanda\fR -uses that when debugging to throw all the dump images away. -.TP -WARNING: hold file \fIfile\fR exists +/dev/null +and Amanda uses that when debugging to throw all the dump images away\&. +.RE +.PP +WARNING: hold file file exists +.RS 4 (info) Hold file -\fBfile\fR +\fIfile\fR exists and will cause \fBamdump\fR -to pause at the beginning until it is removed. -.TP -ERROR: holding disk \fBdisk\fR: statfs: \fBerror message\fR +to pause at the beginning until it is removed\&. +.RE +.PP +ERROR: holding disk \fIdisk\fR: statfs: \fIerror message\fR +.RS 4 (error) An error was returned from the -\fBstatfs\fR +\fIstatfs\fR system call on holding disk -\fBdisk\fR -(maybe because it does not exist). -.TP -ERROR: holding disk \fBdisk\fR: not writable +\fIdisk\fR +(maybe because it does not exist)\&. +.RE +.PP +ERROR: holding disk \fIdisk\fR: not writable +.RS 4 (error) Holding disk -\fBdisk\fR, is not writable, probably because the caller does not have write permission or a parent directory does not allow search permission. -.TP -WARNING: holding disk \fBdisk\fR: available space unknown \fBN\fR KB requested. +\fIdisk\fR, is not writable, probably because the caller does not have write permission or a parent directory does not allow search permission\&. +.RE +.PP +WARNING: holding disk \fIdisk\fR: available space unknown \fIN\fR KB requested\&. +.RS 4 (warning) \fBAmcheck\fR could not determine the amount of available space on holding disk -\fBdisk\fR +\fIdisk\fR to see if there were at least -\fBN\fR -KBytes available. -.TP -WARNING: holding disk \fBdisk\fR: only \fBF\fR KB free (\fBR\fR KB requested). +\fIN\fR +KBytes available\&. +.RE +.PP +WARNING: holding disk \fIdisk\fR: only \fIF\fR KB free (\fIR\fR KB requested)\&. +.RS 4 (warning) -\fBamanda.conf\fR +\fIamanda\&.conf\fR requested -\fBR\fR +\fIR\fR KBytes of free space on holding disk -\fBdisk\fR, but only -\fBF\fR -KBytes were available. 10 MBytes is subtracted for each backup process (see the -\fBinparallel\fR\fBamanda.conf\fR -option) to allow for unexpected overruns. +\fIdisk\fR, but only +\fIF\fR +KBytes were available\&. 10 MBytes is subtracted for each backup process (see the +\fBinparallel\fR +\fIamanda\&.conf\fR +option) to allow for unexpected overruns\&. +.if n \{\ .sp +.\} +.RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br +.ps +1 \fBNote\fR -Even though this message is listed as a warning, it causes \fBamcheck\fR to exit with a non-zero status..TP -Holding disk \fBdisk\fR: \fBN\fR KB disk space available, that's plenty. +.ps -1 +.br +Even though this message is listed as a warning, it causes +\fBamcheck\fR +to exit with a non\-zero status\&. +.sp .5v +.RE +.RE +.PP +Holding disk \fIdisk\fR: \fIN\fR KB disk space available, that\'s plenty\&. +.RS 4 (info) There was sufficient free space on holding disk -\fBdisk\fR. -.TP -WARNING: holding disk \fBdisk\fR: only \fBF\fR KB free, using nothing +\fIdisk\fR\&. +.RE +.PP +WARNING: holding disk \fIdisk\fR: only \fIF\fR KB free, using nothing +.RS 4 (warning) Holding disk -\fBdisk\fR +\fIdisk\fR has -\fBF\fR +\fIF\fR KBytes of free space, but that is not enough for what is requested in -\fBamanda.conf\fR. -.TP -Holding disk \fBdisk\fR: \fBF\fR KB disk space available, using \fBU\fR KB +\fIamanda\&.conf\fR\&. +.RE +.PP +Holding disk \fIdisk\fR: \fIF\fR KB disk space available, using \fIU\fR KB +.RS 4 (info) Holding disk -\fBdisk\fR +\fIdisk\fR has -\fBF\fR -KBytes of free space and -\fBAmanda\fR -will be using up to -\fBU\fR -Kbytes. -.TP -WARNING: if a tape changer is not available, runtapes must be set to 1. +\fIF\fR +KBytes of free space and Amanda will be using up to +\fIU\fR +Kbytes\&. +.RE +.PP +WARNING: if a tape changer is not available, runtapes must be set to 1\&. +.RS 4 (warning) The -\fBruntapes\fR\fBamanda.conf\fR +\fBruntapes\fR +\fIamanda\&.conf\fR option must be set to 1 if the -\fBtpchanger\fR\fBamanda.conf\fR -option is not set. -.TP -ERROR: \fBerror message\fR. -(error) An error was detected while initializing the tape changer. -.TP -ERROR: \fBtape device\fR: \fBerror message\fR. -(error) An error was detected while processing the tape label. -.TP -ERROR: cannot overwrite active tape \fBlabel\fR. +\fBtpchanger\fR +\fIamanda\&.conf\fR +option is not set\&. +.RE +.PP +ERROR: \fIerror message\fR\&. +.RS 4 +(error) An error was detected while initializing the tape changer\&. +.RE +.PP +ERROR: \fItape device\fR: \fIerror message\fR\&. +.RS 4 +(error) An error was detected while processing the tape label\&. +.RE +.PP +ERROR: cannot overwrite active tape \fIlabel\fR\&. +.RS 4 (error) Tape -\fBlabel\fR -is still active and cannot be used. -.TP -ERROR: label \fBlabel\fR doesn't match labelstr \fBpattern\fR . +\fIlabel\fR +is still active and cannot be used\&. +.RE +.PP +ERROR: label \fIlabel\fR doesn\'t match labelstr \fIpattern\fR \&. +.RS 4 (error) The label on tape -\fBlabel\fR +\fIlabel\fR does not match the -\fBlabelstr\fR\fBamanda.conf\fR -option. -.TP +\fBlabelstr\fR +\fIamanda\&.conf\fR +option\&. +.RE +.PP (expecting a new tape) -(info) The tape is not OK and a new tape was expected. -.TP -(expecting tape \fBlabel\fR or a new tape) +.RS 4 +(info) The tape is not OK and a new tape was expected\&. +.RE +.PP +(expecting tape \fIlabel\fR or a new tape) +.RS 4 (info) The tape is not OK and either tape -\fBlabel\fR -or a new tape was expected. -.TP -ERROR: tape \fBlabel\fR label ok, but is not writable. +\fIlabel\fR +or a new tape was expected\&. +.RE +.PP +ERROR: tape \fIlabel\fR label ok, but is not writable\&. +.RS 4 (error) Tape -\fBlabel\fR -is OK, but the write enable test failed. -.TP -Tape \fBlabel\fR is writable. +\fIlabel\fR +is OK, but the write enable test failed\&. +.RE +.PP +Tape \fIlabel\fR is writable\&. +.RS 4 (info) Tape -\fBlabel\fR -is OK and the write enable test succeeded. -.TP -NOTE: skipping tape-writable test. +\fIlabel\fR +is OK and the write enable test succeeded\&. +.RE +.PP +NOTE: skipping tape\-writable test\&. +.RS 4 (info) The tape write test (see the -\fB-w\fR -option) was not enabled. -.TP +\fB\-w\fR +option) was not enabled\&. +.RE +.PP WARNING: skipping tape test because amdump or amflush seem to be running, WARNING: if they are not, you must run amcleanup +.RS 4 (warning) It looked to \fBamcheck\fR like either \fBamdump\fR or \fBamflush\fR -were running because a log file or amdump file exists. If they are not running, you probably need to run +were running because a log file or amdump file exists\&. If they are not running, you probably need to run \fBamcleanup\fR -to clear up a previous failure. Otherwise, you need to wait until they complete before running -\fBamcheck\fR. -.TP +to clear up a previous failure\&. Otherwise, you need to wait until they complete before running +\fBamcheck\fR\&. +.RE +.PP NOTE: skipping tape checks +.RS 4 (info) The tape tests are being skipped because you used the -\fB-t\fR -command line option. -.TP -WARNING: \fBcompress\fR is not executable, server-compression and indexing will not work +\fB\-t\fR +command line option\&. +.RE +.PP +WARNING: \fIcompress\fR is not executable, server\-compression and indexing will not work +.RS 4 (warning) Compression program -\fBcompress\fR -is not executable, so compression on the tape server host and creating index files will not work. -.TP -Tape \fBlabel\fR label ok. +\fIcompress\fR +is not executable, so compression on the tape server host and creating index files will not work\&. +.RE +.PP +Tape \fIlabel\fR label ok\&. +.RS 4 (info) Tape -\fBlabel\fR -is OK for the next run. -.TP -Server check took \fBS\fR seconds. -(info) Reports how long the tape server host checks took. -.TP -ERROR: \fBhost\fR: could not resolve hostname +\fIlabel\fR +is OK for the next run\&. +.RE +.PP +Server check took \fIS\fR seconds\&. +.RS 4 +(info) Reports how long the tape server host checks took\&. +.RE +.PP +ERROR: \fIhost\fR: could not resolve hostname +.RS 4 (error) Could not look up client hostname -\fBhost\fR. -.TP -Client check: \fBH\fR hosts checked in \fBS\fR seconds, \fBN\fR problems found. -(info) Reports the number of client hosts checked, how long it took and the number of errors detected. -.TP -WARNING: \fBhost\fR: selfcheck request timed out. Host down? +\fIhost\fR\&. +.RE +.PP +Client check: \fIH\fR hosts checked in \fIS\fR seconds, \fIN\fR problems found\&. +.RS 4 +(info) Reports the number of client hosts checked, how long it took and the number of errors detected\&. +.RE +.PP +WARNING: \fIhost\fR: selfcheck request timed out\&. Host down? +.RS 4 (warning) There was no response from -\fBhost\fR -when trying to do the client checks. The host might really be down or it might not be configured properly. -.TP -ERROR: \fBhost\fR NAK: \fBmessage\fR +\fIhost\fR +when trying to do the client checks\&. The host might really be down or it might not be configured properly\&. +.RE +.PP +ERROR: \fIhost\fR NAK: \fImessage\fR +.RS 4 (error) -\fBHost\fR +\fIHost\fR reported a negative acknowledgment error of -\fBmessage\fR -to the status check request. -.TP -ERROR: \fBhost\fR NAK: [NAK parse failed] +\fImessage\fR +to the status check request\&. +.RE +.PP +ERROR: \fIhost\fR NAK: [NAK parse failed] +.RS 4 (error) \fBAmcheck\fR could not parse the negative acknowledgment error from -\fBhost\fR. There might be an -\fBAmanda\fR -version mismatch between the host running +\fIhost\fR\&. There might be an Amanda version mismatch between the host running \fBamcheck\fR and -\fBhost\fR. -.TP -ERROR: \fBhost\fR [mutual-authentication failed] +\fIhost\fR\&. +.RE +.PP +ERROR: \fIhost\fR [mutual\-authentication failed] +.RS 4 (error) Kerberos authentication failed while contacting -\fBhost\fR. -.TP -ERROR: \fBhost\fR: \fBmessage\fR +\fIhost\fR\&. +.RE +.PP +ERROR: \fIhost\fR: \fImessage\fR +.RS 4 (error) Error -\fBmessage\fR +\fImessage\fR was reported by the status check on -\fBhost\fR. -.SH "AUTHOR" -.PP -James da Silva, - -: Original text -.PP -Stefan G. Weichinger, -, maintainer of the -\fBAmanda\fR-documentation: XML-conversion +\fIhost\fR\&. +.RE +.SH "EXIT CODE" + +The exit code of \fBamcheck\fR is one of: +.nf + 0 = success + 1 = error +.fi .SH "SEE ALSO" .PP \fBamanda\fR(8), +\fBamanda.conf\fR(5), \fBamdump\fR(8) - +.PP +The Amanda Wiki: +: http://wiki.zmanda.com/ +.SH "AUTHORS" +.PP +\fBJames da Silva\fR <\&jds@amanda\&.org\&> +.PP +\fBStefan G\&. Weichinger\fR <\&sgw@amanda\&.org\&>