X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=man%2Fxml-source%2Famadmin.8.xml;h=7bc1f2f641b48a48d6d6770aab8027cf60fb111a;hb=b116e9366c7b2ea2c2eb53b0a13df4090e176235;hp=d98bd78e62868cfab88b21be5ab077ae9066142f;hpb=12179dea039515c06168c0037d048566a3f623de;p=debian%2Famanda diff --git a/man/xml-source/amadmin.8.xml b/man/xml-source/amadmin.8.xml index d98bd78..7bc1f2f 100644 --- a/man/xml-source/amadmin.8.xml +++ b/man/xml-source/amadmin.8.xml @@ -3,29 +3,37 @@ "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [ - + %global_entities; ]> + amadmin 8 +&rmi.source; +&rmi.version; +&rmi.manual.8; amadmin -administrative interface to control &A; backups +administrative interface to control Amanda backups + +&author.jds; +&author.sgw.xml; + amadmin config command - commandoptions - -oconfigoption* + command_options + &configoverride.synopsis; @@ -34,37 +42,21 @@ Amadmin performs various administrative tasks on the config -&A; configuration. +Amanda configuration. See the -amanda8 -man page for more details about &A;. + +man page for more details about Amanda. COMMANDS -Commands that take a -hostname -[ -disks -] -parameter pair operate on all disks in the -disklist -for that -hostname -if no disks are specified. -Where -hostname -is also marked as being optional, -the command operates on all hosts and disks in the -disklist. -Both -hostname -and -disks -are special expressions, see the "HOST & DISK EXPRESSION" section -of -amanda8 -for a description. +Commands that take a hostname [ disks ] +parameter pair operate on all disks in the &disklist; for that +hostname if no disks are specified. Where +hostname is also marked as being optional, +the command operates on all hosts and disks in the &disklist; when no hostname is given. +Both hostname and disks +are match expressions; see for a description. @@ -74,6 +66,37 @@ for a description. The config parameter must be present but is ignored. + + + + estimate [ hostname [ disks ]* ]* + +Print the server estimate for the dles, each output lines have the following format: + + hostname diskname level size + + + +hostname +The quoted hostname + + + +diskname +The quoted diskname + + + +level +The level of the estimate + + + +size +The estimate size in kbytes + + + @@ -83,7 +106,7 @@ parameter must be present but is ignored. disks on hostname -to bump to a new incremental level during the next &A; run. +to bump to a new incremental level during the next Amanda run. @@ -93,7 +116,7 @@ to bump to a new incremental level during the next &A; run. disks on hostname -to not bump to a new incremental level during the next &A; run. +to not bump to a new incremental level during the next Amanda run. @@ -113,7 +136,7 @@ command. disks on hostname -to do a full (level 0) backup during the next &A; run. +to do a full (level 0) backup during the next Amanda run. @@ -139,7 +162,10 @@ will not be reused when their turn comes up again in the tape cycle. Note that if this causes the number of reusable tapes to drop below the amanda.conf tapecycle -value, &A; will request new tapes until the count is satisfied again. +value, Amanda will request new tapes until the count is satisfied again. +Tape marked no-reuse are available +for recovery, marking them no-reuse is a +security to be sure amanda will not overwrite them. @@ -149,26 +175,62 @@ value, &A; will request new tapes until the count is satisfied again. - find [ hkdlpb ] [ hostname [ disks ]* ]* + find [ hkdlpbfw ] [ hostname [ disks ]* ]* Display all backups currently on tape or in the holding disk. The tape label or holding disk filename, file number, and status are displayed. -The option changes the sort order using the following flags: - -h host name -k disk name -d dump date -l backup level -p dump part -b tape label +The option changes the sort order using the following flags: + +h: host name +k: disk name +d: dump timestamp +l: backup level +p: dump part +b: tape label +f: filenum on tape +w: write timestamp + An uppercase letter reverses the sort order for that key. -The default sort order is hkdlpb. +The default sort order is hkdlpbfw. + + holding delete hostname [ disk [ datestamp [ .. ] ] ] + + + Delete holding files matching the given specification. At least + a hostname must be provided. + + + + + + holding list [-l] [-d] [ hostname [ disk [ datestamp [ .. ] ] ] ] + + + List holding files matching the given dump specification, or all + holding files if no specification is provided. See for more information on dump + specifications. With '-l', additional information (size, level, and + whether the dump is outdated) is provided. With '-d', only outdated + dumps are shown. + + An outdated holding file is one which is not required for a + restore of the most recent dump. Note that + outdated dumps may still be required for restores at earlier dates. + For example, assume that a DLE had a level 0 on Monday, level + 1's Tuesday through Thursday, and a level 2 on Friday. Then the + files required for a restore of Fridays (the most recent) dump + are those from Monday (level 0), Thursday (level 1), and Friday + (level 2). Tuesday and Wednesday's files are outdated. + + + + delete [ hostname [ disks ]* ]+ @@ -176,19 +238,19 @@ The default sort order is hkdlpb. disks on hostname -from the &A; database. -If you do not also remove the disk from the -disklist -file, &A; will treat it as a new disk during the next run. +from the Amanda database. +If you do not also remove the disk from the &disklist; +file, Amanda will treat it as a new disk during the next run. + tape -Display the tape(s) &A; expects to write to during the next run. +Display the tape(s) Amanda expects to write to during the next run. See also -amcheck8. +. @@ -207,8 +269,8 @@ levels. export [ hostname [ disks ]* ]* -Convert records from the &A; database -to a text format that may be transmitted to another &A; machine and +Convert records from the Amanda database +to a text format that may be transmitted to another Amanda machine and imported. @@ -217,21 +279,32 @@ to a text format that may be transmitted to another &A; machine and Convert exported -records read from standard input to a form &A; uses +records read from standard input to a form Amanda uses and insert them into the database on this machine. disklist [ hostname [ disks ]* ]* -Display the -disklist +Display the &disklist; information for each of the disks on hostname (or all hosts). Mostly used for debugging. + + + + hosts + +Output a list of distinct hosts in the &disklist;, one per line, for easy use in shell scripts. + + + + dles + +Output a list of distinct DLEs in the &disklist;, one per line with host and diskname separated by a space, for easy use in shell scripts. @@ -247,13 +320,7 @@ Mostly used for debugging. - - -o configoption - -See the "CONFIGURATION OVERWRITE" - section in amanda8. - - + &configoverride.varlistentry; @@ -261,7 +328,7 @@ Mostly used for debugging. EXAMPLES Request three specific file systems on machine-a -get a full level 0 backup during the next &A; run. +get a full level 0 backup during the next Amanda run. $ amadmin daily force machine-a / /var /usr @@ -272,7 +339,7 @@ amadmin: machine-a:/usr is set to a forced level 0 tonight. Request all file systems on machine-b -get a full level 0 backup during the next &A; run. +get a full level 0 backup during the next Amanda run. $ amadmin daily force machine-b @@ -317,37 +384,36 @@ some type of error. $ amadmin daily find machine-c /var date host disk lv tape or file file part status -2000\-11\-09 machine\-c /var 0 000110 9 -- OK -2000\-11\-08 machine\-c /var 2 000109 2 -- OK -2000\-11\-07 machine\-c /var 2 /amanda/20001107/machine-c._var.2 0 OK -2000\-11\-06 machine\-c /var 2 000107 2 -- OK -2000\-11\-05 machine\-c /var 2 000106 3 -- OK -2000\-11\-04 machine\-c /var 2 000105 2 -- OK -2000\-11\-03 machine\-c /var 2 000104 2 -- OK -2000\-11\-02 machine\-c /var 2 000103 2 -- OK -2000\-11\-01 machine\-c /var 1 000102 5 -- OK -2000\-10\-31 machine\-c /var 1 000101 3 -- OK +2000-11-09 machine-c /var 0 000110 9 -- OK +2000-11-08 machine-c /var 2 000109 2 -- OK +2000-11-07 machine-c /var 2 /amanda/20001107/machine-c._var.2 0 OK +2000-11-06 machine-c /var 2 000107 2 -- OK +2000-11-05 machine-c /var 2 000106 3 -- OK +2000-11-04 machine-c /var 2 000105 2 -- OK +2000-11-03 machine-c /var 2 000104 2 -- OK +2000-11-02 machine-c /var 2 000103 2 -- OK +2000-11-01 machine-c /var 1 000102 5 -- OK +2000-10-31 machine-c /var 1 000101 3 -- OK Forget about the /workspace disk on machine-d. -If you do not also remove the disk from the -disklist -file, &A; will treat it as a new disk during the next run. +If you do not also remove the disk from the &disklist; +file, Amanda will treat it as a new disk during the next run. $ amadmin daily delete machine-d /workspace amadmin: machine-d:/workspace deleted from database. -amadmin: NOTE: you'll have to remove these from the disklist yourself. +amadmin: NOTE: you'll have to remove these from the &disklist; yourself. -Find the next tape &A; will use (in this case, 123456). +Find the next tape Amanda will use (in this case, 123456). $ amadmin daily tape -The next &A; run should go onto tape 123456 or a new tape. +The next Amanda run should go onto tape 123456 or a new tape. Show how well full backups are balanced across the dump cycle. @@ -366,17 +432,17 @@ before and after any compression, respectively. balance column shows how far off that night's backups are from the average size (shown at the bottom of the balance column). -&A; tries to keep the backups within +/- 5%, +Amanda tries to keep the backups within +/- 5%, but since the amount of data on each filesystem is always changing, -and &A; will never delay backups just to rebalance the schedule, +and Amanda will never delay backups just to rebalance the schedule, it is common for the schedule to fluctuate by larger percentages. In particular, in the case of a tape or backup failure, a bump will occur the following night, which will not be smoothed out until the next pass through the schedule. -The last line also shows an estimate of how many &A; runs will be +The last line also shows an estimate of how many Amanda runs will be made between full backups for a file system. In the example, a file system will probably have a full backup done -every eight times &A; is run (e.g. every eight days). +every eight times Amanda is run (e.g. every eight days). $ amadmin daily balance @@ -397,20 +463,13 @@ TOTAL 241 12412187 7316312 731631 (estimated 8 runs per dumpcycle) -FILES -/usr/local/etc/amanda/config/amanda.conf - + +, +, +, +, + +, + -AUTHOR -James da Silva, &email.jds; : Original text -&maintainer.sgw;: XML-conversion - - -SEE ALSO -amanda8, -amcheck8, -amdump8, -amrestore8, -amfetchdump8 -