Imported Upstream version 2.4.5
[debian/amanda] / docs / labelprinting.txt
1
2            Chapter 11. Printing of Labels
3 Prev  Part II. About Tapes and Changers  Next
4
5 -------------------------------------------------------------------------------
6
7 Chapter 11. Printing of Labels
8
9
10 Stefan G. Weichinger
11
12 XML-conversion;Updates
13 AMANDA Core Team
14 <sgw@amanda.org>
15 Table of Contents
16
17
18   The_New_Feature
19
20   Labels_provided
21
22   History
23
24   How_it_works
25
26
27 Note
28
29 Refer to http://www.amanda.org/docs/labelprinting.html for the current version
30 of this document.
31
32  The New Feature
33
34 AMANDA now has the ability to print postscript paper tape labels. The labels
35 have what machines, partitions, and the level of the dump the tape has on it.
36 This is achieved by adding the lbl-templ field to the tapetype definition.
37 Since the labels are specific to the type of tape you have, that seemed to most
38 logical place to add it.
39 You can also specify an alternate "printer" definition to print the label to
40 other than the system default printer.
41 If you don't add this line to your tapetype definition, AMANDA works as it
42 always has.
43
44  Labels provided
45
46 The author has provided label templates for the following tape types. These are
47 pretty generic labels, and should be easy to customize for other tape types.
48 Others are encouraged to do so.
49
50 * Exabyte 8mm tapes
51 * DDS 4mm tapes
52 * DLT tapes (in progress).
53
54
55  History
56
57 At the University of Colorado at Boulder, we used to use some dump scripts that
58 printed out paper tape labels that went with the tape. When we started using
59 AMANDA for our dumps, my boss insisted we still generate them, in case we
60 weren't able to access the AMANDA database. The thought was that as long as we
61 had an amrestore binary on a machine, we could just look at the label, grab the
62 tapes, and do the restore.
63 As a result of this we have had to hack this feature into every version of
64 AMANDA from 2.1.1 through 2.4.0-prerelease.
65 Our hope in adding this feature is that others find it as useful as we have.
66
67  How it works
68
69 The majority of the changes are in reporter.c. Just as you might run the
70 reporter by itself to see what the report will (or did) look like with a
71 logfile. When the reporter prints out the report, the postscript label template
72 is copied, and the successful machines, partitions, and dump levels are
73 appended to this. The output either goes to /tmp/reporter.out.ps (when running
74 in testing mode) or through a pipe to the printer (default printer, if an
75 alternate "printer" is not specified).
76 -------------------------------------------------------------------------------
77
78 Prev                                                    Up               Next
79 Chapter 10. RAIT (Redundant Array of Inexpensive Tape) Home  Part III. HOWTOs
80 Support 
81