Imported Upstream version 2.4.5
[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 .ad l
25 .hy 0
26 .HP 8
27 \fBamflush\fR [\-b] [\-f] [\-s] [\-D\ \fIdatestamp\fR...] \fIconfig\fR [\fIhost\fR\ [\fIdisk\fR...]...]
28 .ad
29 .hy
30
31 .SH "DESCRIPTION"
32
33 .PP
34 \fBAmflush\fR writes \fBAMANDA\fR backups from the holding disks to tape, and updates the \fBAMANDA\fR info database and tapelist accordingly\&. Backups may stay in a holding disk when something is wrong with the tape at the time \fBamdump\fR is run\&. When this happens, the problem must be corrected and \fBamflush\fR run by hand\&.
35
36 .SH "OPTIONS"
37
38 .TP
39 \fB\-b\fR
40 Run \fBamflush\fR in batch mode\&. All datestamps are selected unless specified\&. The flush is started without confirmation\&.
41
42 .TP
43 \fB\-f\fR
44 Run \fBamflush\fR in foreground\&. \fBAmflush\fR normally detaches itself from the tty and runs as a background process\&. With the \fB\-f\fR option, \fBamflush\fR stays in the foreground\&. This is useful if \fBamflush\fR is run as part of another script that, for example, advances the tape after the flush is completed\&.
45
46 .TP
47 \fB\-s\fR
48 Write log to stdout/stderr instead of the amflush log file\&. Requires the \fB\-f\fR option\&.
49
50 .TP
51 \fB\-D datestamp\fR
52 specify a datestamp expression you want to flush, see the ``\fBDATESTAMP EXPRESSION\fR'' section of \fBamanda\fR(8) for a description\&. \fB\-D 20001225\-7\fR will flush all dumps from 25 december 2000 to 27 december 2000\&.
53
54 .PP
55 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 ``\fBHOST & DISK EXPRESSION\fR'' section of \fBamanda\fR(8) for a description\&.
56
57 .PP
58 \fBAmflush\fR will look in the holding disks specified by the \fBamanda\&.conf\fR file in /usr/local/etc/amanda/\fBconfig\fR for any non\-empty \fBAMANDA\fR 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 \fBamdump\fR was run, e\&.g\&. 19910215\&.
59
60 .PP
61 See the \fBamanda\fR(8) man page for more details about \fBAMANDA\fR\&.
62
63 .SH "EXAMPLE"
64
65 .PP
66 \fBAmflush\fR will search for holding areas associated with the \fBdaily\fR configuration\&. After you select which holding area to flush, \fBamflush\fR writes the data to tape, updates the databases and sends a mail report similar to \fBamdump\fR(8)\&.
67 .nf
68
69 % amflush daily
70 Scanning /amanda\-hold\&.\&.\&.
71   20001113: found \fBAMANDA\fR directory\&.
72   20001114: found \fBAMANDA\fR directory\&.
73
74 Multiple \fBAMANDA\fR directories, please pick one by letter:
75   A\&. 20001113
76   B\&. 20001114
77 Select directories to flush [A\&.\&.B]: [ALL] all
78
79 Flushing dumps in 20001113, 20001114,
80 today: 20001117
81 to tape drive /dev/rmt/0mn\&.
82 Expecting tape DMP014 or a new tape\&.  (The last dumps were to tape DMP013)
83 Are you sure you want to do this? yes
84 Running in background, you can log off now\&.
85 You'll get mail when amflush is finished\&.
86 .fi
87
88 .SH "AUTHOR"
89
90 .PP
91 James da Silva, <jds@amanda\&.org> : Original text
92
93 .PP
94 Stefan G\&. Weichinger, <sgw@amanda\&.org>, maintainer of the \fBAMANDA\fR\-documentation: XML\-conversion
95
96 .SH "SEE ALSO"
97
98 .PP
99 \fBamanda\fR(8), \fBamdump\fR(8)
100