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

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
   3                    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
   4 [
   5   <!-- entities files to use -->
   6   <!ENTITY % global_entities SYSTEM 'global.entities'>
   7   %global_entities;
   8 ]>
   9
  10 <!-- lifted from troff+man by doclifter -->
  11 <refentry id='amcheck.8'>
  12
  13 <refmeta>
  14 <refentrytitle>amcheck</refentrytitle>
  15 <manvolnum>8</manvolnum>
  16 &rmi.source;
  17 &rmi.version;
  18 &rmi.manual.8;
  19 </refmeta>
  20 <refnamediv>
  21 <refname>amcheck</refname>
  22 <refpurpose>run Amanda self-checks</refpurpose>
  23 </refnamediv>
  24 <refentryinfo>
  25 &author.jds;
  26 &author.sgw.xml;
  27 </refentryinfo>
  28 <!-- body begins here -->
  29 <refsynopsisdiv>
  30 <cmdsynopsis>
  31   <command>amcheck</command>
  32     <arg choice='opt'>-am</arg>
  33     <arg choice='opt'>-w</arg>
  34     <arg choice='opt'>-sclt</arg>
  35     <arg choice='opt'>-M <replaceable>address</replaceable></arg>
  36     <arg choice='opt'>--client-verbose</arg>
  37     &configoverride.synopsis;
  38     <arg choice='plain'><replaceable>config</replaceable></arg>
  39     <arg choice='opt' rep='repeat'>
  40        <arg choice='plain'><replaceable>host</replaceable></arg>
  41        <arg choice='opt' rep='repeat'><replaceable>disk</replaceable></arg>
  42     </arg>
  43 </cmdsynopsis>
  44 </refsynopsisdiv>
  45
  46
  47 <refsect1><title>DESCRIPTION</title>
  48 <para><emphasis remap='B'>Amcheck</emphasis>
  49 runs a number of self-checks on both the Amanda tape server host and
  50 the Amanda client hosts.</para>
  51
  52 <para>On the tape server host,
  53 <command>amcheck</command>
  54 can go through the same tape checking used at the start of the nightly
  55 <emphasis remap='B'>amdump</emphasis>
  56 run to verify the correct tape for the next run is mounted.</para>
  57
  58 <para><emphasis remap='B'>Amcheck</emphasis>
  59 can also do a self-check on all client hosts
  60 to make sure each host is running and that permissions
  61 on filesystems to be backed up are correct.</para>
  62
  63 <para>You can specify many host/disk expressions, only disks that
  64 match an expression will be checked. All disks are checked if no
  65 expressions are given.</para>
  66
  67 <para>See the
  68 <manref name="amanda" vol="8"/>
  69 man page for more details about Amanda.</para>
  70 </refsect1>
  71
  72 <refsect1><title>OPTIONS</title>
  73 <variablelist remap='TP'>
  74   <varlistentry>
  75   <term><option>-s</option></term>
  76   <listitem>
  77 <para>Run the tape server local and tape checks (same as
  78 <option>-lt</option>).</para>
  79   </listitem>
  80   </varlistentry>
  81   <varlistentry>
  82   <term><option>-c</option></term>
  83   <listitem>
  84 <para>Run the client host checks. Multiple specific clients can be
  85 checked by specifying the client name.</para>
  86   </listitem>
  87   </varlistentry>
  88   <varlistentry>
  89   <term><option>-l</option></term>
  90   <listitem>
  91 <para>Run the local tests (e.g. permissions) on the server host.</para>
  92   </listitem>
  93   </varlistentry>
  94   <varlistentry>
  95   <term><option>-t</option></term>
  96   <listitem>
  97 <para>Run the tape tests on the server host.</para>
  98   </listitem>
  99   </varlistentry>
 100   <varlistentry>
 101   <term><option>-w</option></term>
 102   <listitem>
 103 <para>Enables a DESTRUCTIVE check for write-protection on the
 104 tape (which would otherwise cause the subsequent
 105 <emphasis remap='B'>amdump</emphasis>
 106 to fail).
 107 If the tape
 108 is writable, this check causes all data after the tape label to be
 109 erased. If the <amkeyword>autolabel</amkeyword> option is enabled, this check may ERASE
 110 any non-Amanda tape in the drive or changer.
 111 The check enable the tape tests on the server host
 112 and is only made if the tape is otherwise correct.</para>
 113   </listitem>
 114   </varlistentry>
 115   <varlistentry>
 116   <term><option>-m</option></term>
 117   <listitem>
 118 <para>Nothing is printed, but mail is sent if any errors are detected.
 119 The mail goes to the
 120 <emphasis remap='B'>mailto</emphasis>
 121 address specified in the
 122 <emphasis remap='I'>amanda.conf</emphasis>
 123 file or the
 124 <emphasis remap='I'>address</emphasis>
 125 value if
 126 <option>-M</option>
 127 is set.</para>
 128   </listitem>
 129   </varlistentry>
 130   <varlistentry>
 131   <term><option>-a</option></term>
 132   <listitem>
 133 <para>Like
 134 <option>-m</option>
 135 but the mail is always sent.</para>
 136   </listitem>
 137   </varlistentry>
 138
 139   <varlistentry>
 140   <term><option>-M</option> <replaceable>address</replaceable></term>
 141   <listitem>
 142 <para>Mail the report to
 143 <emphasis remap='I'>address</emphasis>
 144 instead of the
 145 <emphasis remap='B'>mailto</emphasis>
 146 value from
 147 <emphasis remap='I'>amanda.conf</emphasis>.
 148 Implies
 149 <option>-m</option>.</para>
 150   </listitem>
 151   </varlistentry>
 152
 153   <varlistentry>
 154   <term><option>--client-verbose</option></term>
 155   <listitem>
 156 <para>Print all client messages.</para>
 157   </listitem>
 158   </varlistentry>
 159
 160   <varlistentry>
 161   <term><replaceable>host</replaceable> [<replaceable>disk</replaceable>]*</term>
 162   <listitem>
 163 <para>Specify the host and disk on which the command will work.</para>
 164   </listitem>
 165   </varlistentry>
 166
 167   &configoverride.varlistentry;
 168
 169 </variablelist>
 170
 171 <para>The default is
 172 <option>-cs</option>.</para>
 173 </refsect1>
 174
 175 <refsect1><title>EXAMPLES</title>
 176 <para>In this example, both the tape server and client tests are run.
 177 The results are displayed on standard output.</para>
 178
 179 <programlisting>
 180 % amcheck daily
 181 Amanda Tape Server Host Check
 182 -----------------------------
 183 /amanda2/amanda/work: 911475 KB disk space available, that's plenty.
 184 NOTE: skipping tape-writable test.
 185 Tape VOL10 label ok.
 186 Server check took 34.966 seconds.
 187
 188 Amanda Backup Client Hosts Check
 189 --------------------------------
 190 WARNING: northstar: selfcheck request timed out.  Host down?
 191 WARNING: drinkme: selfcheck request timed out.  Host down?
 192 WARNING: scruffy: selfcheck request timed out.  Host down?
 193 Client check: 136 hosts checked in 51.945 seconds, 3 problems found.
 194
 195 (brought to you by Amanda 2.5.0)
 196 </programlisting>
 197
 198 <para>In this example, if the line
 199 <emphasis remap='B'>mailto csd-amanda</emphasis>
 200 is in
 201 <emphasis remap='I'>amanda.conf</emphasis>,
 202 mail will be sent to
 203 <emphasis remap='B'>csd-amanda</emphasis>
 204 if the server check returns an error.</para>
 205
 206 <programlisting>
 207 % amcheck -s -m daily
 208 </programlisting>
 209 </refsect1>
 210
 211 <refsect1><title>MESSAGES</title>
 212 <variablelist remap='TP'>
 213   <varlistentry>
 214   <term>fatal slot <emphasis remap='I'>slot</emphasis>: <emphasis remap='I'>error message</emphasis></term>
 215   <listitem>
 216 <para>(error)
 217 The tape changer detected some kind of fatal error while trying to load slot
 218 <emphasis remap='I'>slot</emphasis>.</para>
 219   </listitem>
 220   </varlistentry>
 221   <varlistentry>
 222   <term>slot <emphasis remap='I'>slot</emphasis>: <emphasis remap='I'>error message</emphasis></term>
 223   <listitem>
 224 <para>(warning)
 225 The tape changer detected some kind of non-fatal error
 226 (e.g. an empty slot was detected)
 227 while trying to load slot
 228 <emphasis remap='I'>slot</emphasis>,
 229 or an error was detected trying to read the tape label.</para>
 230   </listitem>
 231   </varlistentry>
 232   <varlistentry>
 233   <term>slot <emphasis remap='I'>slot</emphasis>: date <emphasis remap='I'>YYYYMMDD</emphasis> label <emphasis remap='I'>label</emphasis> (<emphasis remap='I'>result</emphasis>)</term>
 234   <listitem>
 235 <para>(info)
 236 Tape
 237 <emphasis remap='I'>label</emphasis>
 238 in slot
 239 <emphasis remap='I'>slot</emphasis>
 240 was loaded and found to have been last written on
 241 <emphasis remap='I'>YYYYMMDD</emphasis>.
 242 If the tape is new, the date field will be an
 243 <emphasis remap='I'>X</emphasis>.
 244 The
 245 <emphasis remap='I'>result</emphasis>
 246 may be one of:</para>
 247   <!-- .RS -->
 248     <variablelist remap='TP'>
 249       <varlistentry>
 250       <term>exact label match</term>
 251       <listitem>
 252 <para>This is the expected tape.</para>
 253       </listitem>
 254       </varlistentry>
 255       <varlistentry>
 256       <term>no match</term>
 257       <listitem>
 258 <para>This label does not match the
 259 <emphasis remap='B'>labelstr</emphasis>
 260 pattern in
 261 <emphasis remap='I'>amanda.conf</emphasis>.
 262 Tape scanning will continue.</para>
 263       </listitem>
 264       </varlistentry>
 265       <varlistentry>
 266       <term>active tape</term>
 267       <listitem>
 268 <para>This tape is still active and cannot be overwritten.
 269 Tape scanning will continue.</para>
 270       </listitem>
 271       </varlistentry>
 272       <varlistentry>
 273       <term>first labelstr match</term>
 274       <listitem>
 275 <para>This tape is the first one that matches the
 276 <emphasis remap='B'>labelstr</emphasis>
 277 pattern in
 278 <emphasis remap='I'>amanda.conf</emphasis>.
 279 Tape scanning will continue if necessary.</para>
 280       </listitem>
 281       </varlistentry>
 282       <varlistentry>
 283       <term>labelstr match</term>
 284       <listitem>
 285 <para>This tape is the next one that matches the
 286 <emphasis remap='B'>labelstr</emphasis>
 287 pattern in
 288 <emphasis remap='I'>amanda.conf</emphasis>.
 289 Tape scanning will continue.</para>
 290       </listitem>
 291       </varlistentry>
 292     </variablelist>
 293   <!-- .RE -->
 294   </listitem>
 295   </varlistentry>
 296   <varlistentry>
 297   <term>ERROR: cannot look up dump user <emphasis remap='I'>user</emphasis></term>
 298   <listitem>
 299 <para>(error)
 300 Dump user
 301 <emphasis remap='I'>user</emphasis>
 302 from
 303 <emphasis remap='I'>amanda.conf</emphasis>
 304 could not be found in the system password information.</para>
 305   </listitem>
 306   </varlistentry>
 307   <varlistentry>
 308   <term>ERROR: cannot look up my own uid (<emphasis remap='I'>uid</emphasis>)</term>
 309   <listitem>
 310 <para>(error)
 311 User id
 312 <emphasis remap='I'>uid</emphasis>
 313 running
 314 <command>amcheck</command>
 315 could not be found in the system password information.</para>
 316   </listitem>
 317   </varlistentry>
 318   <varlistentry>
 319   <term>ERROR: running as user <emphasis remap='I'>runuser</emphasis> instead of <emphasis remap='I'>dumpuser</emphasis></term>
 320   <listitem>
 321 <para>(error)
 322 <emphasis remap='B'>Amcheck</emphasis>
 323 should be run as the dump user
 324 <emphasis remap='I'>dumpuser</emphasis>
 325 from
 326 <emphasis remap='I'>amanda.conf</emphasis>
 327 instead of
 328 <emphasis remap='I'>runuser</emphasis>.</para>
 329   </listitem>
 330   </varlistentry>
 331   <varlistentry>
 332   <term>ERROR: program dir <emphasis remap='I'>directory</emphasis>: not accessible</term>
 333   <listitem>
 334 <para>(error)
 335 The directory Amanda expects to find its auxiliary programs in,
 336 <emphasis remap='I'>directory</emphasis>,
 337 is not accessible.</para>
 338   </listitem>
 339   </varlistentry>
 340   <varlistentry>
 341   <term>ERROR: program <emphasis remap='I'>program</emphasis>: does not exist</term>
 342   <listitem>
 343 <para>(error)
 344 Program
 345 <emphasis remap='I'>program</emphasis>
 346 needed on the tape server could not be found.</para>
 347   </listitem>
 348   </varlistentry>
 349   <varlistentry>
 350   <term>ERROR: program <emphasis remap='I'>program</emphasis>: not a file</term>
 351   <listitem>
 352 <para>(error)
 353 Program
 354 <emphasis remap='I'>program</emphasis>
 355 needed on the tape server exists but is not a file.</para>
 356   </listitem>
 357   </varlistentry>
 358   <varlistentry>
 359   <term>ERROR: program <emphasis remap='I'>program</emphasis>: not executable</term>
 360   <listitem>
 361 <para>(error)
 362 Program
 363 <emphasis remap='I'>program</emphasis>
 364 needed on the tape server exists but is not executable.</para>
 365   </listitem>
 366   </varlistentry>
 367   <varlistentry>
 368   <term>WARNING: program <emphasis remap='I'>program</emphasis>: not setuid-root</term>
 369   <listitem>
 370 <para>(warning)
 371 Program
 372 <emphasis remap='I'>program</emphasis>
 373 needed on the tape server exists but should be owned by user &quot;root&quot;
 374 and setuid.</para>
 375   </listitem>
 376   </varlistentry>
 377   <varlistentry>
 378   <term>ERROR: <emphasis remap='I'>XXX</emphasis> dir <emphasis remap='I'>directory</emphasis>: not writable</term>
 379   <listitem>
 380 <para>(error)
 381 Directory
 382 <emphasis remap='I'>directory</emphasis>
 383 is either not writable,
 384 i.e. the dump user will not be able to create or remove files,
 385 or cannot be accessed, perhaps because a parent directory
 386 does not allow search permission.
 387 The
 388 <emphasis remap='I'>XXX</emphasis>
 389 may be:</para>
 390   <!-- .RS -->
 391     <variablelist remap='TP'>
 392       <varlistentry>
 393       <term>log</term>
 394       <listitem>
 395 <para>for the Amanda log directory (see
 396 <emphasis remap='B'>logdir</emphasis>
 397 in
 398 <emphasis remap='B'>amanda.conf</emphasis>)</para>
 399       </listitem>
 400       </varlistentry>
 401       <varlistentry>
 402       <term>oldlog</term>
 403       <listitem>
 404 <para>for the directory that holds the old log files (see
 405 <emphasis remap='B'>logdir</emphasis>
 406 in
 407 <emphasis remap='B'>amanda.conf</emphasis>)</para>
 408       </listitem>
 409       </varlistentry>
 410       <varlistentry>
 411       <term>info</term>
 412       <listitem>
 413 <para>for an Amanda database information directory (see
 414 <emphasis remap='B'>curinfo</emphasis>
 415 in
 416 <emphasis remap='B'>amanda.conf</emphasis>)
 417 or</para>
 418       </listitem>
 419       </varlistentry>
 420       <varlistentry>
 421       <term>index</term>
 422       <listitem>
 423 <para>for an Amanda index directory (see
 424 <emphasis remap='B'>indexdir</emphasis>
 425 in
 426 <emphasis remap='B'>amanda.conf</emphasis>)</para>
 427       </listitem>
 428       </varlistentry>
 429       <varlistentry>
 430       <term>tapelist</term>
 431       <listitem>
 432 <para>for the &tapelist;</para>
 433       </listitem>
 434       </varlistentry>
 435     </variablelist>
 436   <!-- .RE -->
 437   </listitem>
 438   </varlistentry>
 439   <varlistentry>
 440   <term>NOTE: <emphasis remap='I'>XXX</emphasis> dir <emphasis remap='I'>directory</emphasis>: does not exist</term>
 441   <listitem>
 442 <para>(info)
 443 A database (info) or index directory does not exist or cannot be accessed.
 444 This might just mean this is a new client or disk,
 445 but if that is not the case, this should be treated as an error.</para>
 446   </listitem>
 447   </varlistentry>
 448   <varlistentry>
 449   <term>NOTE: it will be created on the next run</term>
 450   <listitem>
 451 <para>(info)
 452 This indicates the info directory listed in the previous message
 453 will be created on the next run.</para>
 454   </listitem>
 455   </varlistentry>
 456   <varlistentry>
 457   <term>ERROR: <emphasis remap='I'>XXX</emphasis> dir <emphasis remap='I'>name</emphasis>: not a directory</term>
 458   <listitem>
 459 <para>(error)
 460 <emphasis remap='B'>Amcheck</emphasis>
 461 expected
 462 <emphasis remap='I'>name</emphasis>
 463 to be a directory,
 464 but it is something else (e.g. file).</para>
 465   </listitem>
 466   </varlistentry>
 467   <varlistentry>
 468   <term>WARNING: info file <filename>file</filename>: does not exist</term>
 469   <listitem>
 470 <para>(warning)
 471 File
 472 <emphasis remap='I'>file</emphasis>
 473 does not exist in the text format database.
 474 Since the parent directories do exist,
 475 the file should already have been created.</para>
 476   </listitem>
 477   </varlistentry>
 478   <varlistentry>
 479   <term>ERROR: info file <filename>name</filename>: not a file</term>
 480   <listitem>
 481 <para>(error)
 482 <emphasis remap='B'>Amcheck</emphasis>
 483 expected
 484 <emphasis remap='I'>name</emphasis>
 485 to be a file,
 486 but it is something else (e.g. file).</para>
 487   </listitem>
 488   </varlistentry>
 489   <varlistentry>
 490   <term>ERROR: info file <filename>file</filename>: not readable</term>
 491   <listitem>
 492 <para>(error)
 493 The text format database file
 494 <emphasis remap='I'>file</emphasis>
 495 is not readable.</para>
 496   </listitem>
 497   </varlistentry>
 498   <varlistentry>
 499   <term>ERROR: log file <filename>file</filename>: not writable</term>
 500   <listitem>
 501 <para>(error)
 502 Log file
 503 <emphasis remap='I'>file</emphasis>
 504 (file
 505 <emphasis remap='B'>log</emphasis>
 506 in
 507 <emphasis remap='B'>logdir</emphasis>
 508 from
 509 <emphasis remap='B'>amanda.conf</emphasis>)
 510 is either not writable,
 511 or cannot be accessed, perhaps because a parent directory
 512 does not allow search permission.</para>
 513   </listitem>
 514   </varlistentry>
 515   <varlistentry>
 516   <term>ERROR: tape list <emphasis remap='I'>tapelist</emphasis>: not writable</term>
 517   <listitem>
 518 <para>(error) &tapelist; is not writable or was not found.</para>
 519   </listitem>
 520   </varlistentry>
 521   <varlistentry>
 522   <term>ERROR: tape list <emphasis remap='I'>tapelist</emphasis>: parse error</term>
 523   <listitem>
 524 <para>(error) &tapelist; could not be read or parsed.</para>
 525   </listitem>
 526   </varlistentry>
 527   <varlistentry>
 528   <term>WARNING: tapedev is /dev/null, dumps will be thrown away</term>
 529   <listitem>
 530 <para>(warning)
 531 The
 532 <emphasis remap='B'>tapedev</emphasis>
 533 parameter in
 534 <emphasis remap='B'>amanda.conf</emphasis>
 535 is set to
 536 <filename>/dev/null</filename>
 537 and Amanda uses that when debugging to throw all the dump images away.</para>
 538   </listitem>
 539   </varlistentry>
 540   <varlistentry>
 541   <term>WARNING: hold file <filename>file</filename> exists</term>
 542   <listitem>
 543 <para>(info)
 544 Hold file
 545 <emphasis remap='I'>file</emphasis>
 546 exists and will cause
 547 <emphasis remap='B'>amdump</emphasis>
 548 to pause at the beginning until it is removed.</para>
 549   </listitem>
 550   </varlistentry>
 551   <varlistentry>
 552   <term>ERROR: holding disk <emphasis remap='I'>disk</emphasis>: statfs: <emphasis remap='I'>error message</emphasis></term>
 553   <listitem>
 554 <para>(error)
 555 An error was returned from the
 556 <emphasis remap='I'>statfs</emphasis>
 557 system call on holding disk
 558 <emphasis remap='I'>disk</emphasis>
 559 (maybe because it does not exist).</para>
 560   </listitem>
 561   </varlistentry>
 562   <varlistentry>
 563   <term>ERROR: holding disk <emphasis remap='I'>disk</emphasis>: not writable</term>
 564   <listitem>
 565 <para>(error)
 566 Holding disk
 567 <emphasis remap='I'>disk</emphasis>,
 568 is not writable,
 569 probably because the caller does not have write permission
 570 or a parent directory does not allow search permission.</para>
 571   </listitem>
 572   </varlistentry>
 573   <varlistentry>
 574   <term>WARNING: holding disk <emphasis remap='I'>disk</emphasis>: available space unknown <emphasis remap='I'>N</emphasis> KB requested.</term>
 575   <listitem>
 576 <para>(warning)
 577 <emphasis remap='B'>Amcheck</emphasis>
 578 could not determine the amount of available space on holding disk
 579 <emphasis remap='I'>disk</emphasis>
 580 to see if there were at least
 581 <emphasis remap='I'>N</emphasis>
 582 KBytes available.</para>
 583   </listitem>
 584   </varlistentry>
 585   <varlistentry>
 586   <term>WARNING: holding disk <emphasis remap='I'>disk</emphasis>: only <emphasis remap='I'>F</emphasis> KB free (<emphasis remap='I'>R</emphasis> KB requested).</term>
 587   <listitem>
 588 <para>(warning)
 589 <emphasis remap='I'>amanda.conf</emphasis>
 590 requested
 591 <emphasis remap='I'>R</emphasis>
 592 KBytes of free space on holding disk
 593 <emphasis remap='I'>disk</emphasis>,
 594 but only
 595 <emphasis remap='I'>F</emphasis>
 596 KBytes were available.
 597 10 MBytes is subtracted for each backup process
 598 (see the
 599 <emphasis remap='B'>inparallel</emphasis>
 600 <emphasis remap='I'>amanda.conf</emphasis>
 601 option)
 602 to allow for unexpected overruns.</para>
 603 <note><para>Even though this message is listed as a warning, it causes &amcheck; to exit with a non-zero status.</para>
 604 </note>
 605   </listitem>
 606   </varlistentry>
 607 </variablelist>
 608
 609 <variablelist remap='TP'>
 610   <varlistentry>
 611   <term>Holding disk <emphasis remap='I'>disk</emphasis>: <emphasis remap='I'>N</emphasis> KB disk space available, that's plenty.</term>
 612   <listitem>
 613 <para>(info)
 614 There was sufficient free space on holding disk
 615 <emphasis remap='I'>disk</emphasis>.</para>
 616   </listitem>
 617   </varlistentry>
 618   <varlistentry>
 619   <term>WARNING: holding disk <emphasis remap='I'>disk</emphasis>: only <emphasis remap='I'>F</emphasis> KB free, using nothing</term>
 620   <listitem>
 621 <para>(warning)
 622 Holding disk
 623 <emphasis remap='I'>disk</emphasis>
 624 has
 625 <emphasis remap='I'>F</emphasis>
 626 KBytes of free space, but that is not enough for what is requested in
 627 <emphasis remap='I'>amanda.conf</emphasis>.</para>
 628   </listitem>
 629   </varlistentry>
 630   <varlistentry>
 631   <term>Holding disk <emphasis remap='I'>disk</emphasis>: <emphasis remap='I'>F</emphasis> KB disk space available, using <emphasis remap='I'>U</emphasis> KB</term>
 632   <listitem>
 633 <para>(info)
 634 Holding disk
 635 <emphasis remap='I'>disk</emphasis>
 636 has
 637 <emphasis remap='I'>F</emphasis>
 638 KBytes of free space and Amanda will be using up to
 639 <emphasis remap='I'>U</emphasis>
 640 Kbytes.</para>
 641   </listitem>
 642   </varlistentry>
 643   <varlistentry>
 644   <term>WARNING: if a tape changer is not available, runtapes must be set to 1.</term>
 645   <listitem>
 646 <para>(warning)
 647 The
 648 <emphasis remap='B'>runtapes</emphasis>
 649 <emphasis remap='I'>amanda.conf</emphasis>
 650 option must be set to 1 if the
 651 <emphasis remap='B'>tpchanger</emphasis>
 652 <emphasis remap='I'>amanda.conf</emphasis>
 653 option is not set.</para>
 654   </listitem>
 655   </varlistentry>
 656   <varlistentry>
 657   <term>ERROR: <emphasis remap='I'>error message</emphasis>.</term>
 658   <listitem>
 659 <para>(error)
 660 An error was detected while initializing the tape changer.</para>
 661   </listitem>
 662   </varlistentry>
 663   <varlistentry>
 664   <term>ERROR: <emphasis remap='I'>tape device</emphasis>: <emphasis remap='I'>error message</emphasis>.</term>
 665   <listitem>
 666 <para>(error)
 667 An error was detected while processing the tape label.</para>
 668   </listitem>
 669   </varlistentry>
 670   <varlistentry>
 671   <term>ERROR: cannot overwrite active tape <emphasis remap='I'>label</emphasis>.</term>
 672   <listitem>
 673 <para>(error)
 674 Tape
 675 <emphasis remap='I'>label</emphasis>
 676 is still active and cannot be used.</para>
 677   </listitem>
 678   </varlistentry>
 679   <varlistentry>
 680   <term>ERROR: label <emphasis remap='I'>label</emphasis> doesn't match labelstr <emphasis remap='I'>pattern</emphasis> .</term>
 681   <listitem>
 682 <para>(error)
 683 The label on tape
 684 <emphasis remap='I'>label</emphasis>
 685 does not match the
 686 <emphasis remap='B'>labelstr</emphasis>
 687 <emphasis remap='I'>amanda.conf</emphasis>
 688 option.</para>
 689   </listitem>
 690   </varlistentry>
 691   <varlistentry>
 692   <term>(expecting a new tape)</term>
 693   <listitem>
 694 <para>(info)
 695 The tape is not OK and a new tape was expected.</para>
 696   </listitem>
 697   </varlistentry>
 698   <varlistentry>
 699   <term>(expecting tape <emphasis remap='I'>label</emphasis> or a new tape)</term>
 700   <listitem>
 701 <para>(info)
 702 The tape is not OK and either tape
 703 <emphasis remap='I'>label</emphasis>
 704 or a new tape was expected.</para>
 705   </listitem>
 706   </varlistentry>
 707   <varlistentry>
 708   <term>ERROR: tape <emphasis remap='I'>label</emphasis> label ok, but is not writable.</term>
 709   <listitem>
 710 <para>(error)
 711 Tape
 712 <emphasis remap='I'>label</emphasis>
 713 is OK, but the write enable test failed.</para>
 714   </listitem>
 715   </varlistentry>
 716   <varlistentry>
 717   <term>Tape <emphasis remap='I'>label</emphasis> is writable.</term>
 718   <listitem>
 719 <para>(info)
 720 Tape
 721 <emphasis remap='I'>label</emphasis>
 722 is OK and the write enable test succeeded.</para>
 723   </listitem>
 724   </varlistentry>
 725   <varlistentry>
 726   <term>NOTE: skipping tape-writable test.</term>
 727   <listitem>
 728 <para>(info)
 729 The tape write test (see the
 730 <option>-w</option>
 731 option) was not enabled.</para>
 732   </listitem>
 733   </varlistentry>
 734   <varlistentry>
 735   <term>WARNING: skipping tape test because amdump or amflush seem to be running</term>
 736   <term>WARNING: if they are not, you must run amcleanup</term>
 737   <listitem>
 738 <para>(warning)
 739 It looked to
 740 <command>amcheck</command>
 741 like either
 742 <emphasis remap='B'>amdump</emphasis>
 743 or
 744 <emphasis remap='B'>amflush</emphasis>
 745 were running because a log file or amdump file exists.
 746 If they are not running, you probably need to run
 747 <emphasis remap='B'>amcleanup</emphasis>
 748 to clear up a previous failure.
 749 Otherwise, you need to wait until they complete before running
 750 <command>amcheck</command><literal>.</literal></para>
 751   </listitem>
 752   </varlistentry>
 753   <varlistentry>
 754   <term>NOTE: skipping tape checks</term>
 755   <listitem>
 756 <para>(info)
 757 The tape tests are being skipped because you used the
 758 <option>-t</option>
 759 command line option.</para>
 760   </listitem>
 761   </varlistentry>
 762   <varlistentry>
 763   <term>WARNING: <emphasis remap='I'>compress</emphasis> is not executable, server-compression and indexing will not work</term>
 764   <listitem>
 765 <para>(warning)
 766 Compression program
 767 <emphasis remap='I'>compress</emphasis>
 768 is not executable,
 769 so compression on the tape server host and creating index files will not work.</para>
 770   </listitem>
 771   </varlistentry>
 772   <varlistentry>
 773   <term>Tape <emphasis remap='I'>label</emphasis> label ok.</term>
 774   <listitem>
 775 <para>(info)
 776 Tape
 777 <emphasis remap='I'>label</emphasis>
 778 is OK for the next
 779 run.</para>
 780   </listitem>
 781   </varlistentry>
 782   <varlistentry>
 783   <term>Server check took <emphasis remap='I'>S</emphasis> seconds.</term>
 784   <listitem>
 785 <para>(info)
 786 Reports how long the tape server host checks took.</para>
 787   </listitem>
 788   </varlistentry>
 789   <varlistentry>
 790   <term>ERROR: <emphasis remap='I'>host</emphasis>: could not resolve hostname</term>
 791   <listitem>
 792 <para>(error)
 793 Could not look up client hostname
 794 <emphasis remap='I'>host</emphasis>.</para>
 795   </listitem>
 796   </varlistentry>
 797   <varlistentry>
 798   <term>Client check: <emphasis remap='I'>H</emphasis> hosts checked in <emphasis remap='I'>S</emphasis> seconds, <emphasis remap='I'>N</emphasis> problems found.</term>
 799   <listitem>
 800 <para>(info)
 801 Reports the number of client hosts checked,
 802 how long it took and the number of errors detected.</para>
 803   </listitem>
 804   </varlistentry>
 805   <varlistentry>
 806   <term>WARNING: <emphasis remap='I'>host</emphasis>: selfcheck request timed out. Host down?</term>
 807   <listitem>
 808 <para>(warning)
 809 There was no response from
 810 <emphasis remap='I'>host</emphasis>
 811 when trying to do the client checks.
 812 The host might really be down or it might not be configured properly.</para>
 813   </listitem>
 814   </varlistentry>
 815   <varlistentry>
 816   <term>ERROR: <emphasis remap='I'>host</emphasis> NAK: <emphasis remap='I'>message</emphasis></term>
 817   <listitem>
 818 <para>(error)
 819 <emphasis remap='I'>Host</emphasis>
 820 reported a negative acknowledgment error of
 821 <emphasis remap='I'>message</emphasis>
 822 to the status check request.</para>
 823   </listitem>
 824   </varlistentry>
 825   <varlistentry>
 826   <term>ERROR: <emphasis remap='I'>host</emphasis> NAK: [NAK parse failed]</term>
 827   <listitem>
 828 <para>(error)
 829 <emphasis remap='B'>Amcheck</emphasis>
 830 could not parse the negative acknowledgment error from
 831 <emphasis remap='I'>host</emphasis>.
 832 There might be an Amanda version mismatch between the host running
 833 <command>amcheck</command>
 834 and
 835 <emphasis remap='I'>host</emphasis>.</para>
 836   </listitem>
 837   </varlistentry>
 838   <varlistentry>
 839   <term>ERROR: <emphasis remap='I'>host</emphasis> [mutual-authentication failed]</term>
 840   <listitem>
 841 <para>(error)
 842 Kerberos authentication failed while contacting
 843 <emphasis remap='I'>host</emphasis>.</para>
 844   </listitem>
 845   </varlistentry>
 846   <varlistentry>
 847   <term>ERROR: <emphasis remap='I'>host</emphasis>: <emphasis remap='I'>message</emphasis></term>
 848   <listitem>
 849 <para>(error)
 850 Error
 851 <emphasis remap='I'>message</emphasis>
 852 was reported by the status check on
 853 <emphasis remap='I'>host</emphasis>.</para>
 854   </listitem>
 855   </varlistentry>
 856 </variablelist>
 857 </refsect1>
 858
 859 <refsect1><title>EXIT CODE</title>
 860 The exit code of <command>amcheck</command> is one of:
 861 <programlisting>
 862  0  = success
 863  1  = error
 864 </programlisting>
 865 </refsect1>
 866
 867 <seealso>
 868 <manref name="amanda.conf" vol="5"/>
 869 <manref name="amdump" vol="8"/>
 870 </seealso>
 871
 872 </refentry>
 873