Imported Upstream version 2.4.5
[debian/amanda] / man / amoverview.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 "AMOVERVIEW" 8 "" "" ""
21 .SH NAME
22 amoverview \- display file systems processed by AMANDA over time
23 .SH "SYNOPSIS"
24 .ad l
25 .hy 0
26 .HP 11
27 \fBamoverview\fR [[\-config]\ \fIconfig\fR] [\-hostwidth\ \fIwidth\fR] [\-diskwidth\ \fIwidth\fR] [\-skipmissed] [\-verbose]
28 .ad
29 .hy
30
31 .SH "DESCRIPTION"
32
33 .PP
34 \fBAmoverview\fR displays a chart showing hosts and file systems processed by \fBAMANDA\fR along with the backup level performed each day\&.
35
36 .PP
37 See the \fBamanda\fR(8) man page for more details about \fBAMANDA\fR\&.
38
39 .SH "OPTIONS"
40
41 .TP
42 \fB\-config\fR \fIconfig\fR
43 Use configuration \fBconfig\fR instead of configuration daily\&.
44
45 .TP
46 \fB\-hostwidth\fR \fIwidth\fR
47 Set \fBhost\fR field column width to \fBwidth\fR characters instead of 8\&.
48
49 .TP
50 \fB\-diskwidth\fR \fIwidth\fR
51 Set \fBdisk\fR field column width to \fBwidth\fR characters instead of 20\&.
52
53 .TP
54 \fB\-skipmissed\fR
55 Compacts the output by only printing stats for the days \fBAMANDA\fR actually ran\&.
56
57 .TP
58 \fB\-verbose\fR
59 \fBAmoverview\fR can take a long while on large systems\&. This option reports intermediate steps while it is working\&.
60
61 .SH "RESULTS"
62
63 .PP
64 \fBamoverview\fR is a summary of the output of " \fBamadmin <config> find\fR "\&. When the last column of \fBamadmin find\fR contains anything other than ``\fBOK\fR'', amoverview translates this into ``\fBE\fR'' for that day\&.
65
66 .PP
67 A number indicates the level of backup and it succeeded\&. An ``\fBE\fR'' indicates an error for that day\&. You get an ``\fBE\fR'' for all errors, like failed to connect, datatimeout, computer crashed, etc, but also for failing to write to tape\&.
68
69 .PP
70 You can have an ``\fBE\fR'' followed by a number if a filesystem ran into end\-of\-tape once (gives an ``\fBE\fR'', and later that day, you flush it to a second tape (a number: the level, indicating success)\&. If the flush failed too, you get a double ``\fBEE\fR'' for that day\&.
71
72 .PP
73 You can also have a double code if you have two tapes in the changer and \fBAMANDA\fR failed to write to tape the first time because it hit end of tape (resulting in ``\fBE0\fR'', for a full, ``\fBE1\fR'' for an incremental etc\&.) or twice with error (``\fBEE\fR''), and may a successful flush afterwards giving maybe ``\fBEE0\fR''\&. (Only the latest 2 characters are printed)\&.
74
75 .SH "EXAMPLE"
76
77 .PP
78 This shows the \fI/home\fR file system on \fBhost2\fR was backed up at level 3 on the 8th, 9th and 10th of December, had a full backup on the 11th, a level 1 on the 12th and a level 2 on the 13th\&.
79 .nf
80
81 # amoverview
82                          date 12 12 12 12 12 12
83 host     disk                 08 09 10 11 12 13
84  
85 host1    /                     0  1  1  1  1  1
86 host1    /var                  0  1  1  1  1  1
87 host2    /                     1  1  1  1  1  0
88 host2    /home                 3  3  3  0  1  2
89 host2    /opt                  1  1  1  1  1  1
90 host2    /var                  1  1  0  1  1  1 
91 .fi
92
93 .SH "SEE ALSO"
94
95 .PP
96 \fBamadmin\fR(8), \fBamanda\fR(8)
97