X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=man%2Fxml-source%2Famanda.8.xml;h=1337822e33273c5e35134ff90afe509d530e046e;hb=fd48f3e498442f0cbff5f3606c7c403d0566150e;hp=96d548eecfe074f6d51828d55c8657a68f2dd9f6;hpb=96f35b20267e8b1a1c846d476f27fcd330e0b018;p=debian%2Famanda
diff --git a/man/xml-source/amanda.8.xml b/man/xml-source/amanda.8.xml
index 96d548e..1337822 100644
--- a/man/xml-source/amanda.8.xml
+++ b/man/xml-source/amanda.8.xml
@@ -3,7 +3,7 @@
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
[
-
+
%global_entities;
]>
@@ -28,7 +28,7 @@
DESCRIPTION
-This manual page gives an overview of the &A; commands and
+This manual page gives an overview of the Amanda commands and
configuration files for quick reference.
COMMANDS
-Here are all the &A; commands. Each one has its own manual page. See them for all the gory details.
+Here are all the Amanda commands. Each one has its own manual page. See them for all the gory details.
-amaddclient8,
+,
-amadmin8,
+,
-amaespipe8,
+,
-amcheck8,
+,
-amcheckdb8,
+,
-amcheckdump8,
+,
-amcleanup8,
+,
-amcrypt-ossl-asym8,
+,
-amcrypt-ossl8,
+,
-amcrypt8,
+,
-amcryptsimple8,
+,
-amdd8,
+,
-amdevcheck8,
+,
-amdump8,
+,
-amfetchdump8,
+,
-amflush8,
+,
-amgetconf8,
+,
-amgpgcrypt8,
+,
-amgtar8,
+,
-amlabel8,
+,
-ammt8,
+,
-amoverview8,
+,
-amplot8,
+,
-amrecover8,
+,
-amreport8,
+,
-amrestore8,
+,
-amrmtape8,
+,
-amsamba8,
+,
-amserverconfig8,
+,
-amservice8,
+,
-amstar8,
+,
-amstatus8,
+,
-amtape8,
+,
-amtapetype8,
+,
-amtoc8,
+,
-amvault8,
+,
-amzfs-sendrecv8,
+,
-amzfs-snapshot8,
+,
-script-email8,
+,
+
+
+,
+
+
+,
CONFIGURATION FILES
-amanda.conf5,
+,
-amanda-client.conf5,
+,
-disklist5,
+,
-tapelist5,
+,
DATA FORMATS
-amanda-archive-format5,
+,
CONCEPTS
-amanda-applications7,
+,
-amanda-auth7,
+,
-amanda-changers7,
+,
-amanda-devices7,
+,
-amanda-scripts7,
+,
+
+
+,
+
+
+,
CONFIGURATION
-There are four user-editable files that control the behavior of &A;.
+There are four user-editable files that control the behavior of Amanda.
The first two are &amconf; and &amclientconf;,
the main configuration files for the server and client, respectively.
-They contain parameters to customize &A; for the site.
+They contain parameters to customize Amanda for the site.
Next is the &disklist; file, which lists hosts and disk partitions to back up.
@@ -218,7 +230,7 @@ Last is the seldom-edited &tapelist;
file, which lists tapes that are currently active.
These files are described in more detail in the following sections.
-All files are stored in individual configuration
+All configuration files are stored in individual configuration
directories, usually under /etc/amanda/.
A site will often have more than
one configuration.
@@ -230,15 +242,22 @@ configuration for infrequent full archival backups.
The configuration files would be stored under directories
/etc/amanda/normal/ and
/etc/amanda/archive/, respectively.
-Part of the job of an &A; administrator is to create,
+Part of the job of an Amanda administrator is to create,
populate and maintain these directories.
+
+Most Amanda applications take a "config" parameter; this is generally the
+(unqualified) name of the configuration directory, e.g.,
+normal. If the parameter is . (dot),
+the current directory is used. This feature is present for backward
+compatibility, but is not commonly used.
+
LOG FILES
-All log and database files generated by &A; go in corresponding
+All log and database files generated by Amanda go in corresponding
directories somewhere.
The exact location is controlled by entries in
-amanda.conf5.
+.
A typical location would be under /var/adm/amanda.
For the above example, the files might go in
/var/adm/amanda/normal/ and
@@ -246,7 +265,7 @@ For the above example, the files might go in
As log files are no longer needed (no longer contain relevant information),
-&A; cycles them out in various ways, depending on the type of file.
+Amanda cycles them out in various ways, depending on the type of file.
Detailed information about
amdump
@@ -282,7 +301,7 @@ into a subdirectory of the main log directory (see the
parameter below)
named
oldlog.
-It is up to the &A; administrator to remove them from this
+It is up to the Amanda administrator to remove them from this
directory when desired.
Index (backup image catalogue) files older than the full dump
@@ -294,13 +313,13 @@ at the end of each run.
Using Samba
-For Samba access, &A; needs a file on the Samba server (which may
+For Samba access, Amanda needs a file on the Samba server (which may
or may not also be the tape server) named
/etc/amandapass
with share names, (clear text) passwords and (optional) domain names,
in that order, one per line, whitespace separated.
By default, the user used to connect to the PC is the same for all
-PC's and is compiled into &A;.
+PC's and is compiled into Amanda.
It may be changed on a host by host basis
by listing it first in the password field followed
by a percent sign and then the password.
@@ -310,12 +329,12 @@ For instance:
//another-pc/disk otheruser%otherpw
With clear text passwords, this file should obviously be tightly protected.
-It only needs to be readable by the &A;-user on the Samba server.
+It only needs to be readable by the Amanda-user on the Samba server.
HOST & DISK EXPRESSION
All host and disk arguments to programs are special expressions.
-The command applies to all disks that match your arguments.
+The command applies to all DLEs that match the arguments.
This section describes the matcher.
The matcher matches by word, each word is a glob expression, words
@@ -326,6 +345,7 @@ is case insensitive for host but is case sensitive for disk. A match
succeeds if all words in your expression match contiguous words in
the host or disk.
+If the disk is a UNC ("\\windows\share") then all '\' are converted to '/' before the match. Using '\' is complicated because of the extra quoting required by the shell and amanda. It's easier to use '/' because it require less quoting ("//windows/share")
@@ -339,6 +359,11 @@ the host or disk.
word separator for a disk
+
+ \
+ word separator for a UNC disk
+
+
^
anchor at left
@@ -364,8 +389,22 @@ the host or disk.
match zero or more characters including the separator
+
+ [...]
+ match a single character, namely any of the characters
+ enclosed by the brackets.
+
+
+
+ [!...]
+ match a single character, namely any characters that is not
+ enclosed by the brackets.
+
+
+The shell interpret some of these characters, they must be escaped by a backslash '\' and/or the expression must be enclosed in simple or double quote.
+
Some examples:
@@ -464,6 +503,27 @@ the host or disk.
+
+ share
+
+ Will match the disks \\windows1\share and \\windows2\share.
+
+
+
+
+ share*
+
+ Will match the disks \\windows\share1 and \\windows\share2.
+
+
+
+
+ //windows/share
+
+ Will match the disk \\windows\share.
+
+
+