git.sur5r.net Git - bacula/docs/blob - 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 \mbacula{} supports ANSI or IBM tape labels as long as you
   7 enable it.  In fact, with the proper configuration, you can
   8 force \mbacula{} to require ANSI or IBM labels.
   9
  10 \mbacula{} can create an ANSI or IBM label, but if Check Labels is
  11 enabled (see below), \mbacula{} 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 \mbacula{}, and \mbacula{}
  14 will recognize and support them.
  15
  16 Even though \mbacula{} 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 \mbacula{}, then the
  23 ANSI/IBM label will be recognized by \mbacula{} only if you have created
  24 the HDR1 label with {\bf BACULA.DATA} in the Filename field (starting
  25 with character 5).  If \mbacula{} writes the labels, it will use
  26 this information to recognize the tape as a \mbacula{} 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 \mbacula{} will check the
  53   label type. Without this directive set to yes, \mbacula{} 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 \mbacula{} encountering an
  56   ANSI/IBM label, you must set this to yes.
  57 \end{description}