]> git.sur5r.net Git - bacula/docs/blob - docs/manual/autochangerres.tex
Updates
[bacula/docs] / 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.