]> git.sur5r.net Git - bacula/docs/blob - docs/manuals/en/main/ansi-labels.tex
Add new features
[bacula/docs] / docs / manuals / en / main / ansi-labels.tex
1 \chapter{ANSI and IBM Tape Labels}
2 \label{AnsiLabelsChapter}
3 \index[general]{ANSI and IBM Tape Labels} 
4 \index[general]{Labels!Tape}
5
6 Bacula supports ANSI or IBM tape labels as long as you
7 enable it.  In fact, with the proper configuration, you can
8 force Bacula to require ANSI or IBM labels.
9
10 Bacula can create an ANSI or IBM label, but if Check Labels is
11 enabled (see below), Bacula will look for an existing label, and
12 if it is found, it will keep the label. Consequently, you
13 can label the tapes with programs other than Bacula, and Bacula
14 will recognize and support them.
15
16 Even though Bacula will recognize and write ANSI and IBM labels, 
17 it always writes its own tape labels as well.
18
19 When using ANSI or IBM tape labeling, you must restrict your Volume
20 names to a maximum of six characters.  
21
22 If you have labeled your Volumes outside of Bacula, then the
23 ANSI/IBM label will be recognized by Bacula only if you have created
24 the HDR1 label with {\bf BACULA.DATA} in the Filename field (starting
25 with character 5).  If Bacula writes the labels, it will use
26 this information to recognize the tape as a Bacula tape.  This allows
27 ANSI/IBM labeled tapes to be used at sites with multiple machines
28 and multiple backup programs.
29
30
31 \section{Director Pool Directive}
32
33 \begin{description}
34 \item [ Label Type = ANSI | IBM | Bacula]  
35   This directive is implemented in the Director Pool resource and in the SD Device
36   resource.  If it is specified in the SD Device resource, it will take
37   precedence over the value passed from the Director to the SD. The default
38   is Label Type = Bacula.
39 \end{description}
40
41 \section{Storage Daemon Device Directives}
42
43 \begin{description}
44 \item [ Label Type = ANSI | IBM | Bacula]  
45   This directive is implemented in the Director Pool resource and in the SD Device
46   resource.  If it is specified in the the SD Device resource, it will take
47   precedence over the value passed from the Director to the SD.
48  
49 \item [Check Labels = yes | no]
50   This directive is implemented in the the SD Device resource.  If you intend
51   to read ANSI or IBM labels, this *must* be set.  Even if the volume is
52   not ANSI labeled, you can set this to yes, and Bacula will check the
53   label type. Without this directive set to yes, Bacula will assume that
54   labels are of Bacula type and will not check for ANSI or IBM labels.
55   In other words, if there is a possibility of Bacula encountering an
56   ANSI/IBM label, you must set this to yes.
57 \end{description}