git.gag.com Git - debian/amanda/blob - man/amoverview.8

   1 '\" t
   2 .\"     Title: amoverview
   3 .\"    Author: Stefan G. Weichinger <sgw@amanda.org>
   4 .\" Generator: DocBook XSL Stylesheets vsnapshot_8273 <http://docbook.sf.net/>
   5 .\"      Date: 10/18/2010
   6 .\"    Manual: System Administration Commands
   7 .\"    Source: Amanda 3.2.0
   8 .\"  Language: English
   9 .\"
  10 .TH "AMOVERVIEW" "8" "10/18/2010" "Amanda 3\&.2\&.0" "System Administration Commands"
  11 .\" -----------------------------------------------------------------
  12 .\" * set default formatting
  13 .\" -----------------------------------------------------------------
  14 .\" disable hyphenation
  15 .nh
  16 .\" disable justification (adjust text to left margin only)
  17 .ad l
  18 .\" -----------------------------------------------------------------
  19 .\" * MAIN CONTENT STARTS HERE *
  20 .\" -----------------------------------------------------------------
  21 .SH "NAME"
  22 amoverview \- display file systems processed by Amanda over time
  23 .SH "SYNOPSIS"
  24 .HP \w'\fBamoverview\fR\ 'u
  25 \fBamoverview\fR [[\-\-config\ ]\ \fIconfig\fR] [\-\-hostwidth\ \fIwidth\fR] [\-\-diskwidth\ \fIwidth\fR] [\-\-skipmissed] [\-\-last] [\-\-num0] [\-\-togo0] [\-\-verbose]
  26 .SH "DESCRIPTION"
  27 .PP
  28 \fBAmoverview\fR
  29 displays a chart showing hosts and file systems processed by Amanda along with the backup level performed each day\&.
  30 .PP
  31 See the
  32 \fBamanda\fR(8)
  33 man page for more details about Amanda\&.
  34 .SH "OPTIONS"
  35 .PP
  36 \fB\-\-config\fR \fIconfig\fR
  37 .RS 4
  38 Use configuration
  39 \fIconfig\fR
  40 instead of configuration daily\&.
  41 .RE
  42 .PP
  43 \fB\-\-hostwidth\fR \fIwidth\fR
  44 .RS 4
  45 Set
  46 \fBhost\fR
  47 field column width to
  48 \fIwidth\fR
  49 characters instead of 8\&.
  50 .RE
  51 .PP
  52 \fB\-\-diskwidth\fR \fIwidth\fR
  53 .RS 4
  54 Set
  55 \fBdisk\fR
  56 field column width to
  57 \fIwidth\fR
  58 characters instead of 20\&.
  59 .RE
  60 .PP
  61 \fB\-\-skipmissed\fR
  62 .RS 4
  63 Compacts the output by only printing stats for the days Amanda actually ran\&.
  64 .RE
  65 .PP
  66 \fB\-\-last\fR
  67 .RS 4
  68 Outputs the last status of each disk at the start\&. Useful for long tapecycles and/or sparse reports\&.
  69 .RE
  70 .PP
  71 \fB\-\-num0\fR
  72 .RS 4
  73 Outputs the number of level 0 dumps for each disk\&.
  74 .RE
  75 .PP
  76 \fB\-\-togo0\fR
  77 .RS 4
  78 Outputs the number of runs until the last level 0 dump is overwritten\&.
  79 .RE
  80 .PP
  81 \fB\-\-verbose\fR
  82 .RS 4
  83 \fBAmoverview\fR
  84 can take a long while on large systems\&. This option reports intermediate steps while it is working\&.
  85 .RE
  86 .SH "RESULTS"
  87 .PP
  88 \fBamoverview\fR
  89 is a summary of the output of "
  90 \fBamadmin <config> find\fR
  91 "\&. When the last column of
  92 \fBamadmin find\fR
  93 contains anything other than "OK", amoverview translates this into "E" for that day\&.
  94 .PP
  95 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\&.
  96 .PP
  97 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\&.
  98 .PP
  99 You can also have a double code if you have two tapes in the changer and Amanda 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)\&.
 100 .SH "EXAMPLE"
 101 .PP
 102 This shows the
 103 /home
 104 file system on
 105 \fIhost2\fR
 106 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\&.
 107 .nf
 108 # amoverview
 109                          date 12 12 12 12 12 12
 110 host     disk                 08 09 10 11 12 13
 111
 112 host1    /                     0  1  1  1  1  1
 113 host1    /var                  0  1  1  1  1  1
 114 host2    /                     1  1  1  1  1  0
 115 host2    /home                 3  3  3  0  1  2
 116 host2    /opt                  1  1  1  1  1  1
 117 host2    /var                  1  1  0  1  1  1
 118 .fi
 119 .SH "SEE ALSO"
 120 .PP
 121 \fBamanda\fR(8),
 122 \fBamadmin\fR(8)
 123 .PP
 124 The Amanda Wiki:
 125 : http://wiki.zmanda.com/
 126 .SH "AUTHOR"
 127 .PP
 128 \fBStefan G\&. Weichinger\fR <\&sgw@amanda\&.org\&>