1AMANDA-CLIENT.CON(5) File formats and conventions AMANDA-CLIENT.CON(5)
2
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 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 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 index_server string
32 Default: Set by configure. The amindexd server amrecover will
33 connect to.
34 tape_server string
36 Default: Set by configure. The amidxtaped server amrecover will
37 connect to.
38 tapedev string
40 Default: Set by configure. The tapedev amrecover will use.
41 auth string
43 Default: bsd. Type of authorization to perform between tape server
44 and backup client hosts.
45 bsd, bsd authorization with udp initial connection and one tcp
47 connection by data stream.
48 bsdtcp, bsd authorization but use only one tcp connection.
50 bsdudp, like bsd, but will use only one tcp connection for all data
52 stream.
53 krb4 to use Kerberos-IV authorization.
55 krb5 to use Kerberos-V authorization.
57 local, if the client is the server, it doesn´t require authencation
59 setup.
60 rsh to use rsh authorization.
62 ssh to use OpenSSH authorization.
64 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 gnutar_list_dir string
71 Default from configure --with-gnutar-listdir=DIR. The directory
72 where gnutar keep its state file.
73 mailer string
75 Default found by configure. A mail program that can send mail with
76 ´MAILER -s "subject" user < message_file´.
77 amandates string
79 Default: /etc/amandates. The file where amanda keep the last date
80 of each dumplevel.
81 connect_tries int
83 Default: 3. How many times the server will try a connection.
84 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 debug_amandad int
90 Default: 0. Debug level of the amandad process
91 debug_amidxtaped int
93 Default: 0. Debug level of the amidxtaped process
94 debug_amindexd int
96 Default: 0. Debug level of the amindexd process
97 debug_amrecover int
99 Default: 0. Debug level of the amrecover process
100 debug_auth int
102 Default: 0. Debug level of the auth module
103 debug_event int
105 Default: 0. Debug level of the event module
106 debug_holding int
108 Default: 0. Debug level of the holdingdisk module
109 debug_protocol int
111 Default: 0. Debug level of the protocol module
112 debug_selfcheck int
114 Default: 0. Debug level of the selfcheck process
115 debug_sendsize int
117 Default: 0. Debug level of the sendsize process
118 debug_sendbackup int
120 Default: 0. Debug level of the sendbackup process
121 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 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 unreserved-tcp-port int,int
131 Default: --with-tcpportrange or 1025,65536. Unreserved tcp port
132 that will be used (bsd, bsdudp)
133 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 name is the name of this type of application. It is referenced from the
149 dumptype
150 The application-tool options and values are:
152 comment string
154 Default: none. A comment string describing this application.
155 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 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 name is the name of this type of script. It is referenced from the
178 dumptype
179 The script-tool options and values are:
181 comment string
183 Default: none. A comment string describing this script.
184 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 execute_where [client|server]
191 Default: client. Where the script must be executed, on the client
192 or server. Only client is valid.
193 execute_on execute_on[,execute_on]*
195 No default. When the script must be executed, you can specify many
196 of them:
197 pre-dle-amcheck
199 Execute before the amcheck command for the dle.
200 pre-host-amcheck
202 Execute before the amcheck command for all dle for the client.
203 post-dle-amcheck
205 Execute after the amcheck command for the dle.
206 post-host-amcheck
208 Execute after the amcheck command for all dle for the client.
209 pre-dle-estimate
211 Execute before the estimate command for the dle.
212 pre-host-estimate
214 Execute before the estimate command for all dle for the client.
215 post-dle-estimate
217 Execute after the estimate command for the dle.
218 post-host-estimate
220 Execute after the estimate command for all dle for the client.
221 pre-dle-backup
223 Execute before the backup command for the dle.
224 pre-host-backup
226 Execute before the backup command for all dle for the client.
227 post-dle-backup
229 Execute after the backup command for the dle.
230 post-host-backup
232 Execute after the backup command for all dle for the client.
233 pre-recover
235 Execute before any level is recovered.
236 post-recover
238 Execute after all levels are recovered.
239 pre-level-recover
241 Execute before each level recovery.
242 post-level-recover
244 Execute after each level recovery.
245 inter-level-recover
247 Execute between two levels of recovery.
248 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 Stefan G. Weichinger <sgw@amanda.org>
265Amanda 2.6.1p2 11/05/2009 AMANDA-CLIENT.CON(5)