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