3 .\" Author: James da Silva <jds@amanda.org>
4 .\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
6 .\" Manual: System Administration Commands
7 .\" Source: Amanda 3.3.3
10 .TH "AMANDA" "8" "01/10/2013" "Amanda 3\&.3\&.3" "System Administration Commands"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
25 .\" disable justification (adjust text to left margin only)
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
31 amanda \- The Open Source Backup Platform
34 This manual page gives an overview of the Amanda commands and configuration files for quick reference\&.
37 Here are all the Amanda commands\&. Each one has its own manual page\&. See them for all the gory details\&.
113 \fBamcheckdump\fR(8),
135 \fBamcrypt-ossl-asym\fR(8),
146 \fBamcrypt-ossl\fR(8),
168 \fBamcryptsimple\fR(8),
201 \fBamfetchdump\fR(8),
366 \fBamserverconfig\fR(8),
465 \fBamzfs-sendrecv\fR(8),
476 \fBamzfs-snapshot\fR(8),
487 \fBscript-email\fR(8),
489 .SS "CONFIGURATION FILES"
499 \fBamanda.conf\fR(5),
510 \fBamanda-client.conf\fR(5),
544 \fBamanda-archive-format\fR(5),
556 \fBamanda-applications\fR(7),
567 \fBamanda-auth\fR(7),
578 \fBamanda-changers\fR(7),
589 \fBamanda-compatibility\fR(7),
600 \fBamanda-devices\fR(7),
611 \fBamanda-interactivity\fR(7),
622 \fBamanda-match\fR(7),
633 \fBamanda-scripts\fR(7),
644 \fBamanda-taperscan\fR(7),
646 .SH "CONFIGURATION FILES"
648 There are four user\-editable files that control the behavior of Amanda\&.
653 \fBamanda-client.conf\fR(5), the main configuration files for the server and client, respectively\&. They contain parameters to customize Amanda for the site\&.
657 file, which lists hosts and disk partitions to back up\&.
659 Last is the seldom\-edited
661 file, which lists tapes that are currently active\&. These files are described in more detail in the following sections\&.
663 All configuration files are stored in individual configuration directories, usually under
664 /etc/amanda/\&. A site will often have more than one configuration\&. For example, it might have a
666 configuration for everyday backups and an
668 configuration for infrequent full archival backups\&. The configuration files would be stored under directories
671 /etc/amanda/archive/, respectively\&. Part of the job of an Amanda administrator is to create, populate and maintain these directories\&.
673 Most Amanda applications take a "config" parameter; this is generally the (unqualified) name of the configuration directory, e\&.g\&.,
674 normal\&. If the parameter is
676 (dot), the current directory is used\&. This feature is present for backward compatibility, but is not commonly used\&.
677 .SS "Configuration Override"
679 Most commands allow the override of specific configuration options on the command line, using the
681 option\&. This option has the form
682 \-o\fIname\fR=\fIvalue\fR\&. An optional space is allowed after the
683 \-o\&. Each configuration option should be specified in a separate command\-line option\&.
687 is simply the name of the option, e\&.g\&.,
692 For options in a named section of the configuration,
695 \fISECTION\fR:\fIsection_name\fR:\fIname\fR, where
697 is one of TAPETYPE, DUMPTYPE, HOLDINGDISK, or INTERFACE, and
699 is the name of the tapetype, dumptype, holdingdisk, or interface\&. Examples:
702 amdump \-o TAPETYPE:HP\-DAT:length=2000m
703 amdump \-o DUMPTYPE:no\-compress:compress="server fast"
704 amdump \-o HOLDINGDISK:hd1:use="\-100 mb"
705 amdump \-o INTERFACE:local:use="2000 kbps"
708 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:
711 amdump \-o \*(Aqdevice\-property="PROPERTY_MAX_VOLUME_USAGE" "100000"\*(Aq
714 Note that configuration overrides are not effective for tape changers, which supply a tapedev based on their own configuration\&. In order to override
715 \fItapedev\fR, you must also disable any changer:
718 amdump \-otapedev=/dev/nst1 \-otpchanger=\*(Aq\*(Aq
722 \fBJames da Silva\fR <\&jds@amanda\&.org\&>
724 \fBStefan G\&. Weichinger\fR <\&sgw@amanda\&.org\&>