Amaddclient (8) Linux Manual Page

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.

Author

Kevin Till <kevin.till [at] zmanda.com>

Zmanda, Inc. (http://www.zmanda.com)

amaddclient (8) Linux Manual Page