X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=man%2Fxml-source%2Famanda-changers.7.xml;h=1520f278b47b60a902f29d1b1d7a478ad308dc86;hb=b221e8dc16f345f8c8d7df8df71f4d36daaabb4c;hp=9846a12066e2e942acc5ae0fcfbb6523f3202b37;hpb=fd48f3e498442f0cbff5f3606c7c403d0566150e;p=debian%2Famanda
diff --git a/man/xml-source/amanda-changers.7.xml b/man/xml-source/amanda-changers.7.xml
index 9846a12..1520f27 100644
--- a/man/xml-source/amanda-changers.7.xml
+++ b/man/xml-source/amanda-changers.7.xml
@@ -97,7 +97,7 @@ define changer hp-robot {
tapedev "chg-robot:/dev/sg1"
property "tape-device" "0=tape:/dev/nst0"
property append "tape-device" "1=tape:/dev/nst1"
- device_property "BLOCK_SIZE" "512k"
+ device-property "BLOCK_SIZE" "512k"
}
# ...
tapedev "hp-robot"
@@ -111,7 +111,7 @@ changer definition, as in the hp-robot example, above.Devices, too, can take properties to control their behavior (see ). Device properties can come from four
places: implicit device properties (from tapetype parameters), global device
-properties (from global device_property parameters),
+properties (from global device-property parameters),
properties in device definitions, and properties in changer definitions.
Properties are applied in this order, with later properties taking
priority.
@@ -134,9 +134,42 @@ specified by an alias, then properties from that definition applied.
This section lists the changer drivers included with Amanda, and basic instructions for using them. For complete How-To information, consult the Amanda wiki at http://wiki.zmanda.com.
+chg-aggregate:changer (new)
+
+define changer robot0 {
+ tpchanger "chg-robot:/dev/sg0"
+ property "tape-device" "0=tape:/dev/rmt/0" "1=tape:/dev/rmt/1"
+}
+define changer robot1 {
+ tpchanger "chg-robot:/dev/sg1"
+ property "tape-device" "0=tape:/dev/rmt/2" "1=tape:/dev/rmt/3"
+}
+define changer single {
+ tpchanger "chg-single:/dev/rmt/4"
+}
+define changer aggregate {
+ tpchanger "chg-aggregate:{robot0,robot1,single}"
+ property "state-filename" "/etc/amanda/CONF/aggregate.state"
+
+}
+tpchanger "aggregate"
+
+
+This changer driver allow to use two or more changers or standalone
+drive in sequence.
+
+
+
chg-disk:VTAPEROOT (new)
-tpchanger "chg-disk:/u01/vtapes"
+tpchanger "chg-disk:/var/mnt/vtapes"
+property "num-slot" "10"
+property "auto-create-slot" "yes"
+property "removable" "yes"
+property "mount" "yes"
+property "umount" "yes"
+property "umount-lockfile" "/etc/amanda/conf/vtapes-lock"
+property "umount-idle" "1"
This changer driver replaces the old chg-disk,
@@ -149,6 +182,45 @@ supporting parallel access to vtapes stored in directories named
file:VTAPEROOT. This is useful for the command line.
+Properties
+
+
+
+
+AUTO-CREATE-SLOT
+If a slotN directory in the range 1 to NUM-SLOT does not already exist, and this property is true, then the changer will create the directory.
+
+
+MOUNT
+If this property is true, the changer try to mount the removable disk if nothing is mounted. The system must be configured to allow the amanda user to mount it.
+
+
+NUM-SLOT
+The minimum number of slots in the changer, where the first slot is slot1. If additional slot directories exist, they will also be used.
+
+
+REMOVABLE
+If this property is true, then the changer will verify that the changer
+directory (e.g., /var/mnt/vtapes) is on a different
+filesystem from its parent directory (e.g., /var/mnt).
+This is useful for removable disks, as it will prevent Amanda from creating
+slot directories when the removable disk is not mounted.
+
+
+UMOUNT
+If this property is true, the changer try to umount the removable disk when it exit. The system must be configured to allow the amanda user to umount it.
+
+
+UMOUNT-LOCKFILE
+If UMOUNT is set, it require a lockfile outside of the mount point to prevent race.
+
+
+UMOUNT-IDLE
+If set, the changer try to umount the removable disk when it is not in use. The umount-idle value is a delay in second to wait before doing the umount. A value >= 1 is required to prevent useless mount/umount.
+
+
+
+
chg-disk (old)
@@ -183,6 +255,14 @@ all volumes for a configuration have different device names -- for example,
if you have many standalone drive. The changerfile must exist; it is used to save the state file.
+The child devices are specified using the same syntax as for the RAIT
+device (see ). The range
+specification can be especially useful here:
+
+tpchanger "chg-multi:s3:mycompany-backups/tape-{001..100}"
+
+
+
This changer is not fast-search capable.
Properties
@@ -359,8 +439,10 @@ define changer robot {
tpchanger "chg-rait:{vtape,robot}"
-This changer script constructs RAIT devices out of the devices provided by several "sub-changers". The sub-changers are specified using the same shell-like syntax as the RAIT device (see
-).
+This changer script constructs RAIT devices out of the devices provided
+by several "sub-changers". The sub-changers are specified using the same
+shell-like syntax as the RAIT device (see ).
Chg-rait does not require that all of the child changers have the same slot names: compound slot names are created by combining the slot names supplied by the child changers using the same shell-like syntax. For example, if the child changers return slots "top", "strange", and "3", then the RAIT changer will return "{top,strange,3}". This makes it possible to, for example, mirror data on tapes in slots 1-10 to tapes in slots 11-20 of the same robot, using two chg-zd-mtx child changers (and, naturally, two tape drives). In this arrangement, the first slot would be named {1,11}.
@@ -667,6 +749,10 @@ The password for the NDMP server.
The username for the NDMP server.
+VERBOSE
+If true, enables the NDMJOB library's verbose (packet-level) debugging.
+
+