1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
3 "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
5 <!-- entities files to use -->
6 <!ENTITY % global_entities SYSTEM '../entities/global.entities'>
10 <!-- lifted from troff+man by doclifter -->
11 <refentry id='amoverview.8'>
14 <refentrytitle>amoverview</refentrytitle>
15 <manvolnum>8</manvolnum>
18 <refname>amoverview</refname>
19 <refpurpose>display file systems processed by &A; over time</refpurpose>
21 <!-- body begins here -->
24 <command>amoverview</command>
25 <arg choice='opt'><arg choice='opt'>-config </arg><arg choice='plain'><replaceable>config</replaceable></arg></arg>
26 <arg choice='opt'>-hostwidth <replaceable>width</replaceable></arg>
27 <arg choice='opt'>-diskwidth <replaceable>width</replaceable></arg>
28 <arg choice='opt'>-skipmissed</arg>
29 <arg choice='opt'>-last</arg>
30 <arg choice='opt'>-num0</arg>
31 <arg choice='opt'>-togo0</arg>
32 <arg choice='opt'>-verbose</arg>
37 <refsect1><title>DESCRIPTION</title>
38 <para><emphasis remap='B'>Amoverview</emphasis>
39 displays a chart showing hosts and file systems processed by &A;
40 along with the backup level performed each day.</para>
43 <citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry>
44 man page for more details about &A;.</para>
47 <refsect1><title>OPTIONS</title>
48 <variablelist remap='TP'>
50 <term><option>-config</option> <replaceable>config</replaceable></term>
52 <para>Use configuration
53 <emphasis remap='I'>config</emphasis>
54 instead of configuration daily.</para>
58 <term><option>-hostwidth</option> <replaceable>width</replaceable></term>
61 <emphasis remap='B'>host</emphasis>
63 <emphasis remap='I'>width</emphasis>
64 characters instead of 8.</para>
68 <term><option>-diskwidth</option> <replaceable>width</replaceable></term>
71 <emphasis remap='B'>disk</emphasis>
73 <emphasis remap='I'>width</emphasis>
74 characters instead of 20.</para>
78 <term><option>-skipmissed</option></term>
80 <para>Compacts the output by only printing stats
81 for the days &A; actually ran.
87 <term><option>-last</option></term>
90 Outputs the last status of each disk at the start.
91 Useful for long tapecycles and/or sparse reports.
97 <term><option>-num0</option></term>
100 Outputs the number of level 0 dumps for each disk.
106 <term><option>-togo0</option></term>
109 Outputs the number of runs until the last level 0 dump is overwritten.
115 <term><option>-verbose</option></term>
117 <para><emphasis remap='B'>Amoverview</emphasis>
118 can take a long while on large systems.
119 This option reports intermediate steps while it is working.</para>
125 <refsect1><title>RESULTS</title>
126 <para><command>amoverview</command>
127 is a summary of the output of "
128 <emphasis remap='B'>amadmin <config> find</emphasis>
130 When the last column of
131 <emphasis remap='B'>amadmin find</emphasis>
132 contains anything other than "OK",
133 amoverview translates this into "E" for that day.</para>
135 <para>A number indicates the level of backup and it succeeded.
136 An "E" indicates an error for that day.
137 You get an "E" for all errors, like failed to connect, datatimeout,
138 computer crashed, etc, but also for failing to write to tape.</para>
140 <para>You can have an "E" followed by a number if a filesystem ran into
141 end-of-tape once (gives an "E", and later that day, you flush it to a
142 second tape (a number: the level, indicating success). If the flush
143 failed too, you get a double "EE" for that day.</para>
145 <para>You can also have a double code if you have two tapes in the changer and
146 &A; failed to write to tape the first time because it hit end of tape
147 (resulting in "E0", for a full, "E1" for an
149 or twice with error ("EE"), and may a successful flush afterwards
150 giving maybe "EE0". (Only the latest 2 characters are printed).</para>
153 <refsect1><title>EXAMPLE</title>
155 <filename>/home</filename>
157 <emphasis remap='I'>host2</emphasis>
158 was backed up at level 3 on the 8th, 9th and 10th of December,
159 had a full backup on the 11th,
160 a level 1 on the 12th and a level 2 on the 13th.</para>
162 <programlisting remap='.nf'>
164 date 12 12 12 12 12 12
165 host disk 08 09 10 11 12 13
168 host1 /var 0 1 1 1 1 1
170 host2 /home 3 3 3 0 1 2
171 host2 /opt 1 1 1 1 1 1
172 host2 /var 1 1 0 1 1 1
176 <refsect1><title>SEE ALSO</title>
177 <para><citerefentry><refentrytitle>amadmin</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
178 <citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
179 <ulink url="http://wiki.zmanda.com"/>