3 Prev Chapter 36. The Amanda Manual Pages. Next
5 -------------------------------------------------------------------------------
9 amcheck
\14 run Amanda self-checks
13 amcheck [-am] [-w] [-sclt] [ -M | address ]* config [ host | [disk]*]* [ -o |
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
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.
34 Run the tape server local and tape checks (same as -lt).
37 Run the client host checks.
40 Run the local tests (e.g. permissions) on the server host.
43 Run the tape tests on the server host.
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.
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.
59 Like -m but the mail is always sent.
62 Mail the report to address instead of the mailto value from amanda.conf.
66 Specify the host and disk on which the command will work.
69 See the "CONFIGURATION OVERWRITE" section in amanda(8).
75 In this example, both the tape server and client tests are run. The results are
76 displayed on standard output.
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.
84 Server check took 34.966 seconds.
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.
93 (brought to you by Amanda 2.5.0)
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.
105 fatal slot slot: error message
106 (error) The tape changer detected some kind of fatal error while trying
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.
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:
121 This is the expected tape.
124 This label does not match the labelstr pattern in amanda.conf. Tape
125 scanning will continue.
128 This tape is still active and cannot be overwritten. Tape scanning
132 This tape is the first one that matches the labelstr pattern in
133 amanda.conf. Tape scanning will continue if necessary.
136 This tape is the next one that matches the labelstr pattern in
137 amanda.conf. Tape scanning will continue.
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.
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.
148 ERROR: running as user runuser instead of dumpuser
149 (error) Amcheck should be run as the dump user dumpuser from amanda.conf
152 ERROR: program dir directory: not accessible
153 (error) The directory Amanda expects to find its auxiliary programs in,
154 directory, is not accessible.
156 ERROR: program program: does not exist
157 (error) Program program needed on the tape server could not be found.
159 ERROR: program program: not a file
160 (error) Program program needed on the tape server exists but is not a
163 ERROR: program program: not executable
164 (error) Program program needed on the tape server exists but is not
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.
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
179 for the Amanda log directory (see logdir in amanda.conf)
182 for the directory that holds the old log files (see logdir in
186 for an Amanda database information directory (see curinfo in
190 for an Amanda index directory (see indexdir in amanda.conf)
193 for the Amanda tapelist directory (see tapelist in amanda.conf)
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.
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.
205 ERROR: XXX dir name: not a directory
206 (error) Amcheck expected name to be a directory, but it is something else
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.
213 ERROR: info file name: not a file
214 (error) Amcheck expected name to be a file, but it is something else
217 ERROR: info file file: not readable
218 (error) The text format database file file is not readable.
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.
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.
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.
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.
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.
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).
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
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.
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
262 Even though this message is listed as a warning, it causes amcheck to
263 exit with a non-zero status.
267 Holding disk disk: N KB disk space available, that's plenty.
268 (info) There was sufficient free space on holding disk disk.
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.
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.
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.
282 ERROR: error message.
283 (error) An error was detected while initializing the tape changer.
285 ERROR: tape device: error message.
286 (error) An error was detected while processing the tape label.
288 ERROR: cannot overwrite active tape label.
289 (error) Tape label is still active and cannot be used.
291 ERROR: label label doesn't match labelstr pattern .
292 (error) The label on tape label does not match the labelstr amanda.conf
295 (expecting a new tape)
296 (info) The tape is not OK and a new tape was expected.
298 (expecting tape label or a new tape)
299 (info) The tape is not OK and either tape label or a new tape was
302 ERROR: tape label label ok, but is not writable.
303 (error) Tape label is OK, but the write enable test failed.
305 Tape label is writable.
306 (info) Tape label is OK and the write enable test succeeded.
308 NOTE: skipping tape-writable test.
309 (info) The tape write test (see the -w option) was not enabled.
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.
318 NOTE: skipping tape checks
319 (info) The tape tests are being skipped because you used the -t command
322 WARNING: compress is not executable, server-compression and indexing will not
324 (warning) Compression program compress is not executable, so compression
325 on the tape server host and creating index files will not work.
328 (info) Tape label is OK for the next run.
330 Server check took S seconds.
331 (info) Reports how long the tape server host checks took.
333 ERROR: host: could not resolve hostname
334 (error) Could not look up client hostname host.
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.
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
345 ERROR: host NAK: message
346 (error) Host reported a negative acknowledgment error of message to the
347 status check request.
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
354 ERROR: host [mutual-authentication failed]
355 (error) Kerberos authentication failed while contacting host.
358 (error) Error message was reported by the status check on host.
363 James da Silva, <jds@amanda.org> : Original text
364 Stefan G. Weichinger, <sgw@amanda.org>, maintainer of the Amanda-documentation:
370 -------------------------------------------------------------------------------
373 amanda-client.conf Home amcheckdb