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