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