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

   1 .\"     Title: amoverview
   2 .\"    Author: Stefan G. Weichinger <sgw@amanda.org>
   3 .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
   4 .\"      Date: 01/22/2009
   5 .\"    Manual: System Administration Commands
   6 .\"    Source: Amanda 2.6.1
   7 .\"  Language: English
   8 .\"
   9 .TH "AMOVERVIEW" "8" "01/22/2009" "Amanda 2\&.6\&.1" "System Administration Commands"
  10 .\" -----------------------------------------------------------------
  11 .\" * (re)Define some macros
  12 .\" -----------------------------------------------------------------
  13 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  14 .\" toupper - uppercase a string (locale-aware)
  15 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  16 .de toupper
  17 .tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ
  18 \\$*
  19 .tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz
  20 ..
  21 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  22 .\" SH-xref - format a cross-reference to an SH section
  23 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  24 .de SH-xref
  25 .ie n \{\
  26 .\}
  27 .toupper \\$*
  28 .el \{\
  29 \\$*
  30 .\}
  31 ..
  32 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  33 .\" SH - level-one heading that works better for non-TTY output
  34 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  35 .de1 SH
  36 .\" put an extra blank line of space above the head in non-TTY output
  37 .if t \{\
  38 .sp 1
  39 .\}
  40 .sp \\n[PD]u
  41 .nr an-level 1
  42 .set-an-margin
  43 .nr an-prevailing-indent \\n[IN]
  44 .fi
  45 .in \\n[an-margin]u
  46 .ti 0
  47 .HTML-TAG ".NH \\n[an-level]"
  48 .it 1 an-trap
  49 .nr an-no-space-flag 1
  50 .nr an-break-flag 1
  51 \." make the size of the head bigger
  52 .ps +3
  53 .ft B
  54 .ne (2v + 1u)
  55 .ie n \{\
  56 .\" if n (TTY output), use uppercase
  57 .toupper \\$*
  58 .\}
  59 .el \{\
  60 .nr an-break-flag 0
  61 .\" if not n (not TTY), use normal case (not uppercase)
  62 \\$1
  63 .in \\n[an-margin]u
  64 .ti 0
  65 .\" if not n (not TTY), put a border/line under subheading
  66 .sp -.6
  67 \l'\n(.lu'
  68 .\}
  69 ..
  70 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  71 .\" SS - level-two heading that works better for non-TTY output
  72 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  73 .de1 SS
  74 .sp \\n[PD]u
  75 .nr an-level 1
  76 .set-an-margin
  77 .nr an-prevailing-indent \\n[IN]
  78 .fi
  79 .in \\n[IN]u
  80 .ti \\n[SN]u
  81 .it 1 an-trap
  82 .nr an-no-space-flag 1
  83 .nr an-break-flag 1
  84 .ps \\n[PS-SS]u
  85 \." make the size of the head bigger
  86 .ps +2
  87 .ft B
  88 .ne (2v + 1u)
  89 .if \\n[.$] \&\\$*
  90 ..
  91 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  92 .\" BB/BE - put background/screen (filled box) around block of text
  93 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  94 .de BB
  95 .if t \{\
  96 .sp -.5
  97 .br
  98 .in +2n
  99 .ll -2n
 100 .gcolor red
 101 .di BX
 102 .\}
 103 ..
 104 .de EB
 105 .if t \{\
 106 .if "\\$2"adjust-for-leading-newline" \{\
 107 .sp -1
 108 .\}
 109 .br
 110 .di
 111 .in
 112 .ll
 113 .gcolor
 114 .nr BW \\n(.lu-\\n(.i
 115 .nr BH \\n(dn+.5v
 116 .ne \\n(BHu+.5v
 117 .ie "\\$2"adjust-for-leading-newline" \{\
 118 \M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
 119 .\}
 120 .el \{\
 121 \M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
 122 .\}
 123 .in 0
 124 .sp -.5v
 125 .nf
 126 .BX
 127 .in
 128 .sp .5v
 129 .fi
 130 .\}
 131 ..
 132 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 133 .\" BM/EM - put colored marker in margin next to block of text
 134 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 135 .de BM
 136 .if t \{\
 137 .br
 138 .ll -2n
 139 .gcolor red
 140 .di BX
 141 .\}
 142 ..
 143 .de EM
 144 .if t \{\
 145 .br
 146 .di
 147 .ll
 148 .gcolor
 149 .nr BH \\n(dn
 150 .ne \\n(BHu
 151 \M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[]
 152 .in 0
 153 .nf
 154 .BX
 155 .in
 156 .fi
 157 .\}
 158 ..
 159 .\" -----------------------------------------------------------------
 160 .\" * set default formatting
 161 .\" -----------------------------------------------------------------
 162 .\" disable hyphenation
 163 .nh
 164 .\" disable justification (adjust text to left margin only)
 165 .ad l
 166 .\" -----------------------------------------------------------------
 167 .\" * MAIN CONTENT STARTS HERE *
 168 .\" -----------------------------------------------------------------
 169 .SH "Name"
 170 amoverview \- display file systems processed by \fIAmanda\fR over time
 171 .SH "Synopsis"
 172 .fam C
 173 .HP \w'\fBamoverview\fR\ 'u
 174 \fBamoverview\fR [[\-config\ ]\ \fIconfig\fR] [\-hostwidth\ \fIwidth\fR] [\-diskwidth\ \fIwidth\fR] [\-skipmissed] [\-last] [\-num0] [\-togo0] [\-verbose]
 175 .fam
 176 .SH "DESCRIPTION"
 177 .PP
 178 \fBAmoverview\fR
 179 displays a chart showing hosts and file systems processed by
 180 \fIAmanda\fR
 181 along with the backup level performed each day\&.
 182 .PP
 183 See the
 184 \fBamanda\fR(8)
 185 man page for more details about
 186 \fIAmanda\fR\&.
 187 .SH "OPTIONS"
 188 .PP
 189 \fB\-config\fR \fIconfig\fR
 190 .RS 4
 191 Use configuration
 192 \fIconfig\fR
 193 instead of configuration daily\&.
 194 .RE
 195 .PP
 196 \fB\-hostwidth\fR \fIwidth\fR
 197 .RS 4
 198 Set
 199 \fBhost\fR
 200 field column width to
 201 \fIwidth\fR
 202 characters instead of 8\&.
 203 .RE
 204 .PP
 205 \fB\-diskwidth\fR \fIwidth\fR
 206 .RS 4
 207 Set
 208 \fBdisk\fR
 209 field column width to
 210 \fIwidth\fR
 211 characters instead of 20\&.
 212 .RE
 213 .PP
 214 \fB\-skipmissed\fR
 215 .RS 4
 216 Compacts the output by only printing stats for the days
 217 \fIAmanda\fR
 218 actually ran\&.
 219 .RE
 220 .PP
 221 \fB\-last\fR
 222 .RS 4
 223 Outputs the last status of each disk at the start\&. Useful for long tapecycles and/or sparse reports\&.
 224 .RE
 225 .PP
 226 \fB\-num0\fR
 227 .RS 4
 228 Outputs the number of level 0 dumps for each disk\&.
 229 .RE
 230 .PP
 231 \fB\-togo0\fR
 232 .RS 4
 233 Outputs the number of runs until the last level 0 dump is overwritten\&.
 234 .RE
 235 .PP
 236 \fB\-verbose\fR
 237 .RS 4
 238 \fBAmoverview\fR
 239 can take a long while on large systems\&. This option reports intermediate steps while it is working\&.
 240 .RE
 241 .SH "RESULTS"
 242 .PP
 243 \fBamoverview\fR
 244 is a summary of the output of "
 245 \fBamadmin <config> find\fR
 246 "\&. When the last column of
 247 \fBamadmin find\fR
 248 contains anything other than "OK", amoverview translates this into "E" for that day\&.
 249 .PP
 250 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\&.
 251 .PP
 252 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\&.
 253 .PP
 254 You can also have a double code if you have two tapes in the changer and
 255 \fIAmanda\fR
 256 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)\&.
 257 .SH "EXAMPLE"
 258 .PP
 259 This shows the
 260 \FC/home\F[]
 261 file system on
 262 \fIhost2\fR
 263 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\&.
 264 .nf
 265 # amoverview
 266                          date 12 12 12 12 12 12
 267 host     disk                 08 09 10 11 12 13
 268
 269 host1    /                     0  1  1  1  1  1
 270 host1    /var                  0  1  1  1  1  1
 271 host2    /                     1  1  1  1  1  0
 272 host2    /home                 3  3  3  0  1  2
 273 host2    /opt                  1  1  1  1  1  1
 274 host2    /var                  1  1  0  1  1  1
 275 .fi
 276 .SH "SEE ALSO"
 277 .PP
 278 \fBamadmin\fR(8),
 279 \fBamanda\fR(8),
 280 : http://wiki.zmanda.com
 281 .SH "Author"
 282 .PP
 283 \fBStefan G\&. Weichinger\fR <\&sgw@amanda\&.org\&>