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

   1 .\"
   2 .de EX
   3 .if t .ft C
   4 .nf
   5 ..
   6 .de EE
   7 .fi
   8 .if t .ft
   9 ..
  10 .de OP
  11 \fB\\$1\fP \fI\\$2\fP
  12 ..
  13 .TH AMOVERVIEW 8
  14 .SH NAME
  15 amoverview \- display file systems processed by Amanda over time
  16 .SH SYNOPSIS
  17 .B amoverview
  18 [[
  19 .B -config
  20 ]
  21 .I config
  22 ] [
  23 .OP -hostwidth width
  24 ] [
  25 .OP -diskwidth width
  26 ] [
  27 .B -verbose
  28 ]
  29 .SH DESCRIPTION
  30 .B Amoverview
  31 displays a chart showing hosts and file systems processed by Amanda
  32 along with the backup level performed each day.
  33 .LP
  34 See the
  35 .IR amanda (8)
  36 man page for more details about Amanda.
  37 .SH OPTIONS
  38 .TP
  39 .OP -config config
  40 Use configuration
  41 .I config
  42 instead of @DEFAULT_CONFIG@.
  43 .TP
  44 .OP -hostwidth width
  45 Set
  46 .B host
  47 field column width to
  48 .I width
  49 characters instead of eight.
  50 .TP
  51 .OP -diskwidth width
  52 Set
  53 .B disk
  54 field column width to
  55 .I width
  56 characters instead of 20.
  57 .TP
  58 .B -verbose
  59 .B Amoverview
  60 can take a long while on large systems.
  61 This option reports intermediate steps while it is working.
  62 .SH RESULTS
  63 .B amoverview
  64 is a summary of the output of "
  65 .B amadmin <config> find
  66 ".
  67 When the last column of
  68 .B amadmin find
  69 contains anything other than "OK",
  70 amoverview translates this into 'E' for that day.
  71
  72 A number indicates the level of backup and it succeeded.
  73 An "E" indicates an error for that day.
  74 You get an 'E' for all errors, like failed to connect, datatimeout,
  75 computer crashed, etc, but also for failing to write to tape.
  76
  77 You can have an "E" followed by a number if a filesystem ran into
  78 end-of-tape once (gives an 'E', and later that day, you flush it to a
  79 second tape (a number: the level, indicating success).  If the flush
  80 failed too, you get a double "EE" for that day.
  81
  82 You can also have a double code if you have two tapes in the changer and
  83 amanda failed to write to tape the first time because it hit end of tape
  84 (resulting in "E0", for a full, "E1" for an incremental etc)
  85 or twice with error ("EE"), and may a successfull flush afterwards
  86 giving maybe "EE0".  (Only the latest 2 characters are printed).
  87 .SH EXAMPLE
  88 This shows the
  89 .I /home
  90 file system on
  91 .I host2
  92 was backed up at level 3 on the 8th, 9th and 10th of December,
  93 had a full backup on the 11th,
  94 a level 1 on the 12th and a level 2 on the 13th.
  95 .LP
  96 .RS
  97 .EX
  98 # amoverview
  99                          date 12 12 12 12 12 12
 100 host     disk                 08 09 10 11 12 13
 101
 102 host1    /                     0  1  1  1  1  1
 103 host1    /var                  0  1  1  1  1  1
 104 host2    /                     1  1  1  1  1  0
 105 host2    /home                 3  3  3  0  1  2
 106 host2    /opt                  1  1  1  1  1  1
 107 host2    /var                  1  1  0  1  1  1
 108 .EE
 109 .RE
 110 .SH "SEE ALSO"
 111 amadmin(8),
 112 amanda(8)