Imported Upstream version 2.5.1
[debian/amanda] / man / amflush.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 "AMFLUSH" 8 "" "" ""
21 .SH "NAME"
22 amflush - flush Amanda backup files from holding disk to tape
23 .SH "SYNOPSIS"
24 .HP 8
25 \fBamflush\fR [-b] [-f] [-s] [-D \fIdatestamp\fR]*
26      \fIconfig\fR [\fIhost\fR [\fIdisk\fR]*]*
27      [-o \fIconfigoption\fR]*
28
29 .SH "DESCRIPTION"
30 .PP
31 \fBAmflush\fR
32 writes
33 \fBAmanda\fR
34 backups from the holding disks to tape, and updates the
35 \fBAmanda\fR
36 info database and tapelist accordingly. Backups may stay in a holding disk when something is wrong with the tape at the time
37 \fBamdump\fR
38 is run. When this happens, the problem must be corrected and
39 \fBamflush\fR
40 run by hand.
41 .SH "OPTIONS"
42 .TP
43 \fB-b\fR
44 Run
45 \fBamflush\fR
46 in batch mode. All datestamps are selected unless specified. The flush is started without confirmation.
47 .TP
48 \fB-f\fR
49 Run
50 \fBamflush\fR
51 in foreground.
52 \fBAmflush\fR
53 normally detaches itself from the tty and runs as a background process. With the
54 \fB-f\fR
55 option,
56 \fBamflush\fR
57 stays in the foreground. This is useful if
58 \fBamflush\fR
59 is run as part of another script that, for example, advances the tape after the flush is completed.
60 .TP
61 \fB-s\fR
62 Write log to stdout/stderr instead of the amflush log file. Requires the
63 \fB-f\fR
64 option.
65 .TP
66 \fB-D datestamp\fR
67 specify a datestamp expression you want to flush, see the "DATESTAMP EXPRESSION" section of
68 \fBamanda\fR(8)
69 for a description.
70 \fB-D 20001225-7\fR
71 will flush all dumps from 25 december 2000 to 27 december 2000.
72 .TP
73 \fIhost\fR [\fIdisk\fR]*
74 Specify the host and disk on which the command will work.
75 .TP
76 \fB-o\fR \fIconfigoption\fR
77 See the "\fBCONFIGURATION OVERWRITE\fR" section in
78 \fBamanda\fR(8).
79 .PP
80 You can specify many host/disk expressions, only disks that match an expression will be flushed. All disks are flushed if no expressions are given. see the "HOST & DISK EXPRESSION" section of
81 \fBamanda\fR(8)
82 for a description.
83 .PP
84 \fBAmflush\fR
85 will look in the holding disks specified by the
86 \fBamanda.conf\fR
87 file in /usr/local/etc/amanda/\fBconfig\fR
88 for any non-empty
89 \fBAmanda\fR
90 work directories. It then prompts you to select a directory or to process all of the directories. The work directories in the holding disks are named by the date at the time
91 \fBamdump\fR
92 was run, e.g.
93 19910215.
94 .PP
95 See the
96 \fBamanda\fR(8)
97 man page for more details about
98 \fBAmanda\fR.
99 .SH "EXAMPLE"
100 .PP
101 \fBAmflush\fR
102 will search for holding areas associated with the
103 \fBdaily\fR
104 configuration. After you select which holding area to flush,
105 \fBamflush\fR
106 writes the data to tape, updates the databases and sends a mail report similar to
107 \fBamdump\fR(8).
108 .nf
109
110 % amflush daily
111 Scanning /amanda-hold...
112   20001113: found \fBAmanda\fR directory.
113   20001114: found \fBAmanda\fR directory.
114
115 Multiple \fBAmanda\fR directories, please pick one by letter:
116   A. 20001113
117   B. 20001114
118 Select directories to flush [A..B]: [ALL] all
119
120 Flushing dumps in 20001113, 20001114,
121 today: 20001117
122 to tape drive /dev/rmt/0mn.
123 Expecting tape DMP014 or a new tape.  (The last dumps were to tape DMP013)
124 Are you sure you want to do this? yes
125 Running in background, you can log off now.
126 You'll get mail when amflush is finished.
127 .fi
128 .SH "AUTHOR"
129 .PP
130 James da Silva,
131 <jds@amanda.org>
132 : Original text
133 .PP
134 Stefan G. Weichinger,
135 <sgw@amanda.org>, maintainer of the
136 \fBAmanda\fR-documentation: XML-conversion
137 .SH "SEE ALSO"
138 .PP
139 \fBamanda\fR(8),
140 \fBamdump\fR(8)
141