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: 06/02/2011
   6 .\"    Manual: System Administration Commands
   7 .\"    Source: Amanda 3.3.0
   8 .\"  Language: English
   9 .\"
  10 .TH "AMOVERVIEW" "8" "06/02/2011" "Amanda 3\&.3\&.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 [\-\-hostwidth\ \fIwidth\fR] [\-\-diskwidth\ \fIwidth\fR] [\-\-skipmissed] [\-\-last] [\-\-num0] [\-\-togo0] [\-\-verbose] [\-\-config\ ]\ \fIconfig\fR
  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 .RE
  41 .PP
  42 \fB\-\-hostwidth\fR \fIwidth\fR
  43 .RS 4
  44 Set
  45 \fBhost\fR
  46 field column width to
  47 \fIwidth\fR
  48 characters instead of 8\&.
  49 .RE
  50 .PP
  51 \fB\-\-diskwidth\fR \fIwidth\fR
  52 .RS 4
  53 Set
  54 \fBdisk\fR
  55 field column width to
  56 \fIwidth\fR
  57 characters instead of 20\&.
  58 .RE
  59 .PP
  60 \fB\-\-skipmissed\fR
  61 .RS 4
  62 Compacts the output by only printing stats for the days Amanda actually ran\&.
  63 .RE
  64 .PP
  65 \fB\-\-last\fR
  66 .RS 4
  67 Outputs the last status of each disk at the start\&. Useful for long tapecycles and/or sparse reports\&.
  68 .RE
  69 .PP
  70 \fB\-\-num0\fR
  71 .RS 4
  72 Outputs the number of level 0 dumps for each disk\&.
  73 .RE
  74 .PP
  75 \fB\-\-togo0\fR
  76 .RS 4
  77 Outputs the number of runs until the last level 0 dump is overwritten\&.
  78 .RE
  79 .PP
  80 \fB\-\-verbose\fR
  81 .RS 4
  82 \fBAmoverview\fR
  83 can take a long while on large systems\&. This option reports intermediate steps while it is working\&.
  84 .RE
  85 .SH "RESULTS"
  86 .PP
  87 \fBamoverview\fR
  88 is a summary of the output of "
  89 \fBamadmin <config> find\fR
  90 "\&. When the last column of
  91 \fBamadmin find\fR
  92 contains anything other than "OK", amoverview translates this into "E" for that day\&.
  93 .PP
  94 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\&.
  95 .PP
  96 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\&.
  97 .PP
  98 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)\&.
  99 .SH "EXAMPLE"
 100 .PP
 101 This shows the
 102 /home
 103 file system on
 104 \fIhost2\fR
 105 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\&.
 106 .nf
 107 # amoverview
 108                          date 12 12 12 12 12 12
 109 host     disk                 08 09 10 11 12 13
 110
 111 host1    /                     0  1  1  1  1  1
 112 host1    /var                  0  1  1  1  1  1
 113 host2    /                     1  1  1  1  1  0
 114 host2    /home                 3  3  3  0  1  2
 115 host2    /opt                  1  1  1  1  1  1
 116 host2    /var                  1  1  0  1  1  1
 117 .fi
 118 .SH "SEE ALSO"
 119 .PP
 120 \fBamanda\fR(8),
 121 \fBamadmin\fR(8)
 122 .PP
 123 The Amanda Wiki:
 124 : http://wiki.zmanda.com/
 125 .SH "AUTHOR"
 126 .PP
 127 \fBStefan G\&. Weichinger\fR <\&sgw@amanda\&.org\&>