Imported Upstream version 2.4.4p3
[debian/amanda] / docs / LABEL.PRINTING
1 New Feature
2 -----------
3 Amanda now has the ability to print postscript paper tape labels.  The
4 labels have what machines, partitions, and the level of the dump the
5 tape has on it.  This is achieved by adding the lbl-templ field to the
6 tapetype definition. Since the labels are specific to the type of tape
7 you have, that seemed to most logical place to add it.
8
9 You can also specify an alternate "printer" definition to print the
10 label to other than the system default printer.
11
12 If you don't add this line to your tapetype definition, amanda works
13 as it always has.
14
15 Labels provided
16 ---------------
17 The author has provided label templates for the following tape types.
18 These are pretty generic labels, and should be easy to customize for
19 other tape types. Others are encouraged to do so.
20
21 exabyte 8mm tapes
22 dat 4mm tapes
23 DLT tapes (in progress).
24
25
26 History
27 -------
28 At the University of Colorado at Boulder, we used to use some dump scripts
29 that printed out paper tape labels that went with the tape. When we started
30 using amanda for our dumps, my boss insisted we still generate them, in
31 case we weren't able to access the amanda database. The thought was that
32 as long as we had an amrestore binary on a machine, we could just look at
33 the label, grab the tapes, and do the restore.
34
35 As a result of this we have had to hack this feature into every
36 version of amanda from 2.1.1 through 2.4.0-prerelease.
37
38 Our hope in adding this feature is that others find it as useful as
39 we have.
40
41 How it works
42 ------------
43 The majority of the changes are in reporter.c. Just as you might run
44 the reporter by itself to see what the report will (or did) look like
45 with a logfile. When the reporter prints out the report, the postscript
46 label template is copied, and the successful machines, partitions, and
47 dump levels are appended to this. The output either goes to
48 /tmp/reporter.out.ps (when running in testing mode) or through a pipe
49 to the printer (default printer, if an alternate "printer" is not
50 specified).
51