3 .\" Author: Satya Ganga <gast@zmanda.com>
4 .\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
6 .\" Manual: System Administration Commands
7 .\" Source: Amanda 3.3.2
10 .TH "AMSUNTAR" "8" "07/25/2012" "Amanda 3\&.3\&.2" "System Administration Commands"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
25 .\" disable justification (adjust text to left margin only)
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
31 amsuntar \- Amanda Application to interface with native tar utility available on solaris platforms
34 Amsuntar is an Amanda Application API script\&. It should not be run by users directly\&. It uses Solaris bundled tar utility to backup and restore data\&. Currenty ACLs from ZFS file system can only be backed up using the solaris supplied tar utility\&.
38 in the disklist (DLE) must be the directory to backup\&.
40 Solaris 10 supports Role Based Access Control(RBAC) which is enabled by default\&. To run backup operations using sun tar utility by under privileged user like amandabackup, amandabackup user need to have proper roles and profiles, specially "Media Backup" profile/role\&. This can be done using \*(Aqusermod \-P "Media Backup" amandabackup\*(Aq command\&.
43 This section lists the properties that control amsuntar\*(Aqs functionality\&. See
44 \fBamanda-applications\fR(7)
45 for information on application properties and how they are configured\&.
50 Optional tar read or write block size\&. The default is 256\&.
56 If set, suntar will backup from that directory instead of the \fIdiskdevice\fR set by the DLE\&. On restore, the data is restore in that directory instead of the current working directory\&.
62 Include extended attributes in archive\&. The default is YES\&.
68 Write tar file with extended headers\&. With this optiion the modification time
69 is maintained with a granularity of microseconds,Long file names and file
70 sizes greater than 8GB can be archived\&. The default is YES\&.
76 The path to the suntar binary\&. The default is set when Amanda is built\&.
82 Default LANG is "C"\&. suntar require an UTF\-8 LANG if you have UTF\-8 filename and it is configured for extended headers\&. A good value can be "en_US\&.UTF\-8" if that locale is installed on your machine\&.
87 List all regex (Perl Regular Expression syntax) that are normal output from sun tar\&. These output are in the "FAILED DUMP DETAILS" section of the email report if the dump result is STRANGE or FAILED\&. Default values:
90 is not a file\&. Not dumped\e$
91 same as archive file\e$
94 To treat one of these default patterns differently, specify it explicitly in a different property\&.
99 List all regex (Perl Regular Expression syntax) that amanda ignore\&. These output are never in the email report\&.
104 List all regex (Perl Regular Expression syntax) that are strange output from sun tar\&. The result of the dump is STRANGE if sun tar produce a strange output\&. These output are in the "FAILED DUMP DETAILS" section of the email report\&. Default values:
107 : invalid character in UTF\-8 conversion of
108 : UTF\-8 conversion failed\&.\e$
111 To treat one of these default patterns differently, specify it explicitly in a different property\&.
116 List all regex (perl Regular Expression syntax) that are error output from sun tar\&. All sun tar output that doesn\*(Aqt match a normal, ignore or strange regex are error by default\&. The result of the dump is FAILED if sun tar produce an error output\&. These output are in the "FAILED DUMP DETAILS" section of the email report\&. Default values:
119 : Permission denied\e$
122 To treat one of these default patterns differently, specify it explicitly in a different property\&.
127 \fBamanda.conf\fR(5),
128 \fBamanda-applications\fR(7)
131 : http://wiki.zmanda.com/
134 \fBSatya Ganga\fR <\&gast@zmanda\&.com\&>
136 Zmanda, Inc\&. (http://www\&.zmanda\&.com)
139 \fBJean\-Louis Martineau\fR <\&martineau@zmanda\&.com\&>
141 Zmanda, Inc\&. (http://www\&.zmanda\&.com)
144 \fBDustin J\&. Mitchell\fR <\&dustin@zmanda\&.com\&>
146 Zmanda, Inc\&. (http://www\&.zmanda\&.com)