X-Git-Url: https://git.gag.com/?p=debian%2Famanda;a=blobdiff_plain;f=man%2Fxml-source%2Famanda.8.xml;h=7162c175c1f38bc9a7df8235a772421e87e9695b;hp=1337822e33273c5e35134ff90afe509d530e046e;hb=b116e9366c7b2ea2c2eb53b0a13df4090e176235;hpb=fd48f3e498442f0cbff5f3606c7c403d0566150e diff --git a/man/xml-source/amanda.8.xml b/man/xml-source/amanda.8.xml index 1337822..7162c17 100644 --- a/man/xml-source/amanda.8.xml +++ b/man/xml-source/amanda.8.xml @@ -205,6 +205,9 @@ configuration files for quick reference. , +, + + , @@ -214,7 +217,7 @@ configuration files for quick reference. -CONFIGURATION +CONFIGURATION FILES There are four user-editable files that control the behavior of Amanda. @@ -251,371 +254,7 @@ populate and maintain these directories. 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 Amanda go in corresponding -directories somewhere. -The exact location is controlled by entries in -. -A typical location would be under /var/adm/amanda. -For the above example, the files might go in -/var/adm/amanda/normal/ and -/var/adm/amanda/archive/. - - -As log files are no longer needed (no longer contain relevant information), -Amanda cycles them out in various ways, depending on the type of file. - -Detailed information about -amdump -runs are stored in dump logs -- files named -amdump.NN -where -NN -is a sequence number, with 1 being the most recent file. -Amdump -rotates these files each run, keeping roughly the last -tapecycle -(see below) -worth of them. - -The file used by -amreport -to generate the mail summary is the trace log. This file constitutes the "catalog" -describing the data on the tapes written in a run. It is named -log.YYYYMMDDHHMMSS.NN -where -YYYYMMDDHHMMSS -is the datestamp of the start of the -amdump or amflush -run and -NN -is a sequence number started at 0. -At the end of each -amdump -run, -log files for runs whose tapes have been reused are renamed -into a subdirectory of the main log directory (see the -logdir -parameter below) -named -oldlog. -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 -matching the oldest backup image for a given client and disk -are removed by -amdump -at the end of each run. - - - -Using Samba -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 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. -For instance: - - //some-pc/home normalpw - //another-pc/disk otheruser%otherpw - -With clear text passwords, this file should obviously be tightly protected. -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 DLEs that match the arguments. -This section describes the matcher. - -The matcher matches by word, each word is a glob expression, words -are separated by the separator '.' for host and '/' for disk. You -can anchor the expression at left with a '^'. You can -anchor the expression at right with a '$'. The matcher -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") - - - - - dot (.) - word separator for a host - - - - / - word separator for a disk - - - - \ - word separator for a UNC disk - - - - ^ - anchor at left - - - - $ - anchor at right - - - - ? - match exactly one character except the separator - - - - * - match zero or more characters except the separator - - - - ** - 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: - - - - hosta - - Will match hosta, foo.hosta.org, and - hoSTA.dOMAIna.ORG but not hostb. - - - - - host - - Will match host but not hosta. - - - - - host? - - Will match hosta and hostb, but - not host. - - - - - ho*na - - Will match hoina - but not ho.aina.org. - - - - - ho**na - - Will match hoina - and ho.aina.org. - - - - - ^hosta - - Will match hosta - but not foo.hosta.org. - - - - - sda* - - Will match /dev/sda1 - and /dev/sda12. - - - - - /opt - - Will match the disk opt - but not the host opt. - - - - - (note dots:) .opt. - - Will match the host opt - but not the disk opt. - - - - - / - - Will match the disk / - but no other disk. - - - - - /usr - - Will match the disks /usr - and /usr/local. - - - - - /usr$ - - Will match the disks /usr - but not /usr/local. - - - - - 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. - - - - - - - - -DATESTAMP EXPRESSION -A -datestamp -expression is a range expression where we only match the prefix. -Leading ^ is removed. Trailing $ forces an exact match. - - - - - 20001212-14 - match all dates beginning with 20001212, 20001213 or 20001214 - - - - 20001212-4 - same as previous - - - - 20001212-24 - match all dates between 20001212 and 20001224 - - - - 2000121 - match all dates that start with 2000121 (20001210-20001219) - - - - 2 - match all dates that start with 2 (20000101-29991231) - - - - 2000-10 - match all dates between 20000101-20101231 - - - - 200010$ - match only 200010 - - - - - - -DUMP SPECIFICATIONS A dump -specification selects one or more dumps. It has the form [host][:disk][@datestamp], where each component -is a pattern as described above. If a component is missing, it -is treated as a wildcard. The characters ':', '@', and '\' may be -escaped within any component by preceding them with a '\'. - -Some examples: - - - - client17 - all dumps of client17 - - - - @20080615 - All dumps on with datestamps matching 20080615 - - - - webserver:/var/www - All dumps of /var/www on host webserver - - - - webserver:/var/www@200806150317 - The dump of webserver with datestamp 200806150317 - - - - :/var/www - All dumps of /var/www on any host - - - - - - -CONFIGURATION OVERRIDE +Configuration Override Most commands allow the override of specific configuration options on the command line, using the -o option. This option has the form + +