git.sur5r.net Git - bacula/docs/blob - docs/manual/autochangerres.tex

   1 \subsection*{Autochanger Resource}
   2 \index[sd]{Autochanger Resource }
   3 \index[sd]{Resource!Autochanger }
   4 \addcontentsline{toc}{subsection}{Autochanger Resource}
   5
   6 The Autochanger resource serves to group one or more Device resources
   7 into one unit called an autochanger in Bacula (referred to
   8 as a tape library by autochanger manufacturers).
   9
  10 \begin{description}
  11 \item [Name = \lt{}Autochanger-Name\gt{}]
  12    \index[sd]{Name}
  13    Specifies the Name of the Autochanger. This name is used in
  14    the Director's Storage definition to refer to the autochanger.
  15    This directive is required.
  16
  17 \item [Device = \lt{}Device-name1, device-name2, ...\gt{}]
  18    Specifies the names of the Device resource that corresponds
  19    to the autochanger drive.  If you have a multiple drive
  20    autochanger, you must specify multiple Device names, each
  21    one referring to a Device resource that contains a the
  22    Drive Index specification that corresponds to the drive
  23    number. You may specify multiple device names on
  24    a single line separated by commas, and/or you may specify
  25    multiple Device directives.
  26    This directive is required.
  27
  28 \item [Changer Device = {\it name-string}]
  29    \index[sd]{Changer Device}
  30    The specified {\bf name-string} gives the system file name of the  autochanger
  31    device name. If specified in this resource, the Changer Device name
  32    is not needed in the Device resource. If it is specified in the Device
  33    resource (see above), it will take precidence over one specified in
  34    the Autochanger resource.
  35
  36 \item [Changer Command = {\it name-string}]
  37    \index[sd]{Changer Command  }
  38    The {\bf name-string} specifies an external program to be called  that will
  39    automatically change volumes as required by {\bf Bacula}.  Most frequently,
  40    you will specify the Bacula supplied {\bf mtx-changer}  script as follows.
  41    If it is specified here, it need not be specified in the Device
  42    resource. If it is specified in the Device resource, it will take
  43    precidence over the one specified in the Autochanger resource.
  44
  45 \end{description}
  46
  47 The following is an example of a valid Autochanger resource definition:
  48
  49 \footnotesize
  50 \begin{verbatim}
  51 Autochanger {
  52   Name = "DDS-4-changer"
  53   Device = DDS-4-1, DDS-4-2
  54   Changer Device = /dev/sg0
  55   Changer Command = "/etc/bacula/mtx-changer %c %o %S %a %d"
  56 }
  57 Device {
  58   Name = "DDS-4-1"
  59   Drive Index = 0
  60   ...
  61 }
  62 Device {
  63   Name = "DDS-4-2"
  64   Drive Index = 1
  65   ...
  66 }
  67 \end{verbatim}
  68 \normalsize