1AMSUNTAR(8) System Administration Commands AMSUNTAR(8)
2
6 amsuntar - Amanda Application to interface with native tar utility
7 available on solaris platforms
8
10 Amsuntar is an Amanda Application API script. It should not be run by
11 users directly. It uses Solaris bundled tar utility to backup and
12 restore data. Currenty ACLs from ZFS file system can only be backed up
13 using the solaris supplied tar utility.
14 The diskdevice in the disklist (DLE) must be the directory to backup.
16 Solaris 10 supports Role Based Access Control(RBAC) which is enabled by
18 default. To run backup operations using sun tar utility by under
19 privileged user like amandabackup, amandabackup user need to have
20 proper roles and profiles, specially "Media Backup" profile/role. This
21 can be done using 'usermod -P "Media Backup" amandabackup' command.
22
24 This section lists the properties that control amsuntar's
25 functionality. See amanda-applications(7) for information on
26 application properties and how they are configured.
27 BLOCK-SIZE
29 Optional tar read or write block size. The default is 256.
31 DIRECTORY
33 If set, suntar will backup from that directory instead of the
35 diskdevice set by the DLE. On restore, the data is restore in that
36 directory instead of the current working directory.
37 EXTENDED-ATTRIBUTES
39 Include extended attributes in archive. The default is YES.
41 EXTENDED-HEADERS
43 Write tar file with extended headers. With this optiion the
45 modification time is maintained with a granularity of
46 microseconds,Long file names and file sizes greater than 8GB can be
47 archived. The default is YES.
48 SUNTAR-PATH
50 The path to the suntar binary. The default is set when Amanda is
52 built.
53 LANG
55 Default LANG is "C". suntar require an UTF-8 LANG if you have UTF-8
57 filename and it is configured for extended headers. A good value
58 can be "en_US.UTF-8" if that locale is installed on your machine.
59 NORMAL
61 List all regex (Perl Regular Expression syntax) that are normal
62 output from sun tar. These output are in the "FAILED DUMP DETAILS"
63 section of the email report if the dump result is STRANGE or
64 FAILED. Default values:
65 is not a file. Not dumped\$
67 same as archive file\$
68 To treat one of these default patterns differently, specify it
70 explicitly in a different property.
71 IGNORE
73 List all regex (Perl Regular Expression syntax) that amanda ignore.
74 These output are never in the email report.
75 STRANGE
77 List all regex (Perl Regular Expression syntax) that are strange
78 output from sun tar. The result of the dump is STRANGE if sun tar
79 produce a strange output. These output are in the "FAILED DUMP
80 DETAILS" section of the email report. Default values:
81 : invalid character in UTF-8 conversion of
83 : UTF-8 conversion failed.\$
84 To treat one of these default patterns differently, specify it
86 explicitly in a different property.
87 ERROR
89 List all regex (perl Regular Expression syntax) that are error
90 output from sun tar. All sun tar output that doesn't match a
91 normal, ignore or strange regex are error by default. The result of
92 the dump is FAILED if sun tar produce an error output. These output
93 are in the "FAILED DUMP DETAILS" section of the email report.
94 Default values:
95 : Permission denied\$
97 To treat one of these default patterns differently, specify it
99 explicitly in a different property.
100
102 amanda(8), amanda.conf(5), amanda-applications(7)
103 The Amanda Wiki: : http://wiki.zmanda.com/
105
107 Satya Ganga <gast@zmanda.com>
108 Zmanda, Inc. (http://www.zmanda.com)
109 Jean-Louis Martineau <martineau@zmanda.com>
111 Zmanda, Inc. (http://www.zmanda.com)
112 Dustin J. Mitchell <dustin@zmanda.com>
114 Zmanda, Inc. (http://www.zmanda.com)
115Amanda 3.5.4 07/27/2023 AMSUNTAR(8)