Splitting Configuration Parameters and Behavior

This table describes the configuration parameters that affect splitting, the relevant conditions for a particular dump, and the results. It does so both for the old parameters and the new. Notes that the new parameters are only used if none of the old parameters appear in the dumptype. See the key, below, for more information

Key

parameters

?

parameter is ignored

-

parameter is not given in amanda.conf

0

parameter has zero value

888 or 999

parameter has nonzero value

/...

a valid value for split_diskbuffer

inval

in invalid value for split_diskbuffer (nonexistent, or less than tape_splitsize bytes available)

results

888 or 999

part size from the corresponding parameter

10M

default fallback_splitsize of 10M

∞

no splitting (LEOM devices will still successfully span from volume to volume; others will fail if they hit EOM)

Old (dumptype) Configuration Parameters

condition	configuration			result
	tape splitsize	split diskbuffer	fallback splitsize	part size	caching
FILE_WRITE	-	?	?	∞	none
	0	?	?	∞	none
	999	?	?	999	none
PORT_WRITE no LEOM	-	?	?	∞	none
	0	?	?	∞	none
	999	-	-	10M	memory
	999	-	0	10M	memory
	999	-	888	888	memory
	999	inval	-	10M	memory
	999	inval	0	10M	memory
	999	inval	888	888	memory
	999	/...	?	999	disk
PORT_WRITE LEOM	-	?	?	∞	none
	0	?	?	∞	none
	999	-	-	10M*	none
	999	-	0	10M*	none
	999	-	888	888*	none
	999	inval	-	10M*	none
	999	inval	0	10M*	none
	999	inval	888	888*	none
	999	/...	?	999	none

^*These part sizes will all be 999 in Amanda-3.2. The only LEOM sitation in Amanda 3.1 was with the NDMP device in a DirectTCP transaction, and the small part sizes are not desired in this case.

New (tapetype) Configuration Parameters

(this assumes that the dumptype parameter allow_split is true, the default)

condition	configuration				result
	part_size	part_cache_type	part_cache_dir	part_cache_max_size	part size	caching
FILE_WRITE	-	?	?	?	∞	none
	0	?	?	?	∞	none
	999	?	?	?	999	none
PORT_WRITE no LEOM	-	?	?	?	∞	none
	0	?	?	?	∞	none
	999	-	?	?	999	none
	999	none	?	?	999	none
	999	memory	?	-	999	memory
	999	memory	?	888	888	memory
	999	disk	-	?	999	none (warning)
	999	disk	inval	?	999	none (warning)
	999	disk	/...	-	999	disk
	999	disk	/...	888	888	disk
PORT_WRITE LEOM	-	?	?	?	∞	none
	0	?	?	?	∞	none
	999	?	?	?	999	none