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