git.gag.com Git - debian/amanda/blob - man/amcheck.8

   1 .\"     Title: amcheck
   2 .\"    Author: James da Silva <jds@amanda.org>
   3 .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
   4 .\"      Date: 01/22/2009
   5 .\"    Manual: System Administration Commands
   6 .\"    Source: Amanda 2.6.1
   7 .\"  Language: English
   8 .\"
   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 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  16 .de toupper
  17 .tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ
  18 \\$*
  19 .tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz
  20 ..
  21 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  22 .\" SH-xref - format a cross-reference to an SH section
  23 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  24 .de SH-xref
  25 .ie n \{\
  26 .\}
  27 .toupper \\$*
  28 .el \{\
  29 \\$*
  30 .\}
  31 ..
  32 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  33 .\" SH - level-one heading that works better for non-TTY output
  34 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  35 .de1 SH
  36 .\" put an extra blank line of space above the head in non-TTY output
  37 .if t \{\
  38 .sp 1
  39 .\}
  40 .sp \\n[PD]u
  41 .nr an-level 1
  42 .set-an-margin
  43 .nr an-prevailing-indent \\n[IN]
  44 .fi
  45 .in \\n[an-margin]u
  46 .ti 0
  47 .HTML-TAG ".NH \\n[an-level]"
  48 .it 1 an-trap
  49 .nr an-no-space-flag 1
  50 .nr an-break-flag 1
  51 \." make the size of the head bigger
  52 .ps +3
  53 .ft B
  54 .ne (2v + 1u)
  55 .ie n \{\
  56 .\" if n (TTY output), use uppercase
  57 .toupper \\$*
  58 .\}
  59 .el \{\
  60 .nr an-break-flag 0
  61 .\" if not n (not TTY), use normal case (not uppercase)
  62 \\$1
  63 .in \\n[an-margin]u
  64 .ti 0
  65 .\" if not n (not TTY), put a border/line under subheading
  66 .sp -.6
  67 \l'\n(.lu'
  68 .\}
  69 ..
  70 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  71 .\" SS - level-two heading that works better for non-TTY output
  72 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  73 .de1 SS
  74 .sp \\n[PD]u
  75 .nr an-level 1
  76 .set-an-margin
  77 .nr an-prevailing-indent \\n[IN]
  78 .fi
  79 .in \\n[IN]u
  80 .ti \\n[SN]u
  81 .it 1 an-trap
  82 .nr an-no-space-flag 1
  83 .nr an-break-flag 1
  84 .ps \\n[PS-SS]u
  85 \." make the size of the head bigger
  86 .ps +2
  87 .ft B
  88 .ne (2v + 1u)
  89 .if \\n[.$] \&\\$*
  90 ..
  91 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  92 .\" BB/BE - put background/screen (filled box) around block of text
  93 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  94 .de BB
  95 .if t \{\
  96 .sp -.5
  97 .br
  98 .in +2n
  99 .ll -2n
 100 .gcolor red
 101 .di BX
 102 .\}
 103 ..
 104 .de EB
 105 .if t \{\
 106 .if "\\$2"adjust-for-leading-newline" \{\
 107 .sp -1
 108 .\}
 109 .br
 110 .di
 111 .in
 112 .ll
 113 .gcolor
 114 .nr BW \\n(.lu-\\n(.i
 115 .nr BH \\n(dn+.5v
 116 .ne \\n(BHu+.5v
 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[]
 119 .\}
 120 .el \{\
 121 \M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
 122 .\}
 123 .in 0
 124 .sp -.5v
 125 .nf
 126 .BX
 127 .in
 128 .sp .5v
 129 .fi
 130 .\}
 131 ..
 132 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 133 .\" BM/EM - put colored marker in margin next to block of text
 134 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 135 .de BM
 136 .if t \{\
 137 .br
 138 .ll -2n
 139 .gcolor red
 140 .di BX
 141 .\}
 142 ..
 143 .de EM
 144 .if t \{\
 145 .br
 146 .di
 147 .ll
 148 .gcolor
 149 .nr BH \\n(dn
 150 .ne \\n(BHu
 151 \M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[]
 152 .in 0
 153 .nf
 154 .BX
 155 .in
 156 .fi
 157 .\}
 158 ..
 159 .\" -----------------------------------------------------------------
 160 .\" * set default formatting
 161 .\" -----------------------------------------------------------------
 162 .\" disable hyphenation
 163 .nh
 164 .\" disable justification (adjust text to left margin only)
 165 .ad l
 166 .\" -----------------------------------------------------------------
 167 .\" * MAIN CONTENT STARTS HERE *
 168 .\" -----------------------------------------------------------------
 169 .SH "Name"
 170 amcheck \- run \fIAmanda\fR self\-checks
 171 .SH "Synopsis"
 172 .fam C
 173 .HP \w'\fBamcheck\fR\ 'u
 174 \fBamcheck\fR [\-am] [\-w] [\-sclt] [\-M\ \fIaddress\fR] \fIconfig\fR [\fIhost\fR\ [\fIdisk\fR...]...] [\-o\ \fIconfigoption\fR]...
 175 .fam
 176 .SH "DESCRIPTION"
 177 .PP
 178 \fBAmcheck\fR
 179 runs a number of self\-checks on both the
 180 \fIAmanda\fR
 181 tape server host and the
 182 \fIAmanda\fR
 183 client hosts\&.
 184 .PP
 185 On the tape server host,
 186 \fBamcheck\fR
 187 can go through the same tape checking used at the start of the nightly
 188 \fBamdump\fR
 189 run to verify the correct tape for the next run is mounted\&.
 190 .PP
 191 \fBAmcheck\fR
 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\&.
 193 .PP
 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\&.
 195 .PP
 196 See the
 197 \fBamanda\fR(8)
 198 man page for more details about
 199 \fIAmanda\fR\&.
 200 .SH "OPTIONS"
 201 .PP
 202 \fB\-s\fR
 203 .RS 4
 204 Run the tape server local and tape checks (same as
 205 \fB\-lt\fR)\&.
 206 .RE
 207 .PP
 208 \fB\-c\fR
 209 .RS 4
 210 Run the client host checks\&. Multiple specific clients can be checked by specifying the client name\&.
 211 .RE
 212 .PP
 213 \fB\-l\fR
 214 .RS 4
 215 Run the local tests (e\&.g\&. permissions) on the server host\&.
 216 .RE
 217 .PP
 218 \fB\-t\fR
 219 .RS 4
 220 Run the tape tests on the server host\&.
 221 .RE
 222 .PP
 223 \fB\-w\fR
 224 .RS 4
 225 Enables a DESTRUCTIVE check for write\-protection on the tape (which would otherwise cause the subsequent
 226 \fBamdump\fR
 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\&.
 228 .RE
 229 .PP
 230 \fB\-m\fR
 231 .RS 4
 232 Nothing is printed, but mail is sent if any errors are detected\&. The mail goes to the
 233 \fBmailto\fR
 234 address specified in the
 235 \fIamanda\&.conf\fR
 236 file or the
 237 \fIaddress\fR
 238 value if
 239 \fB\-M\fR
 240 is set\&.
 241 .RE
 242 .PP
 243 \fB\-a\fR
 244 .RS 4
 245 Like
 246 \fB\-m\fR
 247 but the mail is always sent\&.
 248 .RE
 249 .PP
 250 \fB\-M\fR \fIaddress\fR
 251 .RS 4
 252 Mail the report to
 253 \fIaddress\fR
 254 instead of the
 255 \fBmailto\fR
 256 value from
 257 \fIamanda\&.conf\fR\&. Implies
 258 \fB\-m\fR\&.
 259 .RE
 260 .PP
 261 \fIhost\fR [\fIdisk\fR]*
 262 .RS 4
 263 Specify the host and disk on which the command will work\&.
 264 .RE
 265 .PP
 266 \fB\-o\fR \fIconfigoption\fR
 267 .RS 4
 268 See the "\fBCONFIGURATION OVERRIDE\fR" section in
 269 \fBamanda\fR(8)\&.
 270 .RE
 271 .PP
 272 The default is
 273 \fB\-cs\fR\&.
 274 .SH "EXAMPLES"
 275 .PP
 276 In this example, both the tape server and client tests are run\&. The results are displayed on standard output\&.
 277 .nf
 278 % amcheck daily
 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\&.
 285
 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\&.
 292
 293 (brought to you by \fIAmanda\fR 2\&.5\&.0)
 294 .fi
 295 .PP
 296 In this example, if the line
 297 \fBmailto csd\-amanda\fR
 298 is in
 299 \fIamanda\&.conf\fR, mail will be sent to
 300 \fBcsd\-amanda\fR
 301 if the server check returns an error\&.
 302 .nf
 303 % amcheck \-s \-m daily
 304 .fi
 305 .SH "MESSAGES"
 306 .PP
 307 fatal slot \fIslot\fR: \fIerror message\fR
 308 .RS 4
 309 (error) The tape changer detected some kind of fatal error while trying to load slot
 310 \fIslot\fR\&.
 311 .RE
 312 .PP
 313 slot \fIslot\fR: \fIerror message\fR
 314 .RS 4
 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\&.
 317 .RE
 318 .PP
 319 slot \fIslot\fR: date \fIYYYYMMDD\fR label \fIlabel\fR (\fIresult\fR)
 320 .RS 4
 321 (info) Tape
 322 \fIlabel\fR
 323 in slot
 324 \fIslot\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
 327 \fIX\fR\&. The
 328 \fIresult\fR
 329 may be one of:
 330 .PP
 331 exact label match
 332 .RS 4
 333 This is the expected tape\&.
 334 .RE
 335 .PP
 336 no match
 337 .RS 4
 338 This label does not match the
 339 \fBlabelstr\fR
 340 pattern in
 341 \fIamanda\&.conf\fR\&. Tape scanning will continue\&.
 342 .RE
 343 .PP
 344 active tape
 345 .RS 4
 346 This tape is still active and cannot be overwritten\&. Tape scanning will continue\&.
 347 .RE
 348 .PP
 349 first labelstr match
 350 .RS 4
 351 This tape is the first one that matches the
 352 \fBlabelstr\fR
 353 pattern in
 354 \fIamanda\&.conf\fR\&. Tape scanning will continue if necessary\&.
 355 .RE
 356 .PP
 357 labelstr match
 358 .RS 4
 359 This tape is the next one that matches the
 360 \fBlabelstr\fR
 361 pattern in
 362 \fIamanda\&.conf\fR\&. Tape scanning will continue\&.
 363 .RE
 364 .sp
 365 .RE
 366 .PP
 367 ERROR: cannot look up dump user \fIuser\fR
 368 .RS 4
 369 (error) Dump user
 370 \fIuser\fR
 371 from
 372 \fIamanda\&.conf\fR
 373 could not be found in the system password information\&.
 374 .RE
 375 .PP
 376 ERROR: cannot look up my own uid (\fIuid\fR)
 377 .RS 4
 378 (error) User id
 379 \fIuid\fR
 380 running
 381 \fBamcheck\fR
 382 could not be found in the system password information\&.
 383 .RE
 384 .PP
 385 ERROR: running as user \fIrunuser\fR instead of \fIdumpuser\fR
 386 .RS 4
 387 (error)
 388 \fBAmcheck\fR
 389 should be run as the dump user
 390 \fIdumpuser\fR
 391 from
 392 \fIamanda\&.conf\fR
 393 instead of
 394 \fIrunuser\fR\&.
 395 .RE
 396 .PP
 397 ERROR: program dir \fIdirectory\fR: not accessible
 398 .RS 4
 399 (error) The directory
 400 \fIAmanda\fR
 401 expects to find its auxiliary programs in,
 402 \fIdirectory\fR, is not accessible\&.
 403 .RE
 404 .PP
 405 ERROR: program \fIprogram\fR: does not exist
 406 .RS 4
 407 (error) Program
 408 \fIprogram\fR
 409 needed on the tape server could not be found\&.
 410 .RE
 411 .PP
 412 ERROR: program \fIprogram\fR: not a file
 413 .RS 4
 414 (error) Program
 415 \fIprogram\fR
 416 needed on the tape server exists but is not a file\&.
 417 .RE
 418 .PP
 419 ERROR: program \fIprogram\fR: not executable
 420 .RS 4
 421 (error) Program
 422 \fIprogram\fR
 423 needed on the tape server exists but is not executable\&.
 424 .RE
 425 .PP
 426 WARNING: program \fIprogram\fR: not setuid\-root
 427 .RS 4
 428 (warning) Program
 429 \fIprogram\fR
 430 needed on the tape server exists but should be owned by user "root" and setuid\&.
 431 .RE
 432 .PP
 433 ERROR: \fIXXX\fR dir \fIdirectory\fR: not writable
 434 .RS 4
 435 (error) Directory
 436 \fIdirectory\fR
 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
 438 \fIXXX\fR
 439 may be:
 440 .PP
 441 log
 442 .RS 4
 443 for the
 444 \fIAmanda\fR
 445 log directory (see
 446 \fBlogdir\fR
 447 in
 448 \fBamanda\&.conf\fR)
 449 .RE
 450 .PP
 451 oldlog
 452 .RS 4
 453 for the directory that holds the old log files (see
 454 \fBlogdir\fR
 455 in
 456 \fBamanda\&.conf\fR)
 457 .RE
 458 .PP
 459 info
 460 .RS 4
 461 for an
 462 \fIAmanda\fR
 463 database information directory (see
 464 \fBcurinfo\fR
 465 in
 466 \fBamanda\&.conf\fR) or
 467 .RE
 468 .PP
 469 index
 470 .RS 4
 471 for an
 472 \fIAmanda\fR
 473 index directory (see
 474 \fBindexdir\fR
 475 in
 476 \fBamanda\&.conf\fR)
 477 .RE
 478 .PP
 479 tapelist
 480 .RS 4
 481 for the
 482 \fBtapelist\fR(5)
 483 .RE
 484 .sp
 485 .RE
 486 .PP
 487 NOTE: \fIXXX\fR dir \fIdirectory\fR: does not exist
 488 .RS 4
 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\&.
 490 .RE
 491 .PP
 492 NOTE: it will be created on the next run
 493 .RS 4
 494 (info) This indicates the info directory listed in the previous message will be created on the next run\&.
 495 .RE
 496 .PP
 497 ERROR: \fIXXX\fR dir \fIname\fR: not a directory
 498 .RS 4
 499 (error)
 500 \fBAmcheck\fR
 501 expected
 502 \fIname\fR
 503 to be a directory, but it is something else (e\&.g\&. file)\&.
 504 .RE
 505 .PP
 506 WARNING: info file \FCfile\F[]: does not exist
 507 .RS 4
 508 (warning) File
 509 \fIfile\fR
 510 does not exist in the text format database\&. Since the parent directories do exist, the file should already have been created\&.
 511 .RE
 512 .PP
 513 ERROR: info file \FCname\F[]: not a file
 514 .RS 4
 515 (error)
 516 \fBAmcheck\fR
 517 expected
 518 \fIname\fR
 519 to be a file, but it is something else (e\&.g\&. file)\&.
 520 .RE
 521 .PP
 522 ERROR: info file \FCfile\F[]: not readable
 523 .RS 4
 524 (error) The text format database file
 525 \fIfile\fR
 526 is not readable\&.
 527 .RE
 528 .PP
 529 ERROR: log file \FCfile\F[]: not writable
 530 .RS 4
 531 (error) Log file
 532 \fIfile\fR
 533 (file
 534 \fBlog\fR
 535 in
 536 \fBlogdir\fR
 537 from
 538 \fBamanda\&.conf\fR) is either not writable, or cannot be accessed, perhaps because a parent directory does not allow search permission\&.
 539 .RE
 540 .PP
 541 ERROR: tape list \fItapelist\fR: not writable
 542 .RS 4
 543 (error)
 544 \fBtapelist\fR(5)
 545 is not writable or was not found\&.
 546 .RE
 547 .PP
 548 ERROR: tape list \fItapelist\fR: parse error
 549 .RS 4
 550 (error)
 551 \fBtapelist\fR(5)
 552 could not be read or parsed\&.
 553 .RE
 554 .PP
 555 WARNING: tapedev is /dev/null, dumps will be thrown away
 556 .RS 4
 557 (warning) The
 558 \fBtapedev\fR
 559 parameter in
 560 \fBamanda\&.conf\fR
 561 is set to
 562 \FC/dev/null\F[]
 563 and
 564 \fIAmanda\fR
 565 uses that when debugging to throw all the dump images away\&.
 566 .RE
 567 .PP
 568 WARNING: hold file \FCfile\F[] exists
 569 .RS 4
 570 (info) Hold file
 571 \fIfile\fR
 572 exists and will cause
 573 \fBamdump\fR
 574 to pause at the beginning until it is removed\&.
 575 .RE
 576 .PP
 577 ERROR: holding disk \fIdisk\fR: statfs: \fIerror message\fR
 578 .RS 4
 579 (error) An error was returned from the
 580 \fIstatfs\fR
 581 system call on holding disk
 582 \fIdisk\fR
 583 (maybe because it does not exist)\&.
 584 .RE
 585 .PP
 586 ERROR: holding disk \fIdisk\fR: not writable
 587 .RS 4
 588 (error) Holding disk
 589 \fIdisk\fR, is not writable, probably because the caller does not have write permission or a parent directory does not allow search permission\&.
 590 .RE
 591 .PP
 592 WARNING: holding disk \fIdisk\fR: available space unknown \fIN\fR KB requested\&.
 593 .RS 4
 594 (warning)
 595 \fBAmcheck\fR
 596 could not determine the amount of available space on holding disk
 597 \fIdisk\fR
 598 to see if there were at least
 599 \fIN\fR
 600 KBytes available\&.
 601 .RE
 602 .PP
 603 WARNING: holding disk \fIdisk\fR: only \fIF\fR KB free (\fIR\fR KB requested)\&.
 604 .RS 4
 605 (warning)
 606 \fIamanda\&.conf\fR
 607 requested
 608 \fIR\fR
 609 KBytes of free space on holding disk
 610 \fIdisk\fR, but only
 611 \fIF\fR
 612 KBytes were available\&. 10 MBytes is subtracted for each backup process (see the
 613 \fBinparallel\fR
 614 \fIamanda\&.conf\fR
 615 option) to allow for unexpected overruns\&.
 616 .if n \{\
 617 .sp
 618 .\}
 619 .RS 4
 620 .BM yellow
 621 .it 1 an-trap
 622 .nr an-no-space-flag 1
 623 .nr an-break-flag 1
 624 .br
 625 .ps +1
 626 \fBNote\fR
 627 .ps -1
 628 .br
 629 Even though this message is listed as a warning, it causes
 630 \fBamcheck\fR
 631 to exit with a non\-zero status\&.
 632 .sp .5v
 633 .EM yellow
 634 .RE
 635 .RE
 636 .PP
 637 Holding disk \fIdisk\fR: \fIN\fR KB disk space available, that\'s plenty\&.
 638 .RS 4
 639 (info) There was sufficient free space on holding disk
 640 \fIdisk\fR\&.
 641 .RE
 642 .PP
 643 WARNING: holding disk \fIdisk\fR: only \fIF\fR KB free, using nothing
 644 .RS 4
 645 (warning) Holding disk
 646 \fIdisk\fR
 647 has
 648 \fIF\fR
 649 KBytes of free space, but that is not enough for what is requested in
 650 \fIamanda\&.conf\fR\&.
 651 .RE
 652 .PP
 653 Holding disk \fIdisk\fR: \fIF\fR KB disk space available, using \fIU\fR KB
 654 .RS 4
 655 (info) Holding disk
 656 \fIdisk\fR
 657 has
 658 \fIF\fR
 659 KBytes of free space and
 660 \fIAmanda\fR
 661 will be using up to
 662 \fIU\fR
 663 Kbytes\&.
 664 .RE
 665 .PP
 666 WARNING: if a tape changer is not available, runtapes must be set to 1\&.
 667 .RS 4
 668 (warning) The
 669 \fBruntapes\fR
 670 \fIamanda\&.conf\fR
 671 option must be set to 1 if the
 672 \fBtpchanger\fR
 673 \fIamanda\&.conf\fR
 674 option is not set\&.
 675 .RE
 676 .PP
 677 ERROR: \fIerror message\fR\&.
 678 .RS 4
 679 (error) An error was detected while initializing the tape changer\&.
 680 .RE
 681 .PP
 682 ERROR: \fItape device\fR: \fIerror message\fR\&.
 683 .RS 4
 684 (error) An error was detected while processing the tape label\&.
 685 .RE
 686 .PP
 687 ERROR: cannot overwrite active tape \fIlabel\fR\&.
 688 .RS 4
 689 (error) Tape
 690 \fIlabel\fR
 691 is still active and cannot be used\&.
 692 .RE
 693 .PP
 694 ERROR: label \fIlabel\fR doesn\'t match labelstr \fIpattern\fR \&.
 695 .RS 4
 696 (error) The label on tape
 697 \fIlabel\fR
 698 does not match the
 699 \fBlabelstr\fR
 700 \fIamanda\&.conf\fR
 701 option\&.
 702 .RE
 703 .PP
 704 (expecting a new tape)
 705 .RS 4
 706 (info) The tape is not OK and a new tape was expected\&.
 707 .RE
 708 .PP
 709 (expecting tape \fIlabel\fR or a new tape)
 710 .RS 4
 711 (info) The tape is not OK and either tape
 712 \fIlabel\fR
 713 or a new tape was expected\&.
 714 .RE
 715 .PP
 716 ERROR: tape \fIlabel\fR label ok, but is not writable\&.
 717 .RS 4
 718 (error) Tape
 719 \fIlabel\fR
 720 is OK, but the write enable test failed\&.
 721 .RE
 722 .PP
 723 Tape \fIlabel\fR is writable\&.
 724 .RS 4
 725 (info) Tape
 726 \fIlabel\fR
 727 is OK and the write enable test succeeded\&.
 728 .RE
 729 .PP
 730 NOTE: skipping tape\-writable test\&.
 731 .RS 4
 732 (info) The tape write test (see the
 733 \fB\-w\fR
 734 option) was not enabled\&.
 735 .RE
 736 .PP
 737 WARNING: skipping tape test because amdump or amflush seem to be running, WARNING: if they are not, you must run amcleanup
 738 .RS 4
 739 (warning) It looked to
 740 \fBamcheck\fR
 741 like either
 742 \fBamdump\fR
 743 or
 744 \fBamflush\fR
 745 were running because a log file or amdump file exists\&. If they are not running, you probably need to run
 746 \fBamcleanup\fR
 747 to clear up a previous failure\&. Otherwise, you need to wait until they complete before running
 748 \fBamcheck\fR\FC\&.\F[]
 749 .RE
 750 .PP
 751 NOTE: skipping tape checks
 752 .RS 4
 753 (info) The tape tests are being skipped because you used the
 754 \fB\-t\fR
 755 command line option\&.
 756 .RE
 757 .PP
 758 WARNING: \fIcompress\fR is not executable, server\-compression and indexing will not work
 759 .RS 4
 760 (warning) Compression program
 761 \fIcompress\fR
 762 is not executable, so compression on the tape server host and creating index files will not work\&.
 763 .RE
 764 .PP
 765 Tape \fIlabel\fR label ok\&.
 766 .RS 4
 767 (info) Tape
 768 \fIlabel\fR
 769 is OK for the next run\&.
 770 .RE
 771 .PP
 772 Server check took \fIS\fR seconds\&.
 773 .RS 4
 774 (info) Reports how long the tape server host checks took\&.
 775 .RE
 776 .PP
 777 ERROR: \fIhost\fR: could not resolve hostname
 778 .RS 4
 779 (error) Could not look up client hostname
 780 \fIhost\fR\&.
 781 .RE
 782 .PP
 783 Client check: \fIH\fR hosts checked in \fIS\fR seconds, \fIN\fR problems found\&.
 784 .RS 4
 785 (info) Reports the number of client hosts checked, how long it took and the number of errors detected\&.
 786 .RE
 787 .PP
 788 WARNING: \fIhost\fR: selfcheck request timed out\&. Host down?
 789 .RS 4
 790 (warning) There was no response from
 791 \fIhost\fR
 792 when trying to do the client checks\&. The host might really be down or it might not be configured properly\&.
 793 .RE
 794 .PP
 795 ERROR: \fIhost\fR NAK: \fImessage\fR
 796 .RS 4
 797 (error)
 798 \fIHost\fR
 799 reported a negative acknowledgment error of
 800 \fImessage\fR
 801 to the status check request\&.
 802 .RE
 803 .PP
 804 ERROR: \fIhost\fR NAK: [NAK parse failed]
 805 .RS 4
 806 (error)
 807 \fBAmcheck\fR
 808 could not parse the negative acknowledgment error from
 809 \fIhost\fR\&. There might be an
 810 \fIAmanda\fR
 811 version mismatch between the host running
 812 \fBamcheck\fR
 813 and
 814 \fIhost\fR\&.
 815 .RE
 816 .PP
 817 ERROR: \fIhost\fR [mutual\-authentication failed]
 818 .RS 4
 819 (error) Kerberos authentication failed while contacting
 820 \fIhost\fR\&.
 821 .RE
 822 .PP
 823 ERROR: \fIhost\fR: \fImessage\fR
 824 .RS 4
 825 (error) Error
 826 \fImessage\fR
 827 was reported by the status check on
 828 \fIhost\fR\&.
 829 .RE
 830 .SH "EXIT CODE"
 831
 832 The exit code of \fBamcheck\fR is one of:
 833 .nf
 834  0  = success
 835  1  = error
 836 .fi
 837 .SH "SEE ALSO"
 838 .PP
 839 \fBamanda\fR(8),
 840 \fBamdump\fR(8),
 841 : http://wiki.zmanda.com
 842 .SH "Authors"
 843 .PP
 844 \fBJames da Silva\fR <\&jds@amanda\&.org\&>
 845 .PP
 846 \fBStefan G\&. Weichinger\fR <\&sgw@amanda\&.org\&>