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