1AMANDA-CLIENT.CON(5) File formats and conventions AMANDA-CLIENT.CON(5)
2
3
4
6 amanda-client.conf - Client configuration file for Amanda, the Advanced
7 Maryland Automatic Network Disk Archiver
8
10 amanda-client.conf(5) is the client configuration file for Amanda. This
11 manpage lists the relevant sections and parameters of this file for
12 quick reference.
13
14 The files <CONFIG_DIR>/amanda-client.conf and
15 <CONFIG_DIR>/<config>/amanda-client.conf are loaded.
16
18 The syntax of amanda-client.conf(5) is identical to that for
19 amanda.conf(5).
20
22 conf string
23 Default: Set by configure. The conf use by amrecover.
24
25 client_username string
26 Default: CLIENT_LOGIN. Similar to the parameter of the same name in
27 amanda.conf(5), this specifies the username that amrecover should
28 send when connecting to the server. It should match the username
29 specified in .amandahosts on the server.
30
31 index_server string
32 Default: Set by configure. The amindexd server amrecover will
33 connect to.
34
35 tape_server string
36 Default: Set by configure. The amidxtaped server amrecover will
37 connect to.
38
39 tapedev string
40 Default: Set by configure. The tapedev amrecover will use.
41
42 auth string
43 Default: bsd. Type of authorization to perform between tape server
44 and backup client hosts.
45
46 bsd, bsd authorization with udp initial connection and one tcp
47 connection by data stream.
48
49 bsdtcp, bsd authorization but use only one tcp connection.
50
51 bsdudp, like bsd, but will use only one tcp connection for all data
52 stream.
53
54 krb4 to use Kerberos-IV authorization.
55
56 krb5 to use Kerberos-V authorization.
57
58 local, if the client is the server, it doesn´t require authencation
59 setup.
60
61 rsh to use rsh authorization.
62
63 ssh to use OpenSSH authorization.
64
65 ssh_keys string
66 Default: No default. The key file the ssh auth will use, it must be
67 the private key. If this parameter is not specified, then the
68 default ssh key will be used.
69
70 gnutar_list_dir string
71 Default from configure --with-gnutar-listdir=DIR. The directory
72 where gnutar keep its state file.
73
74 mailer string
75 Default found by configure. A mail program that can send mail with
76 ´MAILER -s "subject" user < message_file´.
77
78 amandates string
79 Default: /etc/amandates. The file where amanda keep the last date
80 of each dumplevel.
81
82 connect_tries int
83 Default: 3. How many times the server will try a connection.
84
85 rep_tries int
86 Default: 5. How many times amandad will resend a REP packet if it
87 doesn´t get the ACK packet.
88
89 debug_amandad int
90 Default: 0. Debug level of the amandad process
91
92 debug_amidxtaped int
93 Default: 0. Debug level of the amidxtaped process
94
95 debug_amindexd int
96 Default: 0. Debug level of the amindexd process
97
98 debug_amrecover int
99 Default: 0. Debug level of the amrecover process
100
101 debug_auth int
102 Default: 0. Debug level of the auth module
103
104 debug_event int
105 Default: 0. Debug level of the event module
106
107 debug_holding int
108 Default: 0. Debug level of the holdingdisk module
109
110 debug_protocol int
111 Default: 0. Debug level of the protocol module
112
113 debug_selfcheck int
114 Default: 0. Debug level of the selfcheck process
115
116 debug_sendsize int
117 Default: 0. Debug level of the sendsize process
118
119 debug_sendbackup int
120 Default: 0. Debug level of the sendbackup process
121
122 reserved-udp-port int,int
123 Default: --with-udpportrange or 512,1023. Reserved udp port that
124 will be used (amrecover with bsd or bsdudp)
125
126 reserved-tcp-port int,int
127 Default: --with-low-tcpportrange or 512,1023. Reserved tcp port
128 that will be used (amrecover with bsdtcp)
129
130 unreserved-tcp-port int,int
131 Default: --with-tcpportrange or 1025,65536. Unreserved tcp port
132 that will be used (bsd, bsdudp)
133
134 property "name" "value"
135 Adds a global property for this client host, useful for e.g.,
136 Application API plugins.
137
139 The amanda.conf file may define multiple types of application. The
140 information is entered in a application-tool section, which looks like
141 this:
142 define application-tool "name" {
143 application-option appli
144 cation-value
145 ...
146 }
147
148 name is the name of this type of application. It is referenced from the
149 dumptype
150
151 The application-tool options and values are:
152
153 comment string
154 Default: none. A comment string describing this application.
155
156 plugin string
157 No default. Must be set to the name of the program. This program
158 must be in the $libexecdir/amanda/application directory on the
159 client.
160
161 property [append] [priority] string string+
162 No default. You can set property for the application, each
163 application have a different set of property. Both strings are
164 quoted; the first string contains the name of the property to set,
165 and the others contains its values. append keyword append the
166 values to the list of values for that property. priority keyword
167 disallow the setting of that property on the server.
168
170 The amanda.conf file may define multiple types of script. The
171 information is entered in a script-tool section, which looks like this:
172 define script-tool "name" {
173 script-option script-value
174 ...
175 }
176
177 name is the name of this type of script. It is referenced from the
178 dumptype
179
180 The script-tool options and values are:
181
182 comment string
183 Default: none. A comment string describing this script.
184
185 plugin string
186 No default. Must be set to the name of the program. This program
187 must be in the $libdir/amanda/application directory on the client
188 and/or server.
189
190 execute_where [client|server]
191 Default: client. Where the script must be executed, on the client
192 or server. Only client is valid.
193
194 execute_on execute_on[,execute_on]*
195 No default. When the script must be executed, you can specify many
196 of them:
197
198 pre-dle-amcheck
199 Execute before the amcheck command for the dle.
200
201 pre-host-amcheck
202 Execute before the amcheck command for all dle for the client.
203
204 post-dle-amcheck
205 Execute after the amcheck command for the dle.
206
207 post-host-amcheck
208 Execute after the amcheck command for all dle for the client.
209
210 pre-dle-estimate
211 Execute before the estimate command for the dle.
212
213 pre-host-estimate
214 Execute before the estimate command for all dle for the client.
215
216 post-dle-estimate
217 Execute after the estimate command for the dle.
218
219 post-host-estimate
220 Execute after the estimate command for all dle for the client.
221
222 pre-dle-backup
223 Execute before the backup command for the dle.
224
225 pre-host-backup
226 Execute before the backup command for all dle for the client.
227
228 post-dle-backup
229 Execute after the backup command for the dle.
230
231 post-host-backup
232 Execute after the backup command for all dle for the client.
233
234 pre-recover
235 Execute before any level is recovered.
236
237 post-recover
238 Execute after all levels are recovered.
239
240 pre-level-recover
241 Execute before each level recovery.
242
243 post-level-recover
244 Execute after each level recovery.
245
246 inter-level-recover
247 Execute between two levels of recovery.
248
249 property [append] [priority] string string+
250 No default. You can set property for the script, each script have a
251 different set of property. Both strings are quoted; the first
252 string contains the name of the property to set, and the others
253 contains its values. append keyword append the values to the list
254 of values for that property. priority keyword disallow the setting
255 of that property on the server.
256
258 amanda(8), amanda.conf(5), amcrypt(8), aespipe(1), :
259 http://wiki.zmanda.com
260
262 James da Silva <jds@amanda.org>
263
264 Stefan G. Weichinger <sgw@amanda.org>
265
266
267
268Amanda 2.6.1p2 11/05/2009 AMANDA-CLIENT.CON(5)