amcheck



AMCHECK(8)                                                          AMCHECK(8)




NAME

       amcheck - run AMANDA self-checks


SYNOPSIS

       amcheck [-mwsclt] [-Maddress] config [host [disk...]...]



DESCRIPTION

       Amcheck  runs  a  number  of self-checks on both the AMANDA tape server
       host and the AMANDA client hosts.


       On the tape server host, amcheck can go through the same tape  checking
       used  at the start of the nightly amdump run to verify the correct tape
       for the next run is mounted.


       Amcheck can also do a self-check on all client hosts to make sure  each
       host is running and that permissions on filesystems to be backed up are
       correct.


       You can specify many host/disk expressions, only disks  that  match  an
       expression will be checked. All disks are checked if no expressions are
       given.


       See the amanda(8) man page for more details about AMANDA.



OPTIONS

       -s     Run the tape server local and tape checks (same as -lt).


       -c     Run the client host checks.


       -l     Run the local tests (e.g. permissions) on the server host.


       -t     Run the tape tests on the server host.


       -w     Enables a destructive check for  write-protection  on  the  tape
              (which  would otherwise cause the subsequent amdump to fail). If
              the tape is writable, this check causes all data after the  tape
              label to be erased (actually depends on the device driver: there
              is no portable non-destructive way to  check  for  write-protec-
              tion). The check implies -t and is only made if the tape is oth-
              erwise correct.


       -m     Nothing is printed, but mail is sent if any errors are detected.
              The mail goes to the mailto address specified in the amanda.conf
              file or the address value if -M is set.


       -a     Like -m but the mail is always sent.


       -Maddress
              Mail the report to address instead  of  the  mailto  value  from
              amanda.conf. Implies -m.


       The default is -cs.



EXAMPLES

       In this example, both the tape server and client tests are run. The re-
       sults are displayed on standard output.

       % amcheck daily
       AMANDA Tape Server Host Check
       -----------------------------
       /amanda2/amanda/work: 911475 KB disk space available, that’s plenty.
       NOTE: skipping tape-writable test.
       Tape VOL10 label ok.
       Server check took 34.966 seconds.

       AMANDA Backup Client Hosts Check
       --------------------------------
       WARNING: northstar: selfcheck request timed out.  Host down?
       WARNING: drinkme: selfcheck request timed out.  Host down?
       WARNING: scruffy: selfcheck request timed out.  Host down?
       Client check: 136 hosts checked in 51.945 seconds, 3 problems found.

       (brought to you by AMANDA 2.4.5)


       In this example, if the line mailto csd-amanda is in amanda.conf,  mail
       will be sent to csd-amanda if the server check returns an error.

       % amcheck -s -m daily



MESSAGES

       fatal slot slot: error message
              (error) The tape changer detected some kind of fatal error while
              trying to load slot slot.


       slot slot: error message
              (warning) The tape changer detected some kind of non-fatal error
              (e.g.  an  empty  slot  was  detected) while trying to load slot
              slot, or an error was detected trying to read the tape label.


       slot slot: date YYYYMMDD label label (result)
              (info) Tape label in slot slot was loaded and found to have been
              last  written  on  YYYYMMDD.  If the tape is new, the date field
              will be an X. The result may be one of:



              exact label match
                     This is the expected tape.


              no match
                     This label does not match the labelstr pattern  in  aman-
                     da.conf. Tape scanning will continue.


              active tape
                     This tape is still active and cannot be overwritten. Tape
                     scanning will continue.


              first labelstr match
                     This tape is the first one that matches the labelstr pat-
                     tern  in amanda.conf. Tape scanning will continue if nec-
                     essary.


              labelstr match
                     This tape is the next one that matches the labelstr  pat-
                     tern in amanda.conf. Tape scanning will continue.




       ERROR: cannot look up dump user user
              (error)  Dump  user  user from amanda.conf could not be found in
              the system password information.


       ERROR: cannot look up my own uid (uid)
              (error) User id uid running amcheck could not be  found  in  the
              system password information.


       ERROR: running as user runuser instead of dumpuser
              (error)  Amcheck  should  be  run as the dump user dumpuser from
              amanda.conf instead of runuser.


       ERROR: program dir directory: not accessible
              (error) The directory AMANDA expects to find its auxiliary  pro-
              grams in, directory, is not accessible.


       ERROR: program program: does not exist
              (error)  Program  program needed on the tape server could not be
              found.


       ERROR: program program: not a file
              (error) Program program needed on the tape server exists but  is
              not a file.


       ERROR: program program: not executable
              (error)  Program program needed on the tape server exists but is
              not executable.


       WARNING: program program: not setuid-root
              (warning) Program program needed on the tape server  exists  but
              should be owned by user "root" and setuid.


       ERROR: XXX dir directory: not writable
              (error)  Directory  directory  is  either not writable, i.e. the
              dump user will not be able to create or remove files, or  cannot
              be  accessed,  perhaps because a parent directory does not allow
              search permission. The XXX may be:



              log    for the AMANDA log directory (see logdir in amanda.conf)


              oldlog for the directory that  holds  the  old  log  files  (see
                     logdir in amanda.conf)


              info   for an AMANDA database information directory (see curinfo
                     in amanda.conf) or


              index  for an AMANDA index  directory  (see  indexdir  in  aman-
                     da.conf)


              tapelist
                     for  the AMANDA tapelist directory (see tapelist in aman-
                     da.conf)




       NOTE: XXX dir directory: does not exist
              (info) A database (info) or index directory does  not  exist  or
              cannot be accessed. This might just mean this is a new client or
              disk, but if that is not the case, this should be treated as  an
              error.


       NOTE: it will be created on the next run
              (info)  This indicates the info directory listed in the previous
              message will be created on the next run.


       ERROR: XXX dir name: not a directory
              (error) Amcheck expected name to be a directory, but it is some-
              thing else (e.g. file).


       WARNING: info file file: does not exist
              (warning)  File file does not exist in the text format database.
              Since the parent directories do exist, the file  should  already
              have been created.


       ERROR: info file name: not a file
              (error)  Amcheck expected name to be a file, but it is something
              else (e.g. file).


       ERROR: info file file: not readable
              (error) The text format database file file is not readable.


       ERROR: log file file: not writable
              (error) Log file file (file log in logdir from  amanda.conf)  is
              either  not  writable,  or cannot be accessed, perhaps because a
              parent directory does not allow search permission.


       ERROR: tape list tapelist: not writable
              (error) AMANDA tape list file tapelist (see  tapelist  in  aman-
              da.conf) is not writable or was not found.


       ERROR: tape list tapelist: parse error
              (error)  AMANDA  tape  list file tapelist (see tapelist in aman-
              da.conf) could not be read or parsed.


       WARNING: tapedev is /dev/null, dumps will be thrown away
              (warning)  The  tapedev  parameter  in  amanda.conf  is  set  to
              /dev/null  and  AMANDA uses that when debugging to throw all the
              dump images away.


       WARNING: hold file file exists
              (info) Hold file file exists and will cause amdump to  pause  at
              the beginning until it is removed.


       ERROR: holding disk disk: statfs: error message
              (error)  An  error  was  returned from the statfs system call on
              holding disk disk (maybe because it does not exist).


       ERROR: holding disk disk: not writable
              (error) Holding disk disk, is not writable, probably because the
              caller does not have write permission or a parent directory does
              not allow search permission.


       WARNING: holding disk disk: available space unknown N KB requested.
              (warning) Amcheck could not determine the  amount  of  available
              space  on  holding  disk  disk  to  see if there were at least N
              KBytes available.


       WARNING: holding disk disk: only F KB free (R KB requested).
              (warning) amanda.conf requested R KBytes of free space on  hold-
              ing  disk  disk,  but only F KBytes were available. 10 MBytes is
              subtracted for each backup process (see  the  inparallel   aman-
              da.conf option) to allow for unexpected overruns.


              Note

              Even  though this message is listed as a warning, it causes  am-
              check to exit with a non-zero status.


       Holding disk disk: N KB disk space available, that’s plenty.
              (info) There was sufficient free space on holding disk disk.


       WARNING: holding disk disk: only F KB free, using nothing
              (warning) Holding disk disk has F KBytes of free space, but that
              is not enough for what is requested in amanda.conf.


       Holding disk disk: F KB disk space available, using U KB
              (info)  Holding  disk disk has F KBytes of free space and AMANDA
              will be using up to U Kbytes.


       WARNING: if a tape changer is not available, runtapes must be set to 1.
              (warning) The runtapes  amanda.conf option must be set to  1  if
              the tpchanger  amanda.conf option is not set.


       ERROR: error message.
              (error) An error was detected while initializing the tape chang-
              er.


       ERROR: tape device: error message.
              (error) An error was detected while processing the tape label.


       ERROR: cannot overwrite active tape label.
              (error) Tape label is still active and cannot be used.


       ERROR: label label doesn’t match labelstr pattern .
              (error) The label on tape label  does  not  match  the  labelstr
              amanda.conf option.


       (expecting a new tape)
              (info) The tape is not OK and a new tape was expected.


       (expecting tape label or a new tape)
              (info)  The  tape  is not OK and either tape label or a new tape
              was expected.


       ERROR: tape label label ok, but is not writable.
              (error) Tape label is OK, but the write enable test failed.


       Tape label is writable.
              (info) Tape label is OK and the write enable test succeeded.


       NOTE: skipping tape-writable test.
              (info) The tape write test (see the -w option) was not  enabled.


       WARNING:  skipping  tape test because amdump or amflush seem to be run-
       ning, WARNING: if they are not, you must run amcleanup,
              (warning)  It  looked  to  amcheck like either amdump or amflush
              were running because a log file or amdump file exists.  If  they
              are  not running, you probably need to run amcleanup to clear up
              a previous failure. Otherwise, you need to wait until they  com-
              plete before running amcheck.


       NOTE: skipping tape checks
              (info)  The tape tests are being skipped because you used the -t
              command line option.


       WARNING: compress is not executable,  server-compression  and  indexing
       will not work
              (warning) Compression program compress  is  not  executable,  so
              compression  on  the  tape  server host and creating index files
              will not work.


       Tape label label ok.
              (info) Tape label is OK for the next run.


       Server check took S seconds.
              (info) Reports how long the tape server host checks took.


       ERROR: host: could not resolve hostname
              (error) Could not look up client hostname host.


       Client check: H hosts checked in S seconds, N problems found.
              (info) Reports the number of client hosts checked, how  long  it
              took and the number of errors detected.


       WARNING: host: selfcheck request timed out. Host down?
              (warning)  There was no response from host when trying to do the
              client checks. The host might really be down or it might not  be
              configured properly.


       ERROR: host NAK: message
              (error) Host reported a negative acknowledgment error of message
              to the status check request.


       ERROR: host NAK: [NAK parse failed]
              (error) Amcheck could not parse the negative acknowledgment  er-
              ror from host. There might be an AMANDA version mismatch between
              the host running amcheck and host.


       ERROR: host [mutual-authentication failed]
              (error) Kerberos authentication failed while contacting host.


       ERROR: host: message
              (error) Error message was reported by the status check on  host.



AUTHOR

       James da Silva, <jds@amanda.org> : Original text


       Stefan  G. Weichinger, <sgw@amanda.org>, maintainer of the AMANDA-docu-
       mentation: XML-conversion



SEE ALSO

       amanda(8), amdump(8)




                                                                    AMCHECK(8)

Man(1) output converted with man2html