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