884de3a142f74628865e1f59e5a01fe1aa97c0ff
[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 .HP 7
25 \fBamdump\fR \fIconfig\fR [\fIhost\fRĀ [\fIdisk\fR...]...]
26 .SH "DESCRIPTION"
27 .PP
28 \fBAmdump\fR
29 switches to the appropriate
30 \fBAmanda\fR
31 configuration directory, e.g. /usr/local/etc/amanda/\fBconfig\fR, then attempts to back up every disk specified by the
32 \fBamanda.conf\fR
33 file.
34 \fBAmdump\fR
35 is normally run by
36 \fBcron\fR.
37 .PP
38 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.
39 .PP
40 If the file /usr/local/etc/amanda/\fBconfig\fR/hold exists,
41 \fBamdump\fR
42 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,
43 \fBamdump\fR
44 checks for the hold file every minute.
45 .PP
46 See the
47 \fBamanda\fR(8)
48 man page for more details about
49 \fBAmanda\fR.
50 .SH "EXAMPLE"
51 .PP
52 Here is a typical crontab entry. It runs
53 \fBamdump\fR
54 every weeknight at 1 a.m. as user
55 \fBbin\fR:
56 .nf
57
58 0 1 * * 1-5 bin /usr/local/sbin/amdump daily
59 .fi
60 .PP
61 Please see the
62 \fBcrontab\fR(5)
63 or
64 \fBcrontab\fR(1)
65 manual page for the correct crontab format for your system.
66 .SH "MESSAGES"
67 .TP
68 amdump: waiting for hold file to be removed
69 The "hold" file exists and
70 \fBamdump\fR
71 is waiting for it to be removed before starting backups.
72 .TP
73 amdump: amdump or amflush is already running, or you must run amcleanup
74 Amdump detected another
75 \fBamdump\fR
76 or
77 \fBamflush\fR
78 running, or the remains of a previous incomplete
79 \fBamdump\fR
80 or
81 \fBamflush\fR
82 run. This run is terminated. If the problem is caused by the remains of a previous run, you must execute
83 \fBamcleanup\fR(8)
84 and then rerun
85 \fBamdump\fR.
86 .SH "AUTHOR"
87 .PP
88 James da Silva,
89 <jds@amanda.org>
90 : Original text
91 .PP
92 Stefan G. Weichinger,
93 <sgw@amanda.org>, maintainer of the
94 \fBAmanda\fR-documentation: XML-conversion
95 .SH "SEE ALSO"
96 .PP
97 \fBamanda\fR(8),
98 \fBamcheck\fR(8),
99 \fBamcleanup\fR(8),
100 \fBamrestore\fR(8),
101 \fBamflush\fR(8),
102 \fBcron\fR(8)
103