1AMANDA-TAPERSCAN(7)               Miscellanea              AMANDA-TAPERSCAN(7)
2
3
4

NAME

6       amanda-taperscan - Amanda Taperscan Algorithms
7

DESCRIPTION

9       Amanda uses a taperscan algorithm to select volumes on which to store
10       dumps. Historically Amanda has provided only one, fairly complex
11       taperscan algorithm, but this algorithm did not suit the needs of all
12       users. Now Amanda offers a wide array of algorithms to suit varied
13       needs. Adding new algorithms is not difficult.
14
15       The taperscan algorithm is specified with the taperscan parameter,
16       which has a default value of traditional.
17
18       Taperscan algorithms are implemented as perl packages with the prefix
19       Amanda::Taper::Scan::. See the perl documentation for
20       Amanda::Taper::Scan for more information.
21

DEFINING A TAPERSCAN

23       An taperscan is defined in amanda.conf(5) as follows:
24
25       define taperscan $taperscan_name {
26          comment "$comment"
27          plugin "$pluginname"
28          property "$PROPERTY_NAME" "$PROPERTY_VALUE"
29          ...
30       }
31       and then referenced in the global section as
32
33         taperscan "$taperscan_name"
34
35       Taperscan properties, like Amanda configuration parameters, are
36       insensitive to case, and - (dash) and _ (underscore) may be used
37       interchangeably.
38
39       See the individual plugin documentation below for properties applicable
40       to each plugin.
41

TAPERSCAN ALGORITHMS

43       In general, these algorithms will only select reusable volumes. These
44       are volumes which are listed in the tapelist(5) with the reuse flag,
45       and which are not among the tapecycle-1 most recent volumes in the
46       list. Put another way, reusable volumes do not contain data that must
47       be retained. Note that if fewer than tapecycle-1 volumes have been
48       written then there are no reusable volumes. Newly labeled volumes
49       (volumes that have been labeled with amlabel but never used) are
50       considered reusable.
51
52       Many of these algorithms look for the oldest reusable volume. In most
53       cases, this is the best volume to overwrite, as the data it contains is
54       older than that on any other volume. If there are no reusable volumes,
55       then there is no oldest reusable volume.
56
57   traditional
58       This algorithm duplicates Amanda's historical behavior, and it operates
59       in two stages.
60
61       First, if there is an oldest reusable volume and if the changer
62       supports "fast" searches, then the algorithm uses the changer to search
63       for that volume. Newly labeled volumes are not considered when
64       calculating the oldest reusable volume. Consequently, this taperscan
65       algorithm prefers volumes which have been used before to newly-labeled
66       volumes when a fast-searchable changer is in use.
67
68       Second, if there is no oldest reusable volume, or if that volume is not
69       available in the changer, then the algorithm begins a sequential scan
70       of the changer, starting at the current slot. It selects the first
71       suitable volume it finds: a reusable volume (perhaps newly-labeled) or,
72       if autolabel includes empty, a blank volume. Even across multiple
73       invoc