Amanda-client.conf: Difference between revisions

From wiki.zmanda.com
Jump to navigation Jump to search
No edit summary
Line 14: Line 14:
remainder of the line is ignored.
remainder of the line is ignored.


Keywords are case insensitive, i.e. auth and Auth are treated the same.
Keywords are case insensitive, i.e. mailto and MailTo are treated the same. Also, the characters ´-´ and ´_´ are interchangeable: device_property and device-property have the same meaning.


Integer arguments may have one of the following (case insensitive) suffixes, some of which have a multiplier effect:
Integer arguments may have one of the following (case insensitive) suffixes, some of which have a multiplier effect:
Line 58: Line 58:


; gnutar_list_dir ''string'' : Default: <configure parameter --with-gnutar-listdir=DIR>. The directory where gnutar keep its state file.
; gnutar_list_dir ''string'' : Default: <configure parameter --with-gnutar-listdir=DIR>. The directory where gnutar keep its state file.
     
 
; mailer  ''string'' : Default found by configure. A mail program that can send mail with ´MAILER -s "subject" user < message_file´.
 
; amandates ''string'' : Default: /etc/amandates. The file where amanda keep the last date of each dump level.
; amandates ''string'' : Default: /etc/amandates. The file where amanda keep the last date of each dump level.


Line 92: Line 94:


; unreserved-tcp-port ''int,int'' : Default:  --with-tcpportrange or 1025,65536. Unreserved tcp port that will be used (bsd, bsdudp)
; unreserved-tcp-port ''int,int'' : Default:  --with-tcpportrange or 1025,65536. Unreserved tcp port that will be used (bsd, bsdudp)
; property "name" "value" : Adds a global property for this client host, useful for e.g., Application API plugins.


==AUTHOR==
==AUTHOR==

Revision as of 22:43, 5 June 2008

NAME

amanda-client.conf - Client configuration file for Amanda, the Advanced Maryland Automatic Network Disk Archiver

DESCRIPTION

amanda-client.conf is the client configuration file for Amanda. This manpage lists the relevant sections and parameters of this file for quick reference.

The files <CONFIG_DIR>/amanda-client.conf and <CONFIG_DIR>/<config>/amanda-client.conf are loaded.

PARAMETERS

There are a number of configuration parameters that control the behavior of the Amanda programs. All have default values, so you need not specify the parameter in amanda-client.conf if the default is suitable.

Lines starting with # are ignored, as are blank lines. Comments may be placed on a line with a directive by starting the comment with a #. The remainder of the line is ignored.

Keywords are case insensitive, i.e. mailto and MailTo are treated the same. Also, the characters ´-´ and ´_´ are interchangeable: device_property and device-property have the same meaning.

Integer arguments may have one of the following (case insensitive) suffixes, some of which have a multiplier effect:

POSSIBLE SUFFIXES

b byte bytes
Some number of bytes.
bps
Some number of bytes per second.
k kb kbyte kbytes kilobyte kilobytes
Some number of kilobytes (bytes*1024).
kps kbps
Some number of kilobytes per second (bytes*1024).
m mb meg mbyte mbytes megabyte megabytes
Some number of megabytes (bytes*1024*1024).
mps mbps
Some number of megabytes per second (bytes*1024*1024).
g gb gbyte gbytes gigabyte gigabytes
Some number of gigabytes (bytes*1024*1024*1024).
tape tapes
Some number of tapes.
day days
Some number of days.
week weeks
Some number of weeks (days*7).

Note

The value inf may be used in most places where an integer is expected to mean an infinite amount.

Boolean arguments may have any of the values y, yes, t, true or on to indicate a true state, or n, no, f, false or off to indicate a false state. If no argument is given, true is assumed.

PARAMETERS

conf string
Default: Set by configure. The conf use by amrecover.
index_server string
Default: Set by configure. The amindexd server amrecover will connect to.
tape_server string
Default: Set by configure. The amidxtaped server amrecover will connect to.
tapedev string
Default: Set by configure. The tapedev amrecover will use.
auth string
Default: bsd. Type of authorization to perform between tape server and backup client hosts.
  • bsd bsd authorization with udp initial connection and one tcp connection by data stream.
  • bsdtcp bsd authorization but use only one tcp connection.
  • bsdudp like bsd, but will use only one tcp connection for all data stream.
  • krb4 to use Kerberos-IV authorization.
  • krb5 to use Kerberos-V authorization.
  • local, if the client is the server, it doesn’t require authentication setup.
  • rsh to use rsh authorization.
  • ssh to use OpenSSH authorization.
ssh_keys string
Default: No default. 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.
gnutar_list_dir string
Default: <configure parameter --with-gnutar-listdir=DIR>. The directory where gnutar keep its state file.
mailer string
Default found by configure. A mail program that can send mail with ´MAILER -s "subject" user < message_file´.
amandates string
Default: /etc/amandates. The file where amanda keep the last date of each dump level.
connect_tries int
Default: 3. How many times the server will try a connection.
rep_tries int
Default: 5. How many times amandad will resend a REP packet if it doesn't get the ACK packet.
debug_amandad int
Default:0. Debug level of the amandad process.
debug_amidxtaped int
Default:0. Debug level of the amidxtaped process.
debug_amindexd int
Default:0. Debug level of the amindexd process.
debug_amrecover int
Default: 0. Debug level of amrecover process.
debug_auth int
Default: 0. Debug level of the auth module.
debug_event int
Default: 0. Debug level of the event module.
debug_holding int
Default: 0. Debug level of the holding disk module.
debug_protocol int
Default: 0. Debug level of the protocol module.
debug_selfcheck int
Default: 0. Debug level of the selfcheck process.
debug_sendsize int
Default: 0. Debug level of the sendsize process.
debug_sendbackup int
Default: 0. Debug level of the sendbackup process.
reserved-udp-port int,int
Default: --with-udpportrange or 512,1023. Reserved udp port that will be used (amrecover with bsd or bsdudp)
reserved-tcp-port int,int
Default: --with-low-tcpportrange or 512,1023. Reserved tcp port that will be used (amrecover with bsdtcp)
unreserved-tcp-port int,int
Default: --with-tcpportrange or 1025,65536. Unreserved tcp port that will be used (bsd, bsdudp)
property "name" "value"
Adds a global property for this client host, useful for e.g., Application API plugins.

AUTHOR

James da Silva, <[email protected]>: Original text

Stefan G. Weichinger, <[email protected]>, maintainer of the Amanda-documentation: XML-conversion, major update, splitting

SEE ALSO

amanda(8), amanda.conf(5), amcrypt(8), aespipe(1),