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