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