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