amanda-client.conf - Client configuration file for Amanda, the Advanced Maryland Automatic Network Disk
Contents
Application Section
The amanda-client.conf file may define multiple types of application. The information is entered in a
application section, which looks like this:
define application "name" {
application-optionapplication-value
...
}
name is the name of this type of application.
The setting from an application is merged with the dle setting if the name is the same as the
client-application-name from the dle or if the client-application-name from the dle is not set and the
name is the same as the plugin from the dle.
The application options and values are:
client-application-namestring
Default: none. Not use on the client.
commentstring
Default: none. A comment string describing this application.
pluginstring
No default. Must be set to the name of the program. This program must be in the
$libexecdir/amanda/application directory on the client. If set, it must be the same as the dle
plugin.
property [append] [priority] stringstring+
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 the property to set, and the
others contains its values. append keyword append the values to the list of values for that
property. priority keyword disallow the setting of that property on the server.
Description
amanda-client.conf(5) 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.
Global Parameters
confstring
Default: Setbyconfigure. The conf use by amrecover.
client-usernamestring
Default: CLIENT_LOGIN. Similar to the parameter of the same name in amanda.conf(5), this specifies
the username that amrecover should send when connecting to the server. It should match the username
specified in .amandahosts on the server.
client-port [ int | string ]
Default: "amanda". Similar to the parameter of the same name in amanda.conf(5), this specifies the
port to connect on the server. It can be a service name or a numeric port number.
amdump-serverstring
No default: Setbyconfigure. The amanda server to connect with the amdump_client program.
index-serverstring
Default: Setbyconfigure. The amindexd server amrecover will connect to.
tape-serverstring
Default: Setbyconfigure. The amidxtaped server amrecover will connect to.
tapedevstring
Default: Setbyconfigure. The tapedev amrecover will use.
authstring
Default: "bsdtcp". 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.
"krb5" to use Kerberos-V authorization.
"local", if the client is the server, it doesn't require authencation setup.
"rsh" to use rsh authorization.
"ssh" to use OpenSSH authorization.
ssh-keysstring
Default: Nodefault. 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-dirstring
Default from configure --with-gnutar-listdir=DIR. The directory where gnutar keep its state file.
mailerstring
Default found by configure. A mail program that can send mail with 'MAILER-s"subject"user<message_file'.
amandatesstring
Default: /etc/amandates. The file where amanda keep the last date of each dumplevel.
connect-triesint
Default: 3. How many times the server will try a connection.
rep-triesint
Default: 5. How many times amandad will resend a REP packet if it doesn't get the ACK packet.
debug-daysint
Default: 3. The number of days the debug files are kept.
debug-amandadint
Default: 0. Debug level of the amandad process
debug-amidxtapedint
Default: 0. Debug level of the amidxtaped process
debug-amindexdint
Default: 0. Debug level of the amindexd process
debug-amrecoverint
Default: 0. Debug level of the amrecover process
debug-authint
Default: 0. Debug level of the auth module
debug-eventint
Default: 0. Debug level of the event module
debug-holdingint
Default: 0. Debug level of the holdingdisk module
debug-protocolint
Default: 0. Debug level of the protocol module
debug-selfcheckint
Default: 0. Debug level of the selfcheck process
debug-sendsizeint
Default: 0. Debug level of the sendsize process
debug-sendbackupint
Default: 0. Debug level of the sendbackup process
hostnamestring
Default: `hostname`. The hostname (in the DLE) of the client machine
reserved-udp-portint,int
Default: --with-udpportrange or 512,1023. Reserved udp port that will be used (amrecover with bsd or
bsdudp)
reserved-tcp-portint,int
Default: --with-low-tcpportrange or 512,1023. Reserved tcp port that will be used (amrecover with
bsdtcp)
unreserved-tcp-portint,int
Default: --with-tcpportrange or 1025,65536. Unreserved tcp port that will be used (bsd, bsdudp)
propertystringstring+
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
Name
amanda-client.conf - Client configuration file for Amanda, the Advanced Maryland Automatic Network Disk
Archiver
Script Section
The amanda-client.conf file may define multiple types of script. The information is entered in a script
section, which looks like this:
define script "name" {
script-optionscript-value
...
}
name is the name of this type of script.
The setting from a script is merged with the dle setting if the name is the same as the
client-script-name from the dle or if the client-script-name from the dle is not set and the name is the
same as the plugin from the dle.
The script options and values are:
client-script-namestring
Default: none. Not used on the client.
commentstring
Default: none. A comment string describing this script.
pluginstring
No default. Must be set to the name of the program. This program must be in the
$libdir/amanda/application directory on the client. If set, it must be the same as the dle plugin.
execute-whereclient
Default: client. Value can't be changed.
execute-onexecute_on[,execute_on]*
No default. When the script must be executed, you can specify many of them:
pre-dle-amcheck
Execute before the amcheck command for the dle.
pre-host-amcheck
Execute before the amcheck command for all dle for the client.
post-dle-amcheck
Execute after the amcheck command for the dle.
post-host-amcheck
Execute after the amcheck command for all dle for the client.
pre-dle-estimate
Execute before the estimate command for the dle.
pre-host-estimate
Execute before the estimate command for all dle for the client.
post-dle-estimate
Execute after the estimate command for the dle.
post-host-estimate
Execute after the estimate command for all dle for the client.
pre-dle-backup
Execute before the backup command for the dle.
post-dle-backup
Execute after the backup command for the dle.
pre-recover
Execute before any level is recovered.
post-recover
Execute after all levels are recovered.
pre-level-recover
Execute before each level recovery.
post-level-recover
Execute after each level recovery.
inter-level-recover
Execute between two levels of recovery.
property [append] [priority] stringstring+
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 the property to set, and the others
contains its values. append keyword append the values to the list of values for that property.
priority keyword disallow the setting of that property on the server.
See Also
Syntax
The syntax of amanda-client.conf(5) is identical to that for amanda.conf(5).
