git.gag.com Git - debian/amanda/blob - man/xml-source/amanda-client.conf.5.xml

   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"
   4 [
   5   <!-- entities files to use -->
   6   <!ENTITY % global_entities SYSTEM 'global.entities'>
   7   %global_entities;
   8 ]>
   9
  10 <refentry id='amanda-client.conf.5'>
  11
  12 <refmeta>
  13 <refentrytitle>amanda-client.conf</refentrytitle>
  14 <manvolnum>5</manvolnum>
  15 &rmi.source;
  16 &rmi.version;
  17 &rmi.manual.5;
  18 </refmeta>
  19 <refnamediv>
  20 <refname>amanda-client.conf</refname>
  21 <refpurpose>Client configuration file for Amanda, the Advanced Maryland Automatic Network Disk Archiver</refpurpose>
  22 </refnamediv>
  23 <refentryinfo>
  24 &author.jds;
  25 &author.sgw.xml;
  26 </refentryinfo>
  27 <!-- body begins here -->
  28
  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'>&lt;CONFIG_DIR&gt;/amanda-client.conf</emphasis> and <emphasis remap='B'>&lt;CONFIG_DIR&gt;/&lt;config&gt;/amanda-client.conf</emphasis> are loaded.</para>
  33 </refsect1>
  34
  35 <refsect1><title>SYNTAX</title>
  36
  37 The syntax of &amclientconf; is identical to that for
  38 <manref name="amanda.conf" vol="5"/>.
  39
  40 </refsect1>
  41
  42 <refsect1>
  43 <title>GLOBAL PARAMETERS</title>
  44
  45 <variablelist remap='TP'>
  46   <varlistentry>
  47   <term><amkeyword>conf</amkeyword> <amtype>string</amtype></term>
  48   <listitem>
  49 <para>Default:
  50 <amdefault>Set by configure</amdefault>.
  51 The conf use by amrecover.</para>
  52   </listitem>
  53   </varlistentry>
  54
  55   <varlistentry>
  56   <term><amkeyword>client-username</amkeyword> <amtype>string</amtype></term>
  57   <listitem>
  58 <para>Default:
  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>
  63   </listitem>
  64   </varlistentry>
  65
  66   <varlistentry>
  67   <term><amkeyword>client-port</amkeyword> [ <amtype>int</amtype> | <amtype>string</amtype> ]</term>
  68   <listitem>
  69 <para>Default:
  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>
  72   </listitem>
  73   </varlistentry>
  74
  75   <varlistentry>
  76   <term><amkeyword>amdump-server</amkeyword> <amtype>string</amtype></term>
  77   <listitem>
  78 <para>No default:
  79 <amdefault>Set by configure</amdefault>.
  80 The amanda server to connect with the amdump_client program.</para>
  81   </listitem>
  82   </varlistentry>
  83
  84   <varlistentry>
  85   <term><amkeyword>index-server</amkeyword> <amtype>string</amtype></term>
  86   <listitem>
  87 <para>Default:
  88 <amdefault>Set by configure</amdefault>.
  89 The amindexd server amrecover will connect to.</para>
  90   </listitem>
  91   </varlistentry>
  92
  93   <varlistentry>
  94   <term><amkeyword>tape-server</amkeyword> <amtype>string</amtype></term>
  95   <listitem>
  96 <para>Default:
  97 <amdefault>Set by configure</amdefault>.
  98 The amidxtaped server amrecover will connect to.</para>
  99   </listitem>
 100   </varlistentry>
 101
 102   <varlistentry>
 103   <term><amkeyword>tapedev</amkeyword> <amtype>string</amtype></term>
 104   <listitem>
 105 <para>Default:
 106 <amdefault>Set by configure</amdefault>.
 107 The tapedev amrecover will use.</para>
 108   </listitem>
 109   </varlistentry>
 110
 111   <varlistentry>
 112   <term><amkeyword>auth</amkeyword> <amtype>string</amtype></term>
 113   <listitem>
 114 <para>Default:
 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>
 131
 132   </listitem>
 133   </varlistentry>
 134
 135   <varlistentry>
 136   <term><amkeyword>ssh-keys</amkeyword> <amtype>string</amtype></term>
 137   <listitem>
 138 <para>Default:
 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>
 141   </listitem>
 142   </varlistentry>
 143
 144   <varlistentry>
 145   <term><amkeyword>gnutar-list-dir</amkeyword> <amtype>string</amtype></term>
 146   <listitem>
 147 <para>Default from configure
 148 <amdefault>--with-gnutar-listdir=DIR</amdefault>.
 149 The directory where gnutar keep its state file.</para>
 150   </listitem>
 151   </varlistentry>
 152
 153   <varlistentry>
 154   <term><amkeyword>mailer</amkeyword> <amtype>string</amtype></term>
 155   <listitem>
 156 <para>Default found by configure. A mail program that can send mail with '<emphasis remap='I'>MAILER -s "subject" user &lt; message_file</emphasis>'.</para>
 157   </listitem>
 158   </varlistentry>
 159
 160   <varlistentry>
 161   <term><amkeyword>amandates</amkeyword> <amtype>string</amtype></term>
 162   <listitem>
 163 <para>Default:
 164 <amdefault>/etc/amandates</amdefault>.
 165 The file where amanda keep the last date of each dumplevel.</para>
 166   </listitem>
 167   </varlistentry>
 168
 169   <varlistentry>
 170   <term><amkeyword>connect-tries</amkeyword> <amtype>int</amtype></term>
 171   <listitem>
 172 <para>Default:
 173 <amdefault>3</amdefault>.
 174 How many times the server will try a connection.</para>
 175   </listitem>
 176   </varlistentry>
 177
 178   <varlistentry>
 179   <term><amkeyword>rep-tries</amkeyword> <amtype>int</amtype></term>
 180   <listitem>
 181 <para>Default:
 182 <amdefault>5</amdefault>.
 183 How many times amandad will resend a REP packet if it doesn't get the ACK packet.</para>
 184   </listitem>
 185   </varlistentry>
 186
 187   <varlistentry>
 188   <term><amkeyword>debug-days</amkeyword> <amtype>int</amtype></term>
 189   <listitem>
 190 <para>Default:
 191 <amdefault>3</amdefault>.
 192 The number of days the debug files are kept.</para>
 193   </listitem>
 194   </varlistentry>
 195
 196   <varlistentry>
 197   <term><amkeyword>debug-amandad</amkeyword> <amtype>int</amtype></term>
 198   <listitem>
 199 <para>Default:
 200 <emphasis remap='I'>0</emphasis>.
 201 Debug level of the amandad process</para>
 202   </listitem>
 203   </varlistentry>
 204
 205   <varlistentry>
 206   <term><amkeyword>debug-amidxtaped</amkeyword> <amtype>int</amtype></term>
 207   <listitem>
 208 <para>Default:
 209 <amdefault>0</amdefault>.
 210 Debug level of the amidxtaped process</para>
 211   </listitem>
 212   </varlistentry>
 213
 214   <varlistentry>
 215   <term><amkeyword>debug-amindexd</amkeyword> <amtype>int</amtype></term>
 216   <listitem>
 217 <para>Default:
 218 <amdefault>0</amdefault>.
 219 Debug level of the amindexd process</para>
 220   </listitem>
 221   </varlistentry>
 222
 223   <varlistentry>
 224   <term><amkeyword>debug-amrecover</amkeyword> <amtype>int</amtype></term>
 225   <listitem>
 226 <para>Default:
 227 <amdefault>0</amdefault>.
 228 Debug level of the amrecover process</para>
 229   </listitem>
 230   </varlistentry>
 231
 232   <varlistentry>
 233   <term><amkeyword>debug-auth</amkeyword> <amtype>int</amtype></term>
 234   <listitem>
 235 <para>Default:
 236 <amdefault>0</amdefault>.
 237 Debug level of the auth module</para>
 238   </listitem>
 239   </varlistentry>
 240
 241   <varlistentry>
 242   <term><amkeyword>debug-event</amkeyword> <amtype>int</amtype></term>
 243   <listitem>
 244 <para>Default:
 245 <amdefault>0</amdefault>.
 246 Debug level of the event module</para>
 247   </listitem>
 248   </varlistentry>
 249
 250   <varlistentry>
 251   <term><amkeyword>debug-holding</amkeyword> <amtype>int</amtype></term>
 252   <listitem>
 253 <para>Default:
 254 <amdefault>0</amdefault>.
 255 Debug level of the holdingdisk module</para>
 256   </listitem>
 257   </varlistentry>
 258
 259   <varlistentry>
 260   <term><amkeyword>debug-protocol</amkeyword> <amtype>int</amtype></term>
 261   <listitem>
 262 <para>Default:
 263 <amdefault>0</amdefault>.
 264 Debug level of the protocol module</para>
 265   </listitem>
 266   </varlistentry>
 267
 268   <varlistentry>
 269   <term><amkeyword>debug-selfcheck</amkeyword> <amtype>int</amtype></term>
 270   <listitem>
 271 <para>Default:
 272 <amdefault>0</amdefault>.
 273 Debug level of the selfcheck process</para>
 274   </listitem>
 275   </varlistentry>
 276
 277   <varlistentry>
 278   <term><amkeyword>debug-sendsize</amkeyword> <amtype>int</amtype></term>
 279   <listitem>
 280 <para>Default:
 281 <amdefault>0</amdefault>.
 282 Debug level of the sendsize process</para>
 283   </listitem>
 284   </varlistentry>
 285
 286   <varlistentry>
 287   <term><amkeyword>debug-sendbackup</amkeyword> <amtype>int</amtype></term>
 288   <listitem>
 289 <para>Default:
 290 <amdefault>0</amdefault>.
 291 Debug level of the sendbackup process</para>
 292   </listitem>
 293   </varlistentry>
 294
 295   <varlistentry>
 296   <term><amkeyword>reserved-udp-port</amkeyword> <amtype>int</amtype>,<amtype>int</amtype></term>
 297   <listitem>
 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>
 301   </listitem>
 302   </varlistentry>
 303
 304   <varlistentry>
 305   <term><amkeyword>reserved-tcp-port</amkeyword> <amtype>int</amtype>,<amtype>int</amtype></term>
 306   <listitem>
 307 <para>Default: --with-low-tcpportrange or
 308 <amdefault>512,1023</amdefault>.
 309 Reserved tcp port that will be used (amrecover with bsdtcp)</para>
 310   </listitem>
 311   </varlistentry>
 312
 313   <varlistentry>
 314   <term><amkeyword>unreserved-tcp-port</amkeyword> <amtype>int</amtype>,<amtype>int</amtype></term>
 315   <listitem>
 316 <para>Default: --with-tcpportrange or
 317 <amdefault>1025,65536</amdefault>.
 318 Unreserved tcp port that will be used (bsd, bsdudp)</para>
 319   </listitem>
 320   </varlistentry>
 321
 322   <varlistentry>
 323   <term><amkeyword>property</amkeyword> <amtype>string</amtype> <amtype>string</amtype>+</term>
 324   <listitem>
 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>
 326   </listitem>
 327   </varlistentry>
 328
 329 </variablelist>
 330 </refsect1>
 331
 332 <refsect1><title>APPLICATION SECTION</title>
 333 <para>The
 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>
 338
 339 <programlisting>
 340 define application "<amtype>name</amtype>" {
 341     <emphasis remap='I'>application-option</emphasis> <emphasis remap='I'>application-value</emphasis>
 342     <literal>...</literal>
 343 }
 344 </programlisting>
 345
 346 <para><amtype>name</amtype>
 347 is the name of this type of application.</para>
 348 <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>
 352
 353 <para>The application options and values are:</para>
 354 <variablelist remap='TP'>
 355   <varlistentry>
 356   <term><amkeyword>client-application-name</amkeyword> <amtype>string</amtype></term>
 357   <listitem>
 358 <para>Default:
 359 <amdefault>none</amdefault>.
 360 Not use on the client.</para>
 361   </listitem>
 362   </varlistentry>
 363   <varlistentry>
 364   <term><amkeyword>comment</amkeyword> <amtype>string</amtype></term>
 365   <listitem>
 366 <para>Default:
 367 <amdefault>none</amdefault>.
 368 A comment string describing this application.</para>
 369   </listitem>
 370   </varlistentry>
 371   <varlistentry>
 372   <term><amkeyword>plugin</amkeyword> <amtype>string</amtype></term>
 373   <listitem>
 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>
 377   </listitem>
 378   </varlistentry>
 379   <varlistentry>
 380   <term><amkeyword>property</amkeyword> [<amkeyword>append</amkeyword>] [<amkeyword>priority</amkeyword>] <amtype>string</amtype> <amtype>string</amtype>+</term>
 381   <listitem>
 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.
 386 </para>
 387   </listitem>
 388   </varlistentry>
 389 </variablelist>
 390 </refsect1>
 391
 392 <refsect1><title>SCRIPT SECTION</title>
 393 <para>The
 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>
 398
 399 <programlisting>
 400 define script "<amtype>name</amtype>" {
 401     <emphasis remap='I'>script-option</emphasis> <emphasis remap='I'>script-value</emphasis>
 402     <literal>...</literal>
 403 }
 404 </programlisting>
 405
 406 <para><amtype>name</amtype>
 407 is the name of this type of script.</para>
 408 <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>
 412
 413 <para>The script options and values are:</para>
 414 <variablelist remap='TP'>
 415   <varlistentry>
 416   <term><amkeyword>client-script-name</amkeyword> <amtype>string</amtype></term>
 417   <listitem>
 418 <para>Default:
 419 <amdefault>none</amdefault>.
 420 Not used on the client.</para>
 421   </listitem>
 422   </varlistentry>
 423   <varlistentry>
 424   <term><amkeyword>comment</amkeyword> <amtype>string</amtype></term>
 425   <listitem>
 426 <para>Default:
 427 <amdefault>none</amdefault>.
 428 A comment string describing this script.</para>
 429   </listitem>
 430   </varlistentry>
 431   <varlistentry>
 432   <term><amkeyword>plugin</amkeyword> <amtype>string</amtype></term>
 433   <listitem>
 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>
 435   </listitem>
 436   </varlistentry>
 437   <varlistentry>
 438   <term><amkeyword>execute-where</amkeyword> <amkeyword>client</amkeyword></term>
 439   <listitem>
 440 <para>Default: <amkeyword>client</amkeyword>.
 441 Value can't be changed.</para>
 442   </listitem>
 443   </varlistentry>
 444   <varlistentry>
 445   <term><amkeyword>execute-on</amkeyword> <amtype>execute_on</amtype>[,<amtype>execute_on</amtype>]*</term>
 446   <listitem>
 447 <para>No default. When the script must be executed, you can specify many of them:</para>
 448     <!-- .RS -->
 449     <variablelist remap='TP'>
 450       <varlistentry>
 451       <term><amkeyword>pre-dle-amcheck</amkeyword></term>
 452       <listitem>
 453 <para>Execute before the amcheck command for the dle.</para>
 454       </listitem>
 455       </varlistentry>
 456       <varlistentry>
 457       <term><amkeyword>pre-host-amcheck</amkeyword></term>
 458       <listitem>
 459 <para>Execute before the amcheck command for all dle for the client.</para>
 460       </listitem>
 461       </varlistentry>
 462       <varlistentry>
 463       <term><amkeyword>post-dle-amcheck</amkeyword></term>
 464       <listitem>
 465 <para>Execute after the amcheck command for the dle.</para>
 466       </listitem>
 467       </varlistentry>
 468       <varlistentry>
 469       <term><amkeyword>post-host-amcheck</amkeyword></term>
 470       <listitem>
 471 <para>Execute after the amcheck command for all dle for the client.</para>
 472       </listitem>
 473       </varlistentry>
 474       <varlistentry>
 475       <term><amkeyword>pre-dle-estimate</amkeyword></term>
 476       <listitem>
 477 <para>Execute before the estimate command for the dle.</para>
 478       </listitem>
 479       </varlistentry>
 480       <varlistentry>
 481       <term><amkeyword>pre-host-estimate</amkeyword></term>
 482       <listitem>
 483 <para>Execute before the estimate command for all dle for the client.</para>
 484       </listitem>
 485       </varlistentry>
 486       <varlistentry>
 487       <term><amkeyword>post-dle-estimate</amkeyword></term>
 488       <listitem>
 489 <para>Execute after the estimate command for the dle.</para>
 490       </listitem>
 491       </varlistentry>
 492       <varlistentry>
 493       <term><amkeyword>post-host-estimate</amkeyword></term>
 494       <listitem>
 495 <para>Execute after the estimate command for all dle for the client.</para>
 496       </listitem>
 497       </varlistentry>
 498       <varlistentry>
 499       <term><amkeyword>pre-dle-backup</amkeyword></term>
 500       <listitem>
 501 <para>Execute before the backup command for the dle.</para>
 502       </listitem>
 503       </varlistentry>
 504       <varlistentry>
 505       <term><amkeyword>post-dle-backup</amkeyword></term>
 506       <listitem>
 507 <para>Execute after the backup command for the dle.</para>
 508       </listitem>
 509       </varlistentry>
 510       <varlistentry>
 511       <term><amkeyword>pre-recover</amkeyword></term>
 512       <listitem>
 513 <para>Execute before any level is recovered.</para>
 514       </listitem>
 515       </varlistentry>
 516       <varlistentry>
 517       <term><amkeyword>post-recover</amkeyword></term>
 518       <listitem>
 519 <para>Execute after all levels are recovered.</para>
 520       </listitem>
 521       </varlistentry>
 522       <varlistentry>
 523       <term><amkeyword>pre-level-recover</amkeyword></term>
 524       <listitem>
 525 <para>Execute before each level recovery.</para>
 526       </listitem>
 527       </varlistentry>
 528       <varlistentry>
 529       <term><amkeyword>post-level-recover</amkeyword></term>
 530       <listitem>
 531 <para>Execute after each level recovery.</para>
 532       </listitem>
 533       </varlistentry>
 534       <varlistentry>
 535       <term><amkeyword>inter-level-recover</amkeyword></term>
 536       <listitem>
 537 <para>Execute between two levels of recovery.</para>
 538       </listitem>
 539       </varlistentry>
 540     </variablelist>
 541   </listitem>
 542   </varlistentry>
 543   <varlistentry>
 544   <term><amkeyword>property</amkeyword> [<amkeyword>append</amkeyword>] [<amkeyword>priority</amkeyword>] <amtype>string</amtype> <amtype>string</amtype>+</term>
 545   <listitem>
 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.
 550 </para>
 551   </listitem>
 552   </varlistentry>
 553 </variablelist>
 554 </refsect1>
 555
 556 <seealso>
 557 <manref name="amanda.conf" vol="5"/>,
 558 <manref name="amcrypt" vol="8"/>,
 559 <manref name="aespipe" vol="1"/>,
 560 </seealso>
 561
 562 </refentry>
 563