1AMSTAR(8) System Administration Commands AMSTAR(8)
2
6 amstar - Amanda Application to interface with star
7
9 Amstar is an Amanda Application API script. It should not be run by
10 users directly. It uses star to backup and restore data.
11
13 This section lists the properties that control amstar´s functionality.
14 See amanda-applications(7) for information on application properties
15 and how they are configured.
16 COMMAND-OPTIONS
18 If set, theses options are passed asis to star. Each option must be
19 a different value of the property. Some option can break how amanda
20 do backup, use it with care.
21 Use:
23 property "COMMAND-OPTIONS" "--foo" "bar"
24 Do not use:
26 property "COMMAND-OPTIONS" "--foo bar"
27 DIRECTORY
29 If set, gnutar will backup from that directory instead of the
31 diskdevice set by the DLE. On restore, the data is restore in that
32 directpory instead of the current working directory.
33 ONE-FILE-SYSTEM
35 The default is "YES". This property is deprecated and the default
37 value can´t be changed. star requires it when it works in dump
38 mode. This corresponds to the -xdev option of star.
39 SPARSE
41 If "YES" (the default), star will store sparse files efficiently.
43 If "NO", then the -sparse option is not given to star, and it will
44 not try to detect sparse files.
45 STAR-DLE-TARDUMP
47 If "YES", amstar will use a different tardump file for each DLE.
49 The default is "NO". This property is needed with older versions
50 of star doing many dumps in parallel, because of a race condition
51 in updating the tardump file.
52 STAR-PATH
54 The path to the star binary. The default is set when Amanda is
56 built by the --with-star configure option.
57 STAR-TARDUMP
59 The directory where star stores the database it uses to generate
61 incremental dumps. The default is /etc/tardumps.
62 NORMAL
64 List all regex (POSIX Extended Regular Expression syntax) that are
66 normal output from star. These output are in the "FAILED DUMP
67 DETAILS" section of the email report if the dump result is STRANGE
68 or FAILED. Default values:
69 "^could not open conf file"
70 "^Type of this level "
71 "^Date of this level "
72 "^Date of last level "
73 "^Dump record level "
74 "^Throughput"
75 "^.*is sparse$"
76 "^star: dumped [0-9][0-9]* (tar )?files"
77 "^.*The following problems occurred during .* processing.*$"
78 "^.*Processed all possible files, despite earlier errors.*$"
79 "^.*not written due to problems during backup.*$"
80 To treat one of these default patterns differently, specify it
81 explicitly in a different property.
82 IGNORE
84 List all regex (POSIX Extended Regular Expression syntax) that
86 amanda ignore. These output are never in the email report.
87 STRANGE
89 List all regex (POSIX Extended Regular Expression syntax) that are
91 strange output from star. All star output that doesn´t match a
92 normal or ignore regex are strange by default. The result of the
93 dump is STRANGE if star produce a strange output. These output are
94 in the "FAILED DUMP DETAILS" section of the email report.
95 "^Perform a level 0 dump first.*$"
96 To treat one of these default patterns differently, specify it
97 explicitly in a different property.
98
100 amanda(8), amanda.conf(5), amanda-applications(7)
101 The Amanda Wiki: : http://wiki.zmanda.com/
103
105 Jean-Louis Martineau <martineau@zmanda.com>
106 Zmanda, Inc. (http://www.zmanda.com)
107 Dustin J. Mitchell <dustin@zmanda.com>
109 Zmanda, Inc. (http://www.zmanda.com)
110Amanda 3.1.3 10/04/2010 AMSTAR(8)