git.gag.com Git - debian/amanda/blob - 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] [\-last] [\-num0] [\-togo0] [\-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\-last\fR
  59 Outputs the last status of each disk at the start\&. Useful for long tapecycles and/or sparse reports\&.
  60
  61 .TP
  62 \fB\-num0\fR
  63 Outputs the number of level 0 dumps for each disk\&.
  64
  65 .TP
  66 \fB\-togo0\fR
  67 Outputs the number of runs until the last level 0 dump is overwritten\&.
  68
  69 .TP
  70 \fB\-verbose\fR
  71 \fBAmoverview\fR can take a long while on large systems\&. This option reports intermediate steps while it is working\&.
  72
  73 .SH "RESULTS"
  74
  75 .PP
  76 \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 "OK", amoverview translates this into "E" for that day\&.
  77
  78 .PP
  79 A number indicates the level of backup and it succeeded\&. An "E" indicates an error for that day\&. You get an "E" for all errors, like failed to connect, datatimeout, computer crashed, etc, but also for failing to write to tape\&.
  80
  81 .PP
  82 You can have an "E" followed by a number if a filesystem ran into end\-of\-tape once (gives an "E", 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 "EE" for that day\&.
  83
  84 .PP
  85 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 "E0", for a full, "E1" for an incremental etc\&.) or twice with error ("EE"), and may a successful flush afterwards giving maybe "EE0"\&. (Only the latest 2 characters are printed)\&.
  86
  87 .SH "EXAMPLE"
  88
  89 .PP
  90 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\&.
  91 .nf
  92
  93 # amoverview
  94                          date 12 12 12 12 12 12
  95 host     disk                 08 09 10 11 12 13
  96
  97 host1    /                     0  1  1  1  1  1
  98 host1    /var                  0  1  1  1  1  1
  99 host2    /                     1  1  1  1  1  0
 100 host2    /home                 3  3  3  0  1  2
 101 host2    /opt                  1  1  1  1  1  1
 102 host2    /var                  1  1  0  1  1  1
 103 .fi
 104
 105 .SH "SEE ALSO"
 106
 107 .PP
 108 \fBamadmin\fR(8), \fBamanda\fR(8)
 109