Splitting Configuration Parameters and Behavior: Difference between revisions
Jump to navigation
Jump to search
(results for all current cases) |
(→Old (dumptype) Configuration Parameters: note about LEOM in 3.1) |
||
(3 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
This table describes the configuration parameters that affect splitting | 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 | = 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> | <tr><td>999</td><td>?</td><td>?</td><td>999</td><td>none</td></tr> | ||
<tr><td rowspan='9'>PORT_WRITE<br/> | <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> | <tr><td>999</td><td>-</td><td>0</td><td>10M</td><td>memory</td></tr> | ||
<tr><td>999</td><td>-</td><td> | <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> | <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> | <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> | <tr><td>999</td><td>/...</td><td>?</td><td>999</td><td>disk</td></tr> | ||
<tr><td rowspan='9'>PORT_WRITE<br/> | <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> | <tr><td>999</td><td>-</td><td>0</td><td>10M*</td><td>none</td></tr> | ||
<tr><td>999</td><td>-</td><td> | <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> | <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> | <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> | <tr><td>999</td><td>/...</td><td>?</td><td>999</td><td>none</td></tr> | ||
</table> | </table> | ||
<sup>*</sup>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 <tt>allow_split</tt> is true, the default) | |||
<table border='1'> | |||
<tr><th rowspan='2'>condition</th><th colspan='4'>configuration</th><th colspan='2'>result</th></tr> | |||
<tr><th>part_size</th><th>part_cache_type</th><th>part_cache_dir</th><th>part_cache_max_size</th><th>part size</th><th>caching</th></tr> | |||
<tr><td rowspan='3'>FILE_WRITE</td> | |||
<td>-</td><td>?</td><td>?</td><td>?</td><td>∞</td><td>none</td></tr> | |||
<tr><td>0</td><td>?</td><td>?</td><td>?</td><td>∞</td><td>none</td></tr> | |||
<tr><td>999</td><td>?</td><td>?</td><td>?</td><td>999</td><td>none</td></tr> | |||
<tr><td rowspan='10'>PORT_WRITE<br/>no LEOM</td> | |||
<td>-</td><td>?</td><td>?</td><td>?</td><td>∞</td><td>none</td></tr> | |||
<tr><td>0</td><td>?</td><td>?</td><td>?</td><td>∞</td><td>none</td></tr> | |||
<tr><td>999</td><td>-</td><td>?</td><td>?</td><td>999</td><td>none</td></tr> | |||
<tr><td>999</td><td>none</td><td>?</td><td>?</td><td>999</td><td>none</td></tr> | |||
<tr><td>999</td><td>memory</td><td>?</td><td>-</td><td>999</td><td>memory</td></tr> | |||
<tr><td>999</td><td>memory</td><td>?</td><td>888</td><td>888</td><td>memory</td></tr> | |||
<tr><td>999</td><td>disk</td><td>-</td><td>?</td><td>999</td><td>none (warning)</td></tr> | |||
<tr><td>999</td><td>disk</td><td>inval</td><td>?</td><td>999</td><td>none (warning)</td></tr> | |||
<tr><td>999</td><td>disk</td><td>/...</td><td>-</td><td>999</td><td>disk</td></tr> | |||
<tr><td>999</td><td>disk</td><td>/...</td><td>888</td><td>888</td><td>disk</td></tr> | |||
<tr><td rowspan='3'>PORT_WRITE<br />LEOM</td> | |||
<td>-</td><td>?</td><td>?</td><td>?</td><td>∞</td><td>none</td></tr> | |||
<tr><td>0</td><td>?</td><td>?</td><td>?</td><td>∞</td><td>none</td></tr> | |||
<tr><td>999</td><td>?</td><td>?</td><td>?</td><td>999</td><td>none</td></tr> | |||
</table> |
Latest revision as of 05:25, 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
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 |