amservice(8) [centos man page]
AMSERVICE(8) System Administration Commands AMSERVICE(8) NAME
amservice - run an amanda service on a client SYNOPSIS
amservice [-f input_file [-s]] [-o configoption...] hostname auth service DESCRIPTION
Amservice execute an Amanda service on a client. It can be used without amanda server configuration (amanda.conf and disklist). It can be used to check communication between a server and a client. Amservice reads stdin to capture the REQ packet to send to the client. See the amanda(8) man page for more details about Amanda. OPTIONS
hostname The hostname of the client. auth The auth to use, one of: bsd, bsdudp, bsdtcp, ssh, rsh or krb5. The client must be configured with this auth. service The amanda service to execute on the client. One of noop, selfcheck or sendsize. -f input_file Use the file input_file instead of stdin to read the REQ packet from. -s Redirect the first connected stream to stdin/stdout. The -f argument is required for the REQ packet, the REP packet is not printed on stdout. -o configoption See the "CONFIGURATION OVERRIDE" section in amanda(8). EXAMPLE
The noop service is easy to execute because it does not require a REQ packet: amservice hostname bsdtcp noop < /dev/null The example executes the noop service on the client using bsdtcp auth. This is useful for debugging connection problems. It print an OPTIONS line upon success. It is more difficult to execute the selfcheck or sendsize service, as these require a valid REQ packet. If you have already uccessfully run amanda, you can find valid REQ packets in the amandad.*.debug files. EXIT CODE
The exit code of amservice is one of: 0 = success 1 = error executing amandad on the client. As amservice doesn't parse the REP packet, it can only detect failures in executing amandad on the client. amservice can exit with value 0 even if the user is not authorized to execute the service. An error message will be printed. SEE ALSO
amanda(8), amanda(8), amcheck(8), amdump(8), amadmin(8) The Amanda Wiki: : http://wiki.zmanda.com/ AUTHOR
Jean-Louis Martineau <martineau@zmanda.com> Zmanda, Inc. (http://www.zmanda.com) Amanda 3.3.3 01/10/2013 AMSERVICE(8)
Check Out this Related Man Page
AMADDCLIENT(8) System Administration Commands AMADDCLIENT(8) NAME
amaddclient - program to add client to an existing Amanda configuration SYNOPSIS
amaddclient --config config || --client client name || --diskdev directory to backup [--m] [--dumptype string] [--includefile string] [--includelist string] [--excludefile string] [--excludelist string] [--user string] [--auth string] [--gnutar_list_dir string] [--amandates string] [--no-client-update] [--batch] [--help] DESCRIPTION
After Amanda rpms are successfully installed and amserverconfig is run, amaddclient will add client to the Amanda configuration. amaddclient create or update Amanda disklist(5) file and create or update /var/lib/amanda/.amandahosts file on the server. If --no-client-update is not specified, amaddclient will attempt to update or create /var/lib/amanda/.amandahost, amanda-client.conf and gnutar-lists on the client. (See ssh-keygen(1) and ssh-add(1) for detail.) amaddclient must be run by user amandabackup. --config, --client and --diskdev must be specified. OPTIONS
Options may be abbreviated, as long as the abbreviation is not ambiguous. Option argument can either separated by '=' or a space. Example: --conf=v253, --client client8.zmanda.com --config config Amanda configuration which this program will add the client to. --client client The name of the client machine to add. FQDN name recommended. --diskdev diskdev Directory for this Amanda configuration to backup. --m Modify existing entry in the disklist(5) file. Note: if disklist(5) file has been modified manually, this option might not work. --dumptype dumptype dumptype to use. Dumptype must be defined in /etc/amanda/template.d/dumptypes or /etc/amanda/$config/amanda.conf file. Default: [user-tar] --user string name of user using amrecover on the client, default is root. --auth string authentication method to use when running amrecover from the client , default is bsdtcp. --gnutar_list_dir string directory where gnutar keep its state file on the client. Absolute path required. Default is /var/lib/amanda/gnutar-lists. If --no-client-update is not set, this program will attempt to create the directory on the client. --amandates string file where amanda keep the date of each dumplevel on the client, default is /etc/amandates. --batch Turn on batch mode when copying files to the client, default is off --no-client-update If this option is set, amaddclient will not attempt to update/create .amandahosts, amanda-client.conf and gnutar-lists file on the client. --help Display usage. If any of the following four options are used, amaddclient will extend the dumptype definition to an in-line definition in the disklist(5) file. --includefile string string is a glob expression --includelist string string is a file name on the client containing glob expressions. Specify either --includefile or --includelist. --excludefile string string is a glob expression --excludelist string string is a file name on the client containing glob expressions. Specify either --excludefile or --excludelist. FILES
/var/lib/amanda/template.d Amanda configuration template files install location /var/lib/amanda amandabackup home directory /var/lib/amanda/.amandahosts Amanda authentication file. /var/lib/amanda/gnutar-lists A directory which contains backup timestamp and list of files backed up. /etc/amanda/$config Amanda configuration files location for $config(e.g: DailySet1). /etc/amanda/template.d A directory contains dumptypes and tapetypes files used by all Amanda configurations. /etc/amandates Amanda file on the client. It keeps track of structures of previous dumps. /tmp/amanda directory contains Amanda debug log files. RETURN VALUE
On success, zero is returned. On error, 1 is returned. SEE ALSO
amanda(8), amanda.conf(5), amserverconfig(8), ssh-keygen(1), ssh-add(1), scp(1) The Amanda Wiki: : http://wiki.zmanda.com/ AUTHOR
Kevin Till <kevin.till@zmanda.com> Zmanda, Inc. (http://www.zmanda.com) Amanda 3.3.1 02/21/2012 AMADDCLIENT(8)