3 .\" Author: Satya Ganga <gast@zmanda.com>
4 .\" Generator: DocBook XSL Stylesheets vsnapshot_8273 <http://docbook.sf.net/>
6 .\" Manual: System Administration Commands
7 .\" Source: Amanda 3.2.1
10 .TH "AMSUNTAR" "8" "12/14/2010" "Amanda 3\&.2\&.1" "System Administration Commands"
11 .\" -----------------------------------------------------------------
12 .\" * set default formatting
13 .\" -----------------------------------------------------------------
14 .\" disable hyphenation
16 .\" disable justification (adjust text to left margin only)
18 .\" -----------------------------------------------------------------
19 .\" * MAIN CONTENT STARTS HERE *
20 .\" -----------------------------------------------------------------
22 amsuntar \- Amanda Application to interface with native tar utility available on solaris platforms
25 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\&.
27 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 \'usermod \-P "Media Backup" amandabackup\' command\&.
30 This section lists the properties that control amsuntar\'s functionality\&. See
31 \fBamanda-applications\fR(7)
32 for information on application properties and how they are configured\&.
37 Optional tar read or write block size\&. The default is 256\&.
43 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\&.
49 Include extended attributes in archive\&. The default is YES\&.
55 Write tar file with extended headers\&. With this optiion the modification time
56 is maintained with a granularity of microseconds,Long file names and file
57 sizes greater than 8GB can be archived\&. The default is YES\&.
63 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\&.
68 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:
71 is not a file\&. Not dumped\e$
72 same as archive file\e$
75 To treat one of these default patterns differently, specify it explicitly in a different property\&.
80 List all regex (Perl Regular Expression syntax) that amanda ignore\&. These output are never in the email report\&.
85 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:
88 : invalid character in UTF\-8 conversion of
89 : UTF\-8 conversion failed\&.\e$
92 To treat one of these default patterns differently, specify it explicitly in a different property\&.
97 List all regex (perl Regular Expression syntax) that are error output from sun tar\&. All sun tar output that doesn\'t 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:
100 : Permission denied\e$
103 To treat one of these default patterns differently, specify it explicitly in a different property\&.
108 \fBamanda.conf\fR(5),
109 \fBamanda-applications\fR(7)
112 : http://wiki.zmanda.com/
115 \fBSatya Ganga\fR <\&gast@zmanda\&.com\&>
117 Zmanda, Inc\&. (http://www\&.zmanda\&.com)
120 \fBJean\-Louis Martineau\fR <\&martineau@zmanda\&.com\&>
122 Zmanda, Inc\&. (http://www\&.zmanda\&.com)
125 \fBDustin J\&. Mitchell\fR <\&dustin@zmanda\&.com\&>
127 Zmanda, Inc\&. (http://www\&.zmanda\&.com)