git.gag.com Git - debian/amanda/blob - man/amsuntar.8

   1 '\" t
   2 .\"     Title: amsuntar
   3 .\"    Author: Satya Ganga <gast@zmanda.com>
   4 .\" Generator: DocBook XSL Stylesheets vsnapshot_8273 <http://docbook.sf.net/>
   5 .\"      Date: 10/18/2010
   6 .\"    Manual: System Administration Commands
   7 .\"    Source: Amanda 3.2.0
   8 .\"  Language: English
   9 .\"
  10 .TH "AMSUNTAR" "8" "10/18/2010" "Amanda 3\&.2\&.0" "System Administration Commands"
  11 .\" -----------------------------------------------------------------
  12 .\" * set default formatting
  13 .\" -----------------------------------------------------------------
  14 .\" disable hyphenation
  15 .nh
  16 .\" disable justification (adjust text to left margin only)
  17 .ad l
  18 .\" -----------------------------------------------------------------
  19 .\" * MAIN CONTENT STARTS HERE *
  20 .\" -----------------------------------------------------------------
  21 .SH "NAME"
  22 amsuntar \- Amanda Application to interface with native tar utility available on solaris platforms
  23 .SH "DESCRIPTION"
  24 .PP
  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\&.
  26 .PP
  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\&.
  28 .SH "PROPERTIES"
  29 .PP
  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\&.
  33 .PP
  34 BLOCK\-SIZE
  35 .RS 4
  36
  37 Optional tar read or write block size\&.  The default is 256\&.
  38 .RE
  39 .PP
  40 DIRECTORY
  41 .RS 4
  42
  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\&.
  44 .RE
  45 .PP
  46 EXTENDED\-ATTRIBUTES
  47 .RS 4
  48
  49 Include extended attributes in archive\&.  The default is YES\&.
  50 .RE
  51 .PP
  52 EXTENDED\-HEADERS
  53 .RS 4
  54
  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\&.
  58 .RE
  59 .PP
  60 LANG
  61 .RS 4
  62
  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\&.
  64 .RE
  65 .PP
  66 NORMAL
  67 .RS 4
  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:
  69 .sp
  70 .nf
  71 is not a file\&. Not dumped\e$
  72 same as archive file\e$
  73 .fi
  74 .sp
  75 To treat one of these default patterns differently, specify it explicitly in a different property\&.
  76 .RE
  77 .PP
  78 IGNORE
  79 .RS 4
  80 List all regex (Perl Regular Expression syntax) that amanda ignore\&. These output are never in the email report\&.
  81 .RE
  82 .PP
  83 STRANGE
  84 .RS 4
  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:
  86 .sp
  87 .nf
  88 : invalid character in UTF\-8 conversion of
  89 : UTF\-8 conversion failed\&.\e$
  90 .fi
  91 .sp
  92 To treat one of these default patterns differently, specify it explicitly in a different property\&.
  93 .RE
  94 .PP
  95 ERROR
  96 .RS 4
  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:
  98 .sp
  99 .nf
 100 : Permission denied\e$
 101 .fi
 102 .sp
 103 To treat one of these default patterns differently, specify it explicitly in a different property\&.
 104 .RE
 105 .SH "SEE ALSO"
 106 .PP
 107 \fBamanda\fR(8),
 108 \fBamanda.conf\fR(5),
 109 \fBamanda-applications\fR(7)
 110 .PP
 111 The Amanda Wiki:
 112 : http://wiki.zmanda.com/
 113 .SH "AUTHORS"
 114 .PP
 115 \fBSatya Ganga\fR <\&gast@zmanda\&.com\&>
 116 .RS 4
 117 Zmanda, Inc\&. (http://www\&.zmanda\&.com)
 118 .RE
 119 .PP
 120 \fBJean\-Louis Martineau\fR <\&martineau@zmanda\&.com\&>
 121 .RS 4
 122 Zmanda, Inc\&. (http://www\&.zmanda\&.com)
 123 .RE
 124 .PP
 125 \fBDustin J\&. Mitchell\fR <\&dustin@zmanda\&.com\&>
 126 .RS 4
 127 Zmanda, Inc\&. (http://www\&.zmanda\&.com)
 128 .RE