3 .\" Author: James da Silva <jds@amanda.org>
4 .\" Generator: DocBook XSL Stylesheets vsnapshot_8273 <http://docbook.sf.net/>
6 .\" Manual: System Administration Commands
7 .\" Source: Amanda 3.2.1
10 .TH "AMANDA" "8" "12/14/2010" "Amanda 3\&.2\&.1" "System Administration Commands"
11 .\" -----------------------------------------------------------------
12 .\" * set default formatting
13 .\" -----------------------------------------------------------------
14 .\" disable hyphenation
16 .\" disable justification (adjust text to left margin only)
18 .\" -----------------------------------------------------------------
19 .\" * MAIN CONTENT STARTS HERE *
20 .\" -----------------------------------------------------------------
22 amanda \- The Open Source Backup Platform
25 This manual page gives an overview of the Amanda commands and configuration files for quick reference\&.
28 Here are all the Amanda commands\&. Each one has its own manual page\&. See them for all the gory details\&.
104 \fBamcheckdump\fR(8),
126 \fBamcrypt-ossl-asym\fR(8),
137 \fBamcrypt-ossl\fR(8),
159 \fBamcryptsimple\fR(8),
192 \fBamfetchdump\fR(8),
357 \fBamserverconfig\fR(8),
456 \fBamzfs-sendrecv\fR(8),
467 \fBamzfs-snapshot\fR(8),
478 \fBscript-email\fR(8),
480 .SS "CONFIGURATION FILES"
490 \fBamanda.conf\fR(5),
501 \fBamanda-client.conf\fR(5),
535 \fBamanda-archive-format\fR(5),
547 \fBamanda-applications\fR(7),
558 \fBamanda-auth\fR(7),
569 \fBamanda-changers\fR(7),
580 \fBamanda-compatibility\fR(7),
591 \fBamanda-devices\fR(7),
602 \fBamanda-match\fR(7),
613 \fBamanda-scripts\fR(7),
624 \fBamanda-taperscan\fR(7),
626 .SH "CONFIGURATION FILES"
628 There are four user\-editable files that control the behavior of Amanda\&.
633 \fBamanda-client.conf\fR(5), the main configuration files for the server and client, respectively\&. They contain parameters to customize Amanda for the site\&.
637 file, which lists hosts and disk partitions to back up\&.
639 Last is the seldom\-edited
641 file, which lists tapes that are currently active\&. These files are described in more detail in the following sections\&.
643 All configuration files are stored in individual configuration directories, usually under
644 /etc/amanda/\&. A site will often have more than one configuration\&. For example, it might have a
646 configuration for everyday backups and an
648 configuration for infrequent full archival backups\&. The configuration files would be stored under directories
651 /etc/amanda/archive/, respectively\&. Part of the job of an Amanda administrator is to create, populate and maintain these directories\&.
653 Most Amanda applications take a "config" parameter; this is generally the (unqualified) name of the configuration directory, e\&.g\&.,
654 normal\&. If the parameter is
656 (dot), the current directory is used\&. This feature is present for backward compatibility, but is not commonly used\&.
657 .SS "Configuration Override"
659 Most commands allow the override of specific configuration options on the command line, using the
661 option\&. This option has the form
662 \-o\fIname\fR=\fIvalue\fR\&. An optional space is allowed after the
663 \-o\&. Each configuration option should be specified in a separate command\-line option\&.
667 is simply the name of the option, e\&.g\&.,
672 For options in a named section of the configuration,
675 \fISECTION\fR:\fIsection_name\fR:\fIname\fR, where
677 is one of TAPETYPE, DUMPTYPE, HOLDINGDISK, or INTERFACE, and
679 is the name of the tapetype, dumptype, holdingdisk, or interface\&. Examples:
682 amdump \-o TAPETYPE:HP\-DAT:length=2000m
683 amdump \-o DUMPTYPE:no\-compress:compress="server fast"
684 amdump \-o HOLDINGDISK:hd1:use="\-100 mb"
685 amdump \-o INTERFACE:local:use="2000 kbps"
688 When overriding device properties, one must carefully quote the command line to simulate the syntax of real configuration files\&. The following example should serve as a guide:
691 amdump \-o \'device\-property="PROPERTY_MAX_VOLUME_USAGE" "100000"\'
694 Note that configuration overrides are not effective for tape changers, which supply a tapedev based on their own configuration\&. In order to override
695 \fItapedev\fR, you must also disable any changer:
698 amdump \-otapedev=/dev/nst1 \-otpchanger=\'\'
702 \fBJames da Silva\fR <\&jds@amanda\&.org\&>
704 \fBStefan G\&. Weichinger\fR <\&sgw@amanda\&.org\&>