3 .\" Author: Olafur Gudmundsson <ogud@tis.com>
4 .\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
6 .\" Manual: System Administration Commands
7 .\" Source: Amanda 3.3.1
10 .TH "AMPLOT" "8" "02/21/2012" "Amanda 3\&.3\&.1" "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 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
25 .\" disable justification (adjust text to left margin only)
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
31 amplot \- visualize the behavior of Amanda
33 .HP \w'\fBamplot\fR\ 'u
34 \fBamplot\fR [\-b] [\-c] [\-e] [\-g] [\-l] [\-p] [\-t\ \fIT\fR] \fIamdump_files\fR
42 output file that Amanda generates each run (e\&.g\&.
43 \fIamdump\&.1\fR) and translates the information into a picture format that may be used to determine how your installation is doing and if any parameters need to be changed\&.
47 lines that it either does not understand or knows to be warning or error lines and a summary of the start, end and total time for each backup image\&.
50 is a shell script that executes an
53 (\fIamplot\&.awk\fR) to scan the
55 output file\&. It then executes a
58 (\fIamplot\&.g\fR) to generate the graph\&. The
60 program is written in an enhanced version of awk, such as GNU awk (\fBgawk\fR(1)
61 version 2\&.15 or later) or
66 generates a few temporary files that
68 uses\&. These files are deleted at the end of execution\&.
72 man page for more details about Amanda\&.
77 Generate b/w postscript file (need
90 Extend the X (time) axis if needed\&.
97 output directly to the X11 display (default)\&.
102 Direct postscript output to file
103 \fIYYYYMMDD\fR\fI\&.ps\fR
110 Generate landscape oriented output (needs
116 Set the right edge of the plot to be
123 may be in various compressed formats (\fIcompress\fR,
129 The figure is divided into a number of regions\&. There are titles on the top that show important statistical information about the configuration and from this execution of
130 \fBamdump\fR\&. In the figure, the X axis is time, with 0 being the moment
132 was started\&. The Y axis is divided into 5 regions:
135 How many backups have not been started, how many are waiting on space in the holding disk and how many have been transferred successfully to tape\&.
138 Percentage of allowed network bandwidth in use\&.
141 The higher line depicts space allocated on the holding disk to backups in progress and completed backups waiting to be written to tape\&. The lower line depicts the fraction of the holding disk containing completed backups waiting to be written to tape including the file currently being written to tape\&. The scale is percentage of the holding disk\&.
147 Percentage of active dumpers\&.
149 The idle period at the left of the graph is time
151 is asking the machines how much data they are going to dump\&. This process can take a while if hosts are down or it takes them a long time to generate estimates\&.
154 Reports lines it does not recognize, mainly error cases but some are legitimate lines the program needs to be taught about\&.
164 : http://wiki.zmanda.com/
167 \fBOlafur Gudmundsson\fR <\&ogud@tis\&.com\&>
169 Trusted Information Systems
172 \fBStefan G\&. Weichinger\fR <\&sgw@amanda\&.org\&>