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 supports single or multiple drive
   7 autochangers by grouping one or more Device resources
   8 into one unit called an autochanger in Bacula (often referred to
   9 as a "tape library" by autochanger manufacturers).
  10
  11 \begin{description}
  12 \item [Name = \lt{}Autochanger-Name\gt{}]
  13    \index[sd]{Name}
  14    Specifies the Name of the Autochanger. This name is used in
  15    the Director's Storage definition to refer to the autochanger.
  16    This directive is required.
  17
  18 \item [Device = \lt{}Device-name1, device-name2, ...\gt{}]
  19    Specifies the names of the Device resource or
  20    resources that correspond
  21    to the autochanger drive.  If you have a multiple drive
  22    autochanger, you must specify multiple Device names, each
  23    one referring to a separate Device resource that contains a the
  24    Drive Index specification that corresponds to the drive
  25    number. You may specify multiple device names on
  26    a single line separated by commas, and/or you may specify
  27    multiple Device directives.
  28    This directive is required.
  29
  30 \item [Changer Device = {\it name-string}]
  31    \index[sd]{Changer Device}
  32    The specified {\bf name-string} gives the system file name of the  autochanger
  33    device name. If specified in this resource, the Changer Device name
  34    is not needed in the Device resource. If it is specified in the Device
  35    resource (see above), it will take precedence over one specified in
  36    the Autochanger resource.
  37
  38 \item [Changer Command = {\it name-string}]
  39    \index[sd]{Changer Command  }
  40    The {\bf name-string} specifies an external program to be called  that will
  41    automatically change volumes as required by {\bf Bacula}.  Most frequently,
  42    you will specify the Bacula supplied {\bf mtx-changer}  script as follows.
  43    If it is specified here, it need not be specified in the Device
  44    resource. If it is specified in the Device resource, it will take
  45    precedence over the one specified in the Autochanger resource.
  46
  47 \end{description}
  48
  49 The following is an example of a valid Autochanger resource definition:
  50
  51 \footnotesize
  52 \begin{verbatim}
  53 Autochanger {
  54   Name = "DDS-4-changer"
  55   Device = DDS-4-1, DDS-4-2, DDS-4-3
  56   Changer Device = /dev/sg0
  57   Changer Command = "/etc/bacula/mtx-changer %c %o %S %a %d"
  58 }
  59 Device {
  60   Name = "DDS-4-1"
  61   Drive Index = 0
  62   Autochanger = yes
  63   ...
  64 }
  65 Device {
  66   Name = "DDS-4-2"
  67   Drive Index = 1
  68   Autochanger = yes
  69   ...
  70 Device {
  71   Name = "DDS-4-3"
  72   Drive Index = 2
  73   Autochanger = yes
  74   Autoselect = no
  75   ...
  76 }
  77 \end{verbatim}
  78 \normalsize
  79
  80 Please note that it is important to include the {\bf Autochanger = yes} directive
  81 in each Device definition that belongs to an Autochanger.  A device definition
  82 should not belong to more than one Autochanger resource.  Also, your Device
  83 directive in the Storage resource of the Director's conf file should have
  84 the Autochanger's resource name rather than a name of one of the Devices.
  85
  86 If you have a drive that physically belongs to an Autochanger but you don't want
  87 to have it automatically used when Bacula references the Autochanger for backups,
  88 for example, you want to reserve it for restores, you can add the directive:
  89
  90 \footnotesize
  91 \begin{verbatim}
  92 Autoselect = no
  93 \end{verbatim}
  94 \normalsize
  95
  96 to the Device resource for that drive. In that case, Bacula will not automatically
  97 select that drive when accessing the Autochanger. You can, still use the drive
  98 by referencing it by the Device name rather than the Autochanger name. An example
  99 of such a definition is shown above for the Device DDS-4-3, which will not be
 100 selected when the name DDS-4-changer is used in a Storage definition, but will
 101 be used if DDS-4-3 is used.