git.gag.com Git - debian/amanda/blob - docs/amcheck.8.txt

   1
   2                               amcheck
   3 Prev  Chapter 36. The Amanda Manual Pages.  Next
   4
   5 -------------------------------------------------------------------------------
   6
   7 Name
   8
   9 amcheck \14 run Amanda self-checks
  10
  11 Synopsis
  12
  13 amcheck [-am] [-w] [-sclt] [ -M | address ]* config [ host | [disk]*]* [ -o |
  14 configoption ]*
  15
  16 DESCRIPTION
  17
  18 Amcheck runs a number of self-checks on both the Amanda tape server host and
  19 the Amanda client hosts.
  20 On the tape server host, amcheck can go through the same tape checking used at
  21 the start of the nightly amdump run to verify the correct tape for the next run
  22 is mounted.
  23 Amcheck can also do a self-check on all client hosts to make sure each host is
  24 running and that permissions on filesystems to be backed up are correct.
  25 You can specify many host/disk expressions, only disks that match an expression
  26 will be checked. All disks are checked if no expressions are given.
  27 See the amanda(8) man page for more details about Amanda.
  28
  29 OPTIONS
  30
  31
  32
  33   -s
  34       Run the tape server local and tape checks (same as -lt).
  35
  36   -c
  37       Run the client host checks.
  38
  39   -l
  40       Run the local tests (e.g. permissions) on the server host.
  41
  42   -t
  43       Run the tape tests on the server host.
  44
  45   -w
  46       Enables a DESTRUCTIVE check for write-protection on the tape (which would
  47       otherwise cause the subsequent amdump to fail). If the tape is writable,
  48       this check causes all data after the tape label to be erased. If the
  49       label_new_tapes option is enabled, this check may ERASE any non-Amanda
  50       tape in the drive or changer. The check enable the tape tests on the
  51       server host and is only made if the tape is otherwise correct.
  52
  53   -m
  54       Nothing is printed, but mail is sent if any errors are detected. The mail
  55       goes to the mailto address specified in the amanda.conf file or the
  56       address value if -M is set.
  57
  58   -a
  59       Like -m but the mail is always sent.
  60
  61   -M address
  62       Mail the report to address instead of the mailto value from amanda.conf.
  63       Implies -m.
  64
  65   host [disk]*
  66       Specify the host and disk on which the command will work.
  67
  68   -o configoption
  69       See the "CONFIGURATION OVERWRITE" section in amanda(8).
  70
  71 The default is -cs.
  72
  73 EXAMPLES
  74
  75 In this example, both the tape server and client tests are run. The results are
  76 displayed on standard output.
  77
  78   % amcheck daily
  79   Amanda Tape Server Host Check
  80   -----------------------------
  81   /amanda2/amanda/work: 911475 KB disk space available, that's plenty.
  82   NOTE: skipping tape-writable test.
  83   Tape VOL10 label ok.
  84   Server check took 34.966 seconds.
  85
  86   Amanda Backup Client Hosts Check
  87   --------------------------------
  88   WARNING: northstar: selfcheck request timed out.  Host down?
  89   WARNING: drinkme: selfcheck request timed out.  Host down?
  90   WARNING: scruffy: selfcheck request timed out.  Host down?
  91   Client check: 136 hosts checked in 51.945 seconds, 3 problems found.
  92
  93   (brought to you by Amanda 2.5.0)
  94
  95 In this example, if the line mailto csd-amanda is in amanda.conf, mail will be
  96 sent to csd-amanda if the server check returns an error.
  97
  98   % amcheck -s -m daily
  99
 100
 101 MESSAGES
 102
 103
 104
 105   fatal slot slot: error message
 106       (error) The tape changer detected some kind of fatal error while trying
 107       to load slot slot.
 108
 109   slot slot: error message
 110       (warning) The tape changer detected some kind of non-fatal error (e.g. an
 111       empty slot was detected) while trying to load slot slot, or an error was
 112       detected trying to read the tape label.
 113
 114   slot slot: date YYYYMMDD label label (result)
 115       (info) Tape label in slot slot was loaded and found to have been last
 116       written on YYYYMMDD. If the tape is new, the date field will be an X. The
 117       result may be one of:
 118
 119
 120         exact label match
 121             This is the expected tape.
 122
 123         no match
 124             This label does not match the labelstr pattern in amanda.conf. Tape
 125             scanning will continue.
 126
 127         active tape
 128             This tape is still active and cannot be overwritten. Tape scanning
 129             will continue.
 130
 131         first labelstr match
 132             This tape is the first one that matches the labelstr pattern in
 133             amanda.conf. Tape scanning will continue if necessary.
 134
 135         labelstr match
 136             This tape is the next one that matches the labelstr pattern in
 137             amanda.conf. Tape scanning will continue.
 138
 139
 140   ERROR: cannot look up dump user user
 141       (error) Dump user user from amanda.conf could not be found in the system
 142       password information.
 143
 144   ERROR: cannot look up my own uid (uid)
 145       (error) User id uid running amcheck could not be found in the system
 146       password information.
 147
 148   ERROR: running as user runuser instead of dumpuser
 149       (error) Amcheck should be run as the dump user dumpuser from amanda.conf
 150       instead of runuser.
 151
 152   ERROR: program dir directory: not accessible
 153       (error) The directory Amanda expects to find its auxiliary programs in,
 154       directory, is not accessible.
 155
 156   ERROR: program program: does not exist
 157       (error) Program program needed on the tape server could not be found.
 158
 159   ERROR: program program: not a file
 160       (error) Program program needed on the tape server exists but is not a
 161       file.
 162
 163   ERROR: program program: not executable
 164       (error) Program program needed on the tape server exists but is not
 165       executable.
 166
 167   WARNING: program program: not setuid-root
 168       (warning) Program program needed on the tape server exists but should be
 169       owned by user "root" and setuid.
 170
 171   ERROR: XXX dir directory: not writable
 172       (error) Directory directory is either not writable, i.e. the dump user
 173       will not be able to create or remove files, or cannot be accessed,
 174       perhaps because a parent directory does not allow search permission. The
 175       XXX may be:
 176
 177
 178         log
 179             for the Amanda log directory (see logdir in amanda.conf)
 180
 181         oldlog
 182             for the directory that holds the old log files (see logdir in
 183             amanda.conf)
 184
 185         info
 186             for an Amanda database information directory (see curinfo in
 187             amanda.conf) or
 188
 189         index
 190             for an Amanda index directory (see indexdir in amanda.conf)
 191
 192         tapelist
 193             for the Amanda tapelist directory (see tapelist in amanda.conf)
 194
 195
 196   NOTE: XXX dir directory: does not exist
 197       (info) A database (info) or index directory does not exist or cannot be
 198       accessed. This might just mean this is a new client or disk, but if that
 199       is not the case, this should be treated as an error.
 200
 201   NOTE: it will be created on the next run
 202       (info) This indicates the info directory listed in the previous message
 203       will be created on the next run.
 204
 205   ERROR: XXX dir name: not a directory
 206       (error) Amcheck expected name to be a directory, but it is something else
 207       (e.g. file).
 208
 209   WARNING: info file file: does not exist
 210       (warning) File file does not exist in the text format database. Since the
 211       parent directories do exist, the file should already have been created.
 212
 213   ERROR: info file name: not a file
 214       (error) Amcheck expected name to be a file, but it is something else
 215       (e.g. file).
 216
 217   ERROR: info file file: not readable
 218       (error) The text format database file file is not readable.
 219
 220   ERROR: log file file: not writable
 221       (error) Log file file (file log in logdir from amanda.conf) is either not
 222       writable, or cannot be accessed, perhaps because a parent directory does
 223       not allow search permission.
 224
 225   ERROR: tape list tapelist: not writable
 226       (error) Amanda tape list file tapelist (see tapelist in amanda.conf) is
 227       not writable or was not found.
 228
 229   ERROR: tape list tapelist: parse error
 230       (error) Amanda tape list file tapelist (see tapelist in amanda.conf)
 231       could not be read or parsed.
 232
 233   WARNING: tapedev is /dev/null, dumps will be thrown away
 234       (warning) The tapedev parameter in amanda.conf is set to /dev/null and
 235       Amanda uses that when debugging to throw all the dump images away.
 236
 237   WARNING: hold file file exists
 238       (info) Hold file file exists and will cause amdump to pause at the
 239       beginning until it is removed.
 240
 241   ERROR: holding disk disk: statfs: error message
 242       (error) An error was returned from the statfs system call on holding disk
 243       disk (maybe because it does not exist).
 244
 245   ERROR: holding disk disk: not writable
 246       (error) Holding disk disk, is not writable, probably because the caller
 247       does not have write permission or a parent directory does not allow
 248       search permission.
 249
 250   WARNING: holding disk disk: available space unknown N KB requested.
 251       (warning) Amcheck could not determine the amount of available space on
 252       holding disk disk to see if there were at least N KBytes available.
 253
 254   WARNING: holding disk disk: only F KB free (R KB requested).
 255       (warning) amanda.conf requested R KBytes of free space on holding disk
 256       disk, but only F KBytes were available. 10 MBytes is subtracted for each
 257       backup process (see the inparallel amanda.conf option) to allow for
 258       unexpected overruns.
 259
 260       Note
 261
 262       Even though this message is listed as a warning, it causes amcheck to
 263       exit with a non-zero status.
 264
 265
 266
 267   Holding disk disk: N KB disk space available, that's plenty.
 268       (info) There was sufficient free space on holding disk disk.
 269
 270   WARNING: holding disk disk: only F KB free, using nothing
 271       (warning) Holding disk disk has F KBytes of free space, but that is not
 272       enough for what is requested in amanda.conf.
 273
 274   Holding disk disk: F KB disk space available, using U KB
 275       (info) Holding disk disk has F KBytes of free space and Amanda will be
 276       using up to U Kbytes.
 277
 278   WARNING: if a tape changer is not available, runtapes must be set to 1.
 279       (warning) The runtapes amanda.conf option must be set to 1 if the
 280       tpchanger amanda.conf option is not set.
 281
 282   ERROR: error message.
 283       (error) An error was detected while initializing the tape changer.
 284
 285   ERROR: tape device: error message.
 286       (error) An error was detected while processing the tape label.
 287
 288   ERROR: cannot overwrite active tape label.
 289       (error) Tape label is still active and cannot be used.
 290
 291   ERROR: label label doesn't match labelstr pattern .
 292       (error) The label on tape label does not match the labelstr amanda.conf
 293       option.
 294
 295   (expecting a new tape)
 296       (info) The tape is not OK and a new tape was expected.
 297
 298   (expecting tape label or a new tape)
 299       (info) The tape is not OK and either tape label or a new tape was
 300       expected.
 301
 302   ERROR: tape label label ok, but is not writable.
 303       (error) Tape label is OK, but the write enable test failed.
 304
 305   Tape label is writable.
 306       (info) Tape label is OK and the write enable test succeeded.
 307
 308   NOTE: skipping tape-writable test.
 309       (info) The tape write test (see the -w option) was not enabled.
 310
 311   WARNING: skipping tape test because amdump or amflush seem to be running,
 312   WARNING: if they are not, you must run amcleanup
 313       (warning) It looked to amcheck like either amdump or amflush were running
 314       because a log file or amdump file exists. If they are not running, you
 315       probably need to run amcleanup to clear up a previous failure. Otherwise,
 316       you need to wait until they complete before running amcheck.
 317
 318   NOTE: skipping tape checks
 319       (info) The tape tests are being skipped because you used the -t command
 320       line option.
 321
 322   WARNING: compress is not executable, server-compression and indexing will not
 323   work
 324       (warning) Compression program compress is not executable, so compression
 325       on the tape server host and creating index files will not work.
 326
 327   Tape label label ok.
 328       (info) Tape label is OK for the next run.
 329
 330   Server check took S seconds.
 331       (info) Reports how long the tape server host checks took.
 332
 333   ERROR: host: could not resolve hostname
 334       (error) Could not look up client hostname host.
 335
 336   Client check: H hosts checked in S seconds, N problems found.
 337       (info) Reports the number of client hosts checked, how long it took and
 338       the number of errors detected.
 339
 340   WARNING: host: selfcheck request timed out. Host down?
 341       (warning) There was no response from host when trying to do the client
 342       checks. The host might really be down or it might not be configured
 343       properly.
 344
 345   ERROR: host NAK: message
 346       (error) Host reported a negative acknowledgment error of message to the
 347       status check request.
 348
 349   ERROR: host NAK: [NAK parse failed]
 350       (error) Amcheck could not parse the negative acknowledgment error from
 351       host. There might be an Amanda version mismatch between the host running
 352       amcheck and host.
 353
 354   ERROR: host [mutual-authentication failed]
 355       (error) Kerberos authentication failed while contacting host.
 356
 357   ERROR: host: message
 358       (error) Error message was reported by the status check on host.
 359
 360
 361 AUTHOR
 362
 363 James da Silva, <jds@amanda.org> : Original text
 364 Stefan G. Weichinger, <sgw@amanda.org>, maintainer of the Amanda-documentation:
 365 XML-conversion
 366
 367 SEE ALSO
 368
 369 amanda(8), amdump(8)
 370 -------------------------------------------------------------------------------
 371
 372 Prev                 Up        Next
 373 amanda-client.conf  Home  amcheckdb
 374