Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
AMSUNTAR(8)		System Administration Commands		   AMSUNTAR(8)

NAME
       amsuntar	- Amanda Application to	interface with native tar utility
       available on solaris platforms

DESCRIPTION
       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.

       The diskdevice in the disklist (DLE) must be the	directory to backup.

       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.

PROPERTIES
       This section lists the properties that control amsuntar's
       functionality. See amanda-applications(7) for information on
       application properties and how they are configured.

       BLOCK-SIZE

	   Optional tar	read or	write block size.  The default is 256.

       DIRECTORY

	   If set, suntar will backup from that	directory instead of the
	   diskdevice set by the DLE. On restore, the data is restore in that
	   directory instead of	the current working directory.

       EXTENDED-ATTRIBUTES

	   Include extended attributes in archive.  The	default	is YES.

       EXTENDED-HEADERS

	   Write tar file with extended	headers. With this optiion the
	   modification	time is	maintained with	a  granularity of
	   microseconds,Long file names	and file sizes greater than 8GB	can be
	   archived. The default is YES.

       SUNTAR-PATH

	   The path to the suntar binary. The default is set when Amanda is
	   built.

       LANG

	   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.

       NORMAL
	   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:

	   is not a file. Not dumped\$
	   same	as archive file\$

	   To treat one	of these default patterns differently, specify it
	   explicitly in a different property.

       IGNORE
	   List	all regex (Perl	Regular	Expression syntax) that	amanda ignore.
	   These output	are never in the email report.

       STRANGE
	   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:

	   : invalid character in UTF-8	conversion of
	   : UTF-8 conversion failed.\$

	   To treat one	of these default patterns differently, specify it
	   explicitly in a different property.

       ERROR
	   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:

	   : Permission	denied\$

	   To treat one	of these default patterns differently, specify it
	   explicitly in a different property.

SEE ALSO
       amanda(8), amanda.conf(5), amanda-applications(7)

       The Amanda Wiki:	: http://wiki.zmanda.com/

AUTHORS
       Satya Ganga <gast@zmanda.com>
	   Zmanda, Inc.	(http://www.zmanda.com)

       Jean-Louis Martineau <martineau@zmanda.com>
	   Zmanda, Inc.	(http://www.zmanda.com)

       Dustin J. Mitchell <dustin@zmanda.com>
	   Zmanda, Inc.	(http://www.zmanda.com)

Amanda 3.3.9			  02/09/2016			   AMSUNTAR(8)

NAME | DESCRIPTION | PROPERTIES | SEE ALSO | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=amsuntar&sektion=8&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help