1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
3 "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
5 <!-- entities files to use -->
6 <!ENTITY % global_entities SYSTEM 'global.entities'>
10 <refentry id='amanda-client.conf.5'>
13 <refentrytitle>amanda-client.conf</refentrytitle>
14 <manvolnum>5</manvolnum>
20 <refname>amanda-client.conf</refname>
21 <refpurpose>Client configuration file for Amanda, the Advanced Maryland Automatic Network Disk Archiver</refpurpose>
27 <!-- body begins here -->
29 <refsect1><title>DESCRIPTION</title>
30 <para>&amclientconf; is the client configuration file for Amanda. This manpage lists the
31 relevant sections and parameters of this file for quick reference.</para>
32 <para> The files <emphasis remap='B'><CONFIG_DIR>/amanda-client.conf</emphasis> and <emphasis remap='B'><CONFIG_DIR>/<config>/amanda-client.conf</emphasis> are loaded.</para>
35 <refsect1><title>SYNTAX</title>
37 The syntax of &amclientconf; is identical to that for
38 <manref name="amanda.conf" vol="5"/>.
43 <title>GLOBAL PARAMETERS</title>
45 <variablelist remap='TP'>
47 <term><amkeyword>conf</amkeyword> <amtype>string</amtype></term>
50 <amdefault>Set by configure</amdefault>.
51 The conf use by amrecover.</para>
56 <term><amkeyword>client-username</amkeyword> <amtype>string</amtype></term>
59 <amdefault>CLIENT_LOGIN</amdefault>.
60 Similar to the parameter of the same name in &amconf;, this specifies the username that
61 &amrecover; should send when connecting to the server. It should match the username
62 specified in &amandahosts; on the server.</para>
67 <term><amkeyword>client-port</amkeyword> [ <amtype>int</amtype> | <amtype>string</amtype> ]</term>
70 <amdefault>"amanda"</amdefault>.
71 Similar to the parameter of the same name in &amconf;, this specifies the port to connect on the server. It can be a service name or a numeric port number.</para>
76 <term><amkeyword>amdump-server</amkeyword> <amtype>string</amtype></term>
79 <amdefault>Set by configure</amdefault>.
80 The amanda server to connect with the amdump_client program.</para>
85 <term><amkeyword>index-server</amkeyword> <amtype>string</amtype></term>
88 <amdefault>Set by configure</amdefault>.
89 The amindexd server amrecover will connect to.</para>
94 <term><amkeyword>tape-server</amkeyword> <amtype>string</amtype></term>
97 <amdefault>Set by configure</amdefault>.
98 The amidxtaped server amrecover will connect to.</para>
103 <term><amkeyword>tapedev</amkeyword> <amtype>string</amtype></term>
106 <amdefault>Set by configure</amdefault>.
107 The tapedev amrecover will use.</para>
112 <term><amkeyword>auth</amkeyword> <amtype>string</amtype></term>
115 <amkeyword>"bsdtcp"</amkeyword>.
116 Type of authorization to perform between tape server and backup client hosts.</para>
117 <para><amkeyword>"bsd"</amkeyword>, bsd authorization with udp initial
118 connection and one tcp connection by data stream.</para>
119 <para><amkeyword>"bsdtcp"</amkeyword>, bsd authorization but use only
120 one tcp connection.</para>
121 <para><amkeyword>"bsdudp"</amkeyword>, like bsd, but will use only one
122 tcp connection for all data stream.</para>
123 <para><amkeyword>"krb5"</amkeyword> to use Kerberos-V
124 authorization.</para>
125 <para><amkeyword>"local"</amkeyword>, if the client is the server, it
126 doesn't require authencation setup.</para>
127 <para><amkeyword>"rsh"</amkeyword> to use rsh
128 authorization.</para>
129 <para><amkeyword>"ssh"</amkeyword> to use OpenSSH
130 authorization.</para>
136 <term><amkeyword>ssh-keys</amkeyword> <amtype>string</amtype></term>
139 <amdefault>No default</amdefault>.
140 The key file the ssh auth will use, it must be the private key. If this parameter is not specified, then the default ssh key will be used.</para>
145 <term><amkeyword>gnutar-list-dir</amkeyword> <amtype>string</amtype></term>
147 <para>Default from configure
148 <amdefault>--with-gnutar-listdir=DIR</amdefault>.
149 The directory where gnutar keep its state file.</para>
154 <term><amkeyword>mailer</amkeyword> <amtype>string</amtype></term>
156 <para>Default found by configure. A mail program that can send mail with '<emphasis remap='I'>MAILER -s "subject" user < message_file</emphasis>'.</para>
161 <term><amkeyword>amandates</amkeyword> <amtype>string</amtype></term>
164 <amdefault>/etc/amandates</amdefault>.
165 The file where amanda keep the last date of each dumplevel.</para>
170 <term><amkeyword>connect-tries</amkeyword> <amtype>int</amtype></term>
173 <amdefault>3</amdefault>.
174 How many times the server will try a connection.</para>
179 <term><amkeyword>rep-tries</amkeyword> <amtype>int</amtype></term>
182 <amdefault>5</amdefault>.
183 How many times amandad will resend a REP packet if it doesn't get the ACK packet.</para>
188 <term><amkeyword>debug-days</amkeyword> <amtype>int</amtype></term>
191 <amdefault>3</amdefault>.
192 The number of days the debug files are kept.</para>
197 <term><amkeyword>debug-amandad</amkeyword> <amtype>int</amtype></term>
200 <emphasis remap='I'>0</emphasis>.
201 Debug level of the amandad process</para>
206 <term><amkeyword>debug-amidxtaped</amkeyword> <amtype>int</amtype></term>
209 <amdefault>0</amdefault>.
210 Debug level of the amidxtaped process</para>
215 <term><amkeyword>debug-amindexd</amkeyword> <amtype>int</amtype></term>
218 <amdefault>0</amdefault>.
219 Debug level of the amindexd process</para>
224 <term><amkeyword>debug-amrecover</amkeyword> <amtype>int</amtype></term>
227 <amdefault>0</amdefault>.
228 Debug level of the amrecover process</para>
233 <term><amkeyword>debug-auth</amkeyword> <amtype>int</amtype></term>
236 <amdefault>0</amdefault>.
237 Debug level of the auth module</para>
242 <term><amkeyword>debug-event</amkeyword> <amtype>int</amtype></term>
245 <amdefault>0</amdefault>.
246 Debug level of the event module</para>
251 <term><amkeyword>debug-holding</amkeyword> <amtype>int</amtype></term>
254 <amdefault>0</amdefault>.
255 Debug level of the holdingdisk module</para>
260 <term><amkeyword>debug-protocol</amkeyword> <amtype>int</amtype></term>
263 <amdefault>0</amdefault>.
264 Debug level of the protocol module</para>
269 <term><amkeyword>debug-selfcheck</amkeyword> <amtype>int</amtype></term>
272 <amdefault>0</amdefault>.
273 Debug level of the selfcheck process</para>
278 <term><amkeyword>debug-sendsize</amkeyword> <amtype>int</amtype></term>
281 <amdefault>0</amdefault>.
282 Debug level of the sendsize process</para>
287 <term><amkeyword>debug-sendbackup</amkeyword> <amtype>int</amtype></term>
290 <amdefault>0</amdefault>.
291 Debug level of the sendbackup process</para>
296 <term><amkeyword>reserved-udp-port</amkeyword> <amtype>int</amtype>,<amtype>int</amtype></term>
298 <para>Default: --with-udpportrange or
299 <amdefault>512,1023</amdefault>.
300 Reserved udp port that will be used (amrecover with bsd or bsdudp)</para>
305 <term><amkeyword>reserved-tcp-port</amkeyword> <amtype>int</amtype>,<amtype>int</amtype></term>
307 <para>Default: --with-low-tcpportrange or
308 <amdefault>512,1023</amdefault>.
309 Reserved tcp port that will be used (amrecover with bsdtcp)</para>
314 <term><amkeyword>unreserved-tcp-port</amkeyword> <amtype>int</amtype>,<amtype>int</amtype></term>
316 <para>Default: --with-tcpportrange or
317 <amdefault>1025,65536</amdefault>.
318 Unreserved tcp port that will be used (bsd, bsdudp)</para>
323 <term><amkeyword>property</amkeyword> <amtype>string</amtype> <amtype>string</amtype>+</term>
325 <para>Adds a global property for this client host, useful for e.g., Application API plugins. The first string is the property name, the following strings are the property values</para>
332 <refsect1><title>APPLICATION SECTION</title>
334 <emphasis remap='B'>amanda-client.conf</emphasis>
335 file may define multiple types of application.
336 The information is entered in a <amkeyword>application</amkeyword>
337 section, which looks like this:</para>
340 define application "<amtype>name</amtype>" {
341 <emphasis remap='I'>application-option</emphasis> <emphasis remap='I'>application-value</emphasis>
342 <literal>...</literal>
346 <para><amtype>name</amtype>
347 is the name of this type of application.</para>
349 The setting from an application is merged with the dle setting
350 if the <amtype>name</amtype> is the same as the <amkeyword>client-application-name</amkeyword> from the dle
351 or if the <amkeyword>client-application-name</amkeyword> from the dle is not set and the <amtype>name</amtype> is the same as the <amkeyword>plugin</amkeyword> from the dle.</para>
353 <para>The application options and values are:</para>
354 <variablelist remap='TP'>
356 <term><amkeyword>client-application-name</amkeyword> <amtype>string</amtype></term>
359 <amdefault>none</amdefault>.
360 Not use on the client.</para>
364 <term><amkeyword>comment</amkeyword> <amtype>string</amtype></term>
367 <amdefault>none</amdefault>.
368 A comment string describing this application.</para>
372 <term><amkeyword>plugin</amkeyword> <amtype>string</amtype></term>
374 <para>No default. Must be set to the name of the program. This program must be
375 in the <emphasis remap='I'>$libexecdir/amanda/application</emphasis> directory
376 on the client. If set, it must be the same as the dle <amkeyword>plugin</amkeyword>.</para>
380 <term><amkeyword>property</amkeyword> [<amkeyword>append</amkeyword>] [<amkeyword>priority</amkeyword>] <amtype>string</amtype> <amtype>string</amtype>+</term>
382 <para>No default. You can set property for the application, each application have a different set of property. Both strings are quoted; the first string contains the name of
383 the property to set, and the others contains its values.
384 <amkeyword>append</amkeyword> keyword append the values to the list of values for that property.
385 <amkeyword>priority</amkeyword> keyword disallow the setting of that property on the server.
392 <refsect1><title>SCRIPT SECTION</title>
394 <emphasis remap='B'>amanda-client.conf</emphasis>
395 file may define multiple types of script.
396 The information is entered in a <emphasis remap='B'>script</emphasis>
397 section, which looks like this:</para>
400 define script "<amtype>name</amtype>" {
401 <emphasis remap='I'>script-option</emphasis> <emphasis remap='I'>script-value</emphasis>
402 <literal>...</literal>
406 <para><amtype>name</amtype>
407 is the name of this type of script.</para>
409 The setting from a script is merged with the dle setting
410 if the <amtype>name</amtype> is the same as the <amkeyword>client-script-name</amkeyword> from the dle
411 or if the <amkeyword>client-script-name</amkeyword> from the dle is not set and the <amtype>name</amtype> is the same as the <amkeyword>plugin</amkeyword> from the dle.</para>
413 <para>The script options and values are:</para>
414 <variablelist remap='TP'>
416 <term><amkeyword>client-script-name</amkeyword> <amtype>string</amtype></term>
419 <amdefault>none</amdefault>.
420 Not used on the client.</para>
424 <term><amkeyword>comment</amkeyword> <amtype>string</amtype></term>
427 <amdefault>none</amdefault>.
428 A comment string describing this script.</para>
432 <term><amkeyword>plugin</amkeyword> <amtype>string</amtype></term>
434 <para>No default. Must be set to the name of the program. This program must be in the <emphasis remap='I'>$libdir/amanda/application</emphasis> directory on the client. If set, it must be the same as the dle <amkeyword>plugin</amkeyword>.</para>
438 <term><amkeyword>execute-where</amkeyword> <amkeyword>client</amkeyword></term>
440 <para>Default: <amkeyword>client</amkeyword>.
441 Value can't be changed.</para>
445 <term><amkeyword>execute-on</amkeyword> <amtype>execute_on</amtype>[,<amtype>execute_on</amtype>]*</term>
447 <para>No default. When the script must be executed, you can specify many of them:</para>
449 <variablelist remap='TP'>
451 <term><amkeyword>pre-dle-amcheck</amkeyword></term>
453 <para>Execute before the amcheck command for the dle.</para>
457 <term><amkeyword>pre-host-amcheck</amkeyword></term>
459 <para>Execute before the amcheck command for all dle for the client.</para>
463 <term><amkeyword>post-dle-amcheck</amkeyword></term>
465 <para>Execute after the amcheck command for the dle.</para>
469 <term><amkeyword>post-host-amcheck</amkeyword></term>
471 <para>Execute after the amcheck command for all dle for the client.</para>
475 <term><amkeyword>pre-dle-estimate</amkeyword></term>
477 <para>Execute before the estimate command for the dle.</para>
481 <term><amkeyword>pre-host-estimate</amkeyword></term>
483 <para>Execute before the estimate command for all dle for the client.</para>
487 <term><amkeyword>post-dle-estimate</amkeyword></term>
489 <para>Execute after the estimate command for the dle.</para>
493 <term><amkeyword>post-host-estimate</amkeyword></term>
495 <para>Execute after the estimate command for all dle for the client.</para>
499 <term><amkeyword>pre-dle-backup</amkeyword></term>
501 <para>Execute before the backup command for the dle.</para>
505 <term><amkeyword>post-dle-backup</amkeyword></term>
507 <para>Execute after the backup command for the dle.</para>
511 <term><amkeyword>pre-recover</amkeyword></term>
513 <para>Execute before any level is recovered.</para>
517 <term><amkeyword>post-recover</amkeyword></term>
519 <para>Execute after all levels are recovered.</para>
523 <term><amkeyword>pre-level-recover</amkeyword></term>
525 <para>Execute before each level recovery.</para>
529 <term><amkeyword>post-level-recover</amkeyword></term>
531 <para>Execute after each level recovery.</para>
535 <term><amkeyword>inter-level-recover</amkeyword></term>
537 <para>Execute between two levels of recovery.</para>
544 <term><amkeyword>property</amkeyword> [<amkeyword>append</amkeyword>] [<amkeyword>priority</amkeyword>] <amtype>string</amtype> <amtype>string</amtype>+</term>
546 <para>No default. You can set property for the script, each script have a different set of property. Both strings are quoted; the first string contains the name of
547 the property to set, and the others contains its values.
548 <amkeyword>append</amkeyword> keyword append the values to the list of values for that property.
549 <amkeyword>priority</amkeyword> keyword disallow the setting of that property on the server.
557 <manref name="amanda.conf" vol="5"/>,
558 <manref name="amcrypt" vol="8"/>,
559 <manref name="aespipe" vol="1"/>,