Imported Upstream version 2.4.5p1
[debian/amanda] / man / amdump.8
1 .\"Generated by db2man.xsl. Don't modify this, modify the source.
2 .de Sh \" Subsection
3 .br
4 .if t .Sp
5 .ne 5
6 .PP
7 \fB\\$1\fR
8 .PP
9 ..
10 .de Sp \" Vertical space (when we can't use .PP)
11 .if t .sp .5v
12 .if n .sp
13 ..
14 .de Ip \" List item
15 .br
16 .ie \\n(.$>=3 .ne \\$3
17 .el .ne 3
18 .IP "\\$1" \\$2
19 ..
20 .TH "AMDUMP" 8 "" "" ""
21 .SH NAME
22 amdump \- back up all disks in an AMANDA configuration
23 .SH "SYNOPSIS"
24 .ad l
25 .hy 0
26 .HP 7
27 \fBamdump\fR \fIconfig\fR [\fIhost\fR\ [\fIdisk\fR...]...]
28 .ad
29 .hy
30
31 .SH "DESCRIPTION"
32
33 .PP
34 \fBAmdump\fR switches to the appropriate \fBAMANDA\fR configuration directory, e\&.g\&. /usr/local/etc/amanda/\fBconfig\fR, then attempts to back up every disk specified by the \fBamanda\&.conf\fR file\&. \fBAmdump\fR is normally run by \fBcron\fR\&.
35
36 .PP
37 You can specify many host/disk expressions, only disks that match an expression will be dumped\&. All disks are dumped if no expressions are given\&.
38
39 .PP
40 If the file /usr/local/etc/amanda/\fBconfig\fR/hold exists, \fBamdump\fR will wait until it is removed before starting the backups\&. This allows scheduled backups to be delayed when circumstances warrant, for example, if the tape device is being used for some other purpose\&. While waiting, \fBamdump\fR checks for the hold file every minute\&.
41
42 .PP
43 See the \fBamanda\fR(8) man page for more details about \fBAMANDA\fR\&.
44
45 .SH "EXAMPLE"
46
47 .PP
48 Here is a typical crontab entry\&. It runs \fBamdump\fR every weeknight at 1 a\&.m\&. as user \fBbin\fR:
49 .nf
50
51 0 1 * * 1\-5 bin /usr/local/sbin/amdump daily
52 .fi
53
54 .PP
55 Please see the \fBcrontab\fR(5) or \fBcrontab\fR(1) manual page for the correct crontab format for your system\&.
56
57 .SH "MESSAGES"
58
59 .TP
60 amdump: waiting for hold file to be removed
61 The "hold" file exists and \fBamdump\fR is waiting for it to be removed before starting backups\&.
62
63 .TP
64 amdump: amdump or amflush is already running, or you must run amcleanup
65 Amdump detected another \fBamdump\fR or \fBamflush\fR running, or the remains of a previous incomplete \fBamdump\fR or \fBamflush\fR run\&. This run is terminated\&. If the problem is caused by the remains of a previous run, you must execute \fBamcleanup\fR(8) and then rerun \fBamdump\fR\&.
66
67 .SH "AUTHOR"
68
69 .PP
70 James da Silva, <jds@amanda\&.org> : Original text
71
72 .PP
73 Stefan G\&. Weichinger, <sgw@amanda\&.org>, maintainer of the \fBAMANDA\fR\-documentation: XML\-conversion
74
75 .SH "SEE ALSO"
76
77 .PP
78 \fBamanda\fR(8), \fBamcheck\fR(8), \fBamcleanup\fR(8), \fBamrestore\fR(8), \fBamflush\fR(8), \fBcron\fR(8)
79