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

NAME

6       amstar - Amanda Application to interface with star
7

DESCRIPTION

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
12       The diskdevice in the disklist (DLE) must be the directory to backup.
13

INCLUDE - EXCLUDE

15       amstar doesn't support include. Both 'exclude list' and 'exclude file'
16       are supported. There is a maximum of 100 patterns (limit of star).
17
18       Moving directories into and out of directories on the exclude list
19       causes incremental backups to not contain the files in the moved
20       directories until the next full backup unless the moved files are
21       modified after the move.
22

PROPERTIES

24       This section lists the properties that control amstar's functionality.
25       See amanda-applications(7) for information on application properties
26       and how they are configured.
27
28       ACL
29
30           If "YES" (the default), amstar will store files acl by passing the
31           -acl argument to star. If "NO", then the -acl option is not given
32           to star, and it will not try to backup the acl.
33
34       COMMAND-OPTIONS
35           If set, theses options are passed asis to star. Each option must be
36           a different value of the property. Some option can break how amanda
37           do backup, use it with care.
38
39           Use:
40             property "COMMAND-OPTIONS" "--foo" "bar"
41
42           Do not use:
43             property "COMMAND-OPTIONS" "--foo bar"
44
45       DIRECTORY
46
47           If set, gnutar will backup from that directory instead of the
48           diskdevice set by the DLE. On restore, the data is restore in that
49           directpory instead of the current working directory.
50
51       ONE-FILE-SYSTEM
52
53           The default is "YES". This property is deprecated and the default
54           value can't be changed. star requires it when it works in dump
55           mode.  This corresponds to the -xdev option of star.
56
57       SPARSE
58
59           If "YES" (the default), star will store sparse files efficiently.
60           If "NO", then the -sparse option is not given to star, and it will
61           not try to detect sparse files.
62
63       STAR-DLE-TARDUMP
64
65           If "YES", amstar will use a different tardump file for each DLE.
66           The default is "NO".  This property is needed with older versions
67           of star doing many dumps in parallel, because of a race condition
68           in updating the tardump file.
69
70       STAR-PATH
71
72           The path to the star binary. The default is set when Amanda is
73           built by the --with-star configure option.
74
75       STAR-TARDUMP
76
77           The directory where star stores the database it uses to generate
78           incremental dumps.  The default is /etc/tardumps.
79
80       NORMAL
81
82           List all regex (POSIX Extended Regular Expression syntax) that are
83           normal output from star. These output are in the "FAILED DUMP
84           DETAILS" section of the email report if the dump result is STRANGE
85           or FAILED. Default values:
86             "^could not open conf file"
87             "^Type of this level "
88             "^Date of this level "
89             "^Date of last level "
90             "^Dump record  level "
91             "^Throughput"
92             "^.*is sparse$"
93             "^star: dumped [0-9][0-9]* (tar )?files"
94             "^.*The following problems occurred during .* processing.*$"
95             "^.*Processed all possible files, despite earlier errors.*$"
96             "^.*not written due to problems during backup.*$"
97           To treat one of these default patterns differently, specify it
98           explicitly in a different property.
99
100       IGNORE
101
102           List all regex (POSIX Extended Regular Expression syntax) that
103           amanda ignore. These output are never in the email report.
104
105       STRANGE
106
107           List all regex (POSIX Extended Regular Expression syntax) that are
108           strange output from star. All star output that doesn't match a
109           normal or ignore regex are strange by default. The result of the
110           dump is STRANGE if star produce a strange output. These output are
111           in the "FAILED DUMP DETAILS" section of the email report.
112             "^Perform a level 0 dump first.*$"
113           To treat one of these default patterns differently, specify it
114           explicitly in a different property.
115

SEE ALSO

117       amanda(8), amanda.conf(5), amanda-applications(7)
118
119       The Amanda Wiki: : http://wiki.zmanda.com/
120

AUTHORS

122       Jean-Louis Martineau <martineau@zmanda.com>
123           Zmanda, Inc. (http://www.zmanda.com)
124
125       Dustin J. Mitchell <dustin@zmanda.com>
126           Zmanda, Inc. (http://www.zmanda.com)
127
128
129
130Amanda 3.5.4                      07/27/2023                         AMSTAR(8)
Impressum