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