X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=man%2Fxml-source%2Famadmin.8.xml;h=7bc1f2f641b48a48d6d6770aab8027cf60fb111a;hb=b116e9366c7b2ea2c2eb53b0a13df4090e176235;hp=7efd5198efb4eb176dcae77b39fd06ecda36b281;hpb=a6127998ee6dcab6bb034f6ca985b07804a86f9a;p=debian%2Famanda diff --git a/man/xml-source/amadmin.8.xml b/man/xml-source/amadmin.8.xml index 7efd519..7bc1f2f 100644 --- a/man/xml-source/amadmin.8.xml +++ b/man/xml-source/amadmin.8.xml @@ -3,21 +3,29 @@ "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; + @@ -25,7 +33,7 @@ config command command_options - configoption + &configoverride.synopsis; @@ -34,29 +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 +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. +the command operates on all hosts and disks in the &disklist; when no hostname is given. Both hostname and disks -are special expressions; see the "HOST & DISK EXPRESSION" section -of amanda8 -for a description. - -Commands that take one or more dumpspec parameters operate -on the set of dumps specified by all of the expressions. See the "DUMP SPECIFICATIONS" -section of -amanda8 -for a description. +are match expressions; see for a description. @@ -66,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 + + + @@ -75,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. @@ -85,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. @@ -105,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. @@ -131,7 +162,7 @@ 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. @@ -144,7 +175,7 @@ security to be sure amanda will not overwrite them. - 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, @@ -154,14 +185,16 @@ and status are displayed. h: host name k: disk name -d: dump date +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. @@ -179,10 +212,12 @@ The default sort order is hkdlpb. holding list [-l] [-d] [ hostname [ disk [ datestamp [ .. ] ] ] ] - List holding files matching the given specification, or all holding - files if no specification is provided. With '-l', additional information - (size, level, and whether the dump is outdated) is provided. With '-d', only - outdated dumps are shown. + 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 @@ -203,10 +238,9 @@ 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. @@ -214,9 +248,9 @@ file, &A; 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. +. @@ -235,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. @@ -245,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. @@ -275,13 +320,7 @@ Mostly used for debugging. - - -o configoption - -See the "CONFIGURATION OVERRIDE" - section in amanda8. - - + &configoverride.varlistentry; @@ -289,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 @@ -300,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 @@ -361,21 +400,20 @@ date host disk lv tape or file file part status /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. @@ -394,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 @@ -425,22 +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, - - -