1AMGTAR(8)               System Administration Commands               AMGTAR(8)
2
3
4

NAME

6       amgtar - Amanda Application to interface with GNU Tar
7

DESCRIPTION

9       Amgtar is an Amanda Application API script. It should not be run by
10       users directly. It uses GNU Tar to backup and restore data.
11

PROPERTIES

13       This section lists the properties that control amgtar´s functionality.
14       See amanda-applications(7) for information on application properties
15       and how they are configured.
16
17       ATIME-PRESERVE
18
19           If "YES" (the default), amgtar use the --atime-preserve=system
20           option of gnutar to not update the atime of all files accessed; if
21           "NO", gnutar will updates the atime for all files accessed. This
22           property works only if you have gnutar 1.15.90 or newer, if not,
23           you must set ATIME_PRESERVE to "NO".
24
25       CHECK-DEVICE
26
27           If "YES" (the default), amgtar checks that the device number
28           doesn´t change for each file. If "NO", changes in device number are
29           ignored.  To ignore device numbers, tar must support the
30           --no-check-device option (gnutar 1.19.90 and newer). This option is
31           needed for some filesystems and devices on which device numbers
32           change frequently, such as LVM or FiberChannel.
33
34       DIRECTORY
35
36           If set, gnutar will backup from that directory instead of the
37           diskdevice set by the DLE.
38
39       GNUTAR-LISTDIR
40
41           The directory where gnutar stores the database it uses to generate
42           incremental dumps.  The default is set when Amanda is built.
43
44       GNUTAR-PATH
45
46           The path to the gnutar binary.  The default is set when Amanda is
47           built.
48
49       ONE-FILE-SYSTEM
50
51           If "YES" (the default), do not allow gnutar to cross filesystem
52           boundaries. If "NO", gnutar will cross filesystem boundaries.  This
53           corresponds to the --one-filesystem option of gnutar.
54
55       TAR-BLOCKSIZE
56
57           Block size of Nx512 bytes (default N=20).  This corresponds to the
58           --blocking-factor option of gnutar.
59
60       SPARSE
61
62           If "YES" (the default), gnutar will store sparse files efficiently.
63           If "NO", then the --sparse option is not given to gnutar, and it
64           will not try to detect sparse files.
65
66       EXIT-HANDLING
67
68           List which exit status of gtar are good or bad. eg. "1=GOOD 2=BAD",
69           exit status of 1 will produce a good backup, exit status of 2 will
70           give an error.
71
72       NORMAL
73
74           List all regex (POSIX Extended Regular Expression syntax) that are
75           normal output from gtar. These output are in the "FAILED DUMP
76           DETAILS" section of the email report if the dump result is STRANGE
77           or FAILED. Default values:
78             "^could not open conf file"
79             "^Elapsed time:"
80             "^Throughput"
81             ": socket ignored$"
82             ": File .* shrunk by [0-9][0-9]* bytes, padding with zeros"
83             ": Cannot add file .*: No such file or directory$"
84             ": Error exit delayed from previous errors"
85           To treat one of these default patterns differently, specify it
86           explicitly in a different property.
87
88       IGNORE
89
90           List all regex (POSIX Extended Regular Expression syntax) that
91           amanda ignore. These output are never in the email report. Default
92           values:
93             ": Directory is new$"
94             ": Directory has been renamed"
95           To treat one of these default patterns differently, specify it
96           explicitly in a different property.
97
98       STRANGE
99
100           List all regex (POSIX Extended Regular Expression syntax) that are
101           strange output from gtar. All gtar output that doesn´t match a
102           normal or ignore regex are strange by default. The result of the
103           dump is STRANGE if gtar produce a strange output. These output are
104           in the "FAILED DUMP DETAILS" section of the email report.
105

EXAMPLE

107         define application-tool app_amgtar {
108           property "ATIME-PRESERVE" "NO"
109           property "CHECK-DEVICE" "YES"
110           property "GNUTAR-LISTDIR" "
111           property "GNUTAR-PATH" "/bin/tar"
112           property "ONE-FILE-SYSTEM" "YES"
113           property "TAR_BLOCKSIZE" "20"
114           property "SPARSE" "YES"
115           property "EXIT-HANDLING" "1=GOOD 2=BAD"
116           # change a default NORMAL regex to a STRANGE regex.
117           property "STRANGE" ": socket ignored$"
118           # add three new IGNORE regex
119           property "IGNORE" ": Directory is new$"
120           property append "IGNORE" ": Directory has been renamed"
121           property append "IGNORE" "file changed as we read it$"
122         }
123

SEE ALSO

125       amanda.conf(5), amanda-applications(7)
126

AUTHORS

128       Jean-Louis Martineau <martineau@zmanda.com>
129           Zmanda, Inc. (http://www.zmanda.com)
130
131       Dustin J. Mitchell <dustin@zmanda.com>
132           Zmanda, Inc. (http://www.zmanda.com)
133
134
135
136Amanda 2.6.1p2                    11/05/2009                         AMGTAR(8)
Impressum