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

FreeBSD Manual Pages

  
 
  

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

NAME
       amvault - Copy Amanda dumps from	one volume to another

SYNOPSIS
       amvault [-o configoption...] [--dry-run | -n] [--quiet |	-q]
	       [--fulls-only] [--latest-fulls] [--incrs-only] [--exact-match]
	       [--export] [--no-interactivity] [--src-labelstr labelstr]
	       [--src-timestamp	src-timestamp]
	       --label-template	label-template --dst-changer dst-changer
	       [--autolabel autolabel-arg...]
	       config
	       [hostname [ disk	[ date [ level [ hostname [...]	] ] ] ]]

WARNING
       This application	is not yet in its final	form, and is subject to	major
       revision	in subsequent versions of Amanda. Backward compatibility is
       not guaranteed.

       Note that Amanda	restore/recover	operations will	request	tertiary media
       by label	when dumpfiles are not found on	secondary media, but there is
       no provision to automatically fetch such	media from a different changer

       Feedback	on and patches to this application are invited and encouraged!

DESCRIPTION
       Amvault is conceptually equivalent to "amfetchdump | taper". That is,
       it reads	specified dumps	from secondary media and re-writes them	on
       tertiary	media.

       Amvault Copies data from	the run	with timestamp src-timestamp onto
       volumes using the changer dst-changer, and labeling new volumes with
       label-template.

   Secondary Media
       The dumps to be read from secondary media can be	specified by any
       combination of dump specifications, --fulls-only, --incrs-only, and
       --src-timestamp.	At least one must be specified,	lest amvault attempt
       to vault	all dumps in the catalog. See amanda-match(7) for more
       information on dump specifications.

       Note that the datestamp given in	the dumpspec is	the dump datestamp -
       the run in which	the backup was taken on	the Amanda client. The
       --src-timestamp,	on the other hand, is the write	timestamp - the	run in
       which the dump was written to secondary media. The latter option
       facilitates duplicating the results of an entire	backup run, including
       any dumps that might have been flushed from holding disk.

   Tertiary Media
       The --dst-changer must be specified, and	names the changer in which
       tertiary	media are stored.

       If amanda.conf(5) contains the new part-size splitting parameters, then
       amvault will use	them without any additional configuration. However, if
       the configuration still uses the	old splitting parameters
       (tape_splitsize,	split_diskbuffer, and fallback_splitsize), then
       amvault will need some additional configuration in order	to properly
       split dumps to tertiary media. To do so,	specify	a new tapetype in
       amanda.conf(5), say "TERTIARY", and set the part-size and other
       appropriate parameters there. Then reference that tapetype in the
       amvault invocation:

	   amvault -otapetype=TERTIARY ...

OPTIONS
       --autolabel [any] [other-config]	[non-amanda] [volume-error] [empty]
	   Works just like the autolabel parameter in amanda.conf(5), and can
	   be specified	multiple times if necessary. The default is 'empty'.

       --dst-changer dst-changer
	   Specifies the changer in which tertiary media are stored. In
	   general, this should	be different from the secondary	changer, to
	   eliminate the possibility of	overwriting secondary media with
	   tertiary data.

	   The dst-changer parameter should specify the	name of	a changer
	   defined in amanda.conf(5). For example:

	   define changer vaulting_tape	{
	       tapedev "/dev/rmt/1n"
	       tpchanger "chg-zd-mtx"
	       changerdev "/dev/sg0"
	       changerfile "vaulting-changer.conf"
	   }

       --dry-run, -n
	   Cause amvault to print the dumps it would vault, but	not actually
	   perform any vaulting	operations.

       --exact-match
	   The host and	disk are parsed	as exact values

       --export
	   Cause amvault to attempt to move completed tertiary volumes to
	   import/export slots,	where they can be more easily removed by an
	   operator.

       --fulls-only
	   Only	full (level-0) dumps are copied.

       --incrs-only
	   Only	incremental (level > 0)	dumps are copied.

       --label-template	label-template
	   Specifies a label template which is used to generate	new labels for
	   tertiary volumes.

       --latest-fulls
	   The latest full of every DLE	in the disklist	that do	not have the
	   skipstrategy.

       --no-interactivity
	   Disable interactivity if a source volume is not found.

       --quiet,	-q
	   Eliminate non-error messages, and is	useful when running amvault
	   from	cron.

       --src-labelstr labelstr
	   Vault from volume with label	matching this labelstr.

       --src-timestamps	src-timestamps
	   Specifies the timestamps in the format 'YYYYMMDDHHMMSS' of the run
	   to vault, can be "latest", then the most recent amdump or amflush
	   run will be used.

       -o configoption
	   See the "CONFIGURATION OVERRIDE" section in amanda(8).

EXAMPLES
       Vault all dump written to tape in the latest amdump or amflush run:
       $ amvault --src-timestamps latest --label-template "CONF-%%%" --dst-changer vault-changer CONF

       Vault all dump written on the run of December 7 2011 12:13:14 :
       $ amvault --src-timestamps 20111207121314 --label-template "CONF-%%%" --dst-changer vault-changer CONF

       Vault all dump dumped on	any run	of December 7 2011:
       $ amvault --label-template "CONF-%%%" --dst-changer vault-changer CONF \* \* 20111207

SEE ALSO
       amanda(8), amanda-changers(7), amfetchdump(8)

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

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

Amanda 3.3.9			  02/09/2016			    AMVAULT(8)

NAME | SYNOPSIS | WARNING | DESCRIPTION | OPTIONS | EXAMPLES | SEE ALSO | AUTHOR

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

home | help