Splitting Configuration Parameters and Behavior: Difference between revisions

From wiki.zmanda.com
Jump to navigation Jump to search
(results for all current cases)
 
(reorg)
Line 1: Line 1:
This table describes the configuration parameters that affect splitting (<tt>tape_splitsize</tt>, <tt>split_diskbuffer</tt>, and <tt>fallback_splitsize</tt>), the relevant conditions for a particular dump, and the results.  See the key, below, for more information
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


= Configuration Parameter Table =
= 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 <tt>split_diskbuffer</tt>
;inval: in invalid value for <tt>split_diskbuffer</tt> (nonexistent, or less than <tt>tape_splitsize</tt> bytes available)
 
==results==
;888 or 999: part size from the corresponding parameter
;10M: default <tt>fallback_splitsize</tt> 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 =
<table border='1'>
<table border='1'>
<tr><th rowspan='2'>condition</th><th colspan='3'>configuration</th><th colspan='2'>result</th></tr>
<tr><th rowspan='2'>condition</th><th colspan='3'>configuration</th><th colspan='2'>result</th></tr>
Line 8: Line 22:
         <td>-</td><td>?</td><td>?</td><td>∞</td><td>none</td></tr>
         <td>-</td><td>?</td><td>?</td><td>∞</td><td>none</td></tr>
<tr><td>0</td><td>?</td><td>?</td><td>∞</td><td>none</td></tr>
<tr><td>0</td><td>?</td><td>?</td><td>∞</td><td>none</td></tr>
<tr><td>999</td><td>?</td><td>?</td><td>tp</td><td>none</td></tr>
<tr><td>999</td><td>?</td><td>?</td><td>10M</td><td>none</td></tr>
<tr><td rowspan='9'>PORT_WRITE<br/>datapath Amanda</td>
<tr><td rowspan='9'>PORT_WRITE<br/>no LEOM</td>
         <td>-</td><td>?</td><td>?</td><td>∞</td><td>none</td></tr>
         <td>-</td><td>?</td><td>?</td><td>∞</td><td>none</td></tr>
<tr><td>0</td><td>?</td><td>?</td><td>∞</td><td>none</td></tr>
<tr><td>0</td><td>?</td><td>?</td><td>∞</td><td>none</td></tr>
<tr><td>999</td><td>-</td><td>-</td><td>10M</td><td>memory</td></tr>
<tr><td>999</td><td>-</td><td>-</td><td>10M</td><td>memory</td></tr>
<tr><td>999</td><td>-</td><td>0</td><td>tp</td><td>memory</td></tr>
<tr><td>999</td><td>-</td><td>0</td><td>10M</td><td>memory</td></tr>
<tr><td>999</td><td>-</td><td>999</td><td>fb</td><td>memory</td></tr>
<tr><td>999</td><td>-</td><td>888</td><td>888</td><td>memory</td></tr>
<tr><td>999</td><td>inval</td><td>-</td><td>10M</td><td>memory</td></tr>
<tr><td>999</td><td>inval</td><td>-</td><td>10M</td><td>memory</td></tr>
<tr><td>999</td><td>inval</td><td>0</td><td>tp</td><td>memory</td></tr>
<tr><td>999</td><td>inval</td><td>0</td><td>10M</td><td>memory</td></tr>
<tr><td>999</td><td>inval</td><td>999</td><td>fb</td><td>memory</td></tr>
<tr><td>999</td><td>inval</td><td>888</td><td>888</td><td>memory</td></tr>
<tr><td>999</td><td>/...</td><td>?</td><td>tp</td><td>disk</td></tr>
<tr><td>999</td><td>/...</td><td>?</td><td>999</td><td>disk</td></tr>
<tr><td rowspan='9'>PORT_WRITE<br/>datapath DirectTCP</td>
<tr><td rowspan='9'>PORT_WRITE<br/>LEOM</td>
         <td>-</td><td>?</td><td>?</td><td>∞</td><td>none</td></tr>
         <td>-</td><td>?</td><td>?</td><td>∞</td><td>none</td></tr>
<tr><td>0</td><td>?</td><td>?</td><td>∞</td><td>none</td></tr>
<tr><td>0</td><td>?</td><td>?</td><td>∞</td><td>none</td></tr>
<tr><td>999</td><td>-</td><td>-</td><td>10M</td><td>none</td></tr>
<tr><td>999</td><td>-</td><td>-</td><td>10M</td><td>none</td></tr>
<tr><td>999</td><td>-</td><td>0</td><td>tp</td><td>none</td></tr>
<tr><td>999</td><td>-</td><td>0</td><td>10M</td><td>none</td></tr>
<tr><td>999</td><td>-</td><td>999</td><td>fb</td><td>none</td></tr>
<tr><td>999</td><td>-</td><td>888</td><td>888</td><td>none</td></tr>
<tr><td>999</td><td>inval</td><td>-</td><td>10M</td><td>none</td></tr>
<tr><td>999</td><td>inval</td><td>-</td><td>10M</td><td>none</td></tr>
<tr><td>999</td><td>inval</td><td>0</td><td>tp</td><td>none</td></tr>
<tr><td>999</td><td>inval</td><td>0</td><td>10M</td><td>none</td></tr>
<tr><td>999</td><td>inval</td><td>999</td><td>fb</td><td>none</td></tr>
<tr><td>999</td><td>inval</td><td>888</td><td>888</td><td>none</td></tr>
<tr><td>999</td><td>/...</td><td>?</td><td>tp</td><td>none</td></tr>
<tr><td>999</td><td>/...</td><td>?</td><td>999</td><td>none</td></tr>
</table>
</table>
== Key ==
For parameters:
;?: parameter is ignored
;-: parameter is not given in amanda.conf
;0: parameter has zero value
;999: parameter has nonzero value
;/...: a valid value for <tt>split_diskbuffer</tt>
;inval: in invalid value for <tt>split_diskbuffer</tt> (nonexistent, or less than <tt>tape_splitsize</tt> bytes available)
For results:
;tp: <tt>tape_splitsize</tt> KB parts
;fb: <tt>fallback_splitsize</tt> KB parts
;10M: default <tt>fallback_splitsize</tt> of 10M
;∞: no splitting (DirectTCP devices will still successfully span from volume to volume; others will not)

Revision as of 03:38, 29 June 2010

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

conditionconfigurationresult
tape
splitsize
split
diskbuffer
fallback
splitsize
part sizecaching
FILE_WRITE -??none
0??none
999??10Mnone
PORT_WRITE
no LEOM
-??none
0??none
999--10Mmemory
999-010Mmemory
999-888888memory
999inval-10Mmemory
999inval010Mmemory
999inval888888memory
999/...?999disk
PORT_WRITE
LEOM
-??none
0??none
999--10Mnone
999-010Mnone
999-888888none
999inval-10Mnone
999inval010Mnone
999inval888888none
999/...?999none