git.gag.com Git - debian/amanda/blob - man/amanda-taperscan.7

   1 '\" t
   2 .\"     Title: amanda-taperscan
   3 .\"    Author: Dustin J. Mitchell <dustin@zmanda.com>
   4 .\" Generator: DocBook XSL Stylesheets vsnapshot_8273 <http://docbook.sf.net/>
   5 .\"      Date: 06/01/2010
   6 .\"    Manual: Miscellanea
   7 .\"    Source: Amanda 3.1.0
   8 .\"  Language: English
   9 .\"
  10 .TH "AMANDA\-TAPERSCAN" "7" "06/01/2010" "Amanda 3\&.1\&.0" "Miscellanea"
  11 .\" -----------------------------------------------------------------
  12 .\" * set default formatting
  13 .\" -----------------------------------------------------------------
  14 .\" disable hyphenation
  15 .nh
  16 .\" disable justification (adjust text to left margin only)
  17 .ad l
  18 .\" -----------------------------------------------------------------
  19 .\" * MAIN CONTENT STARTS HERE *
  20 .\" -----------------------------------------------------------------
  21 .SH "NAME"
  22 amanda-taperscan \- Amanda Taperscan Algorithms
  23 .SH "DESCRIPTION"
  24 .PP
  25 Amanda uses a
  26 \fItaperscan algorithm\fR
  27 to select volumes on which to store dumps\&. Historically Amanda has provided only one, fairly complex taperscan algorithm, but this algorithm did not suit the needs of all users\&. Now Amanda offers a wide array of algorithms to suit varied needs\&. Adding new algorithms is not difficult\&.
  28 .PP
  29 The taperscan algorithm is specified with the
  30 \fBtaperscan\fR
  31 parameter, which has a default value of
  32 \fBtraditional\fR\&.
  33 .PP
  34 Taperscan algorithms are implemented as perl packages with the prefix
  35 Amanda::Taper::Scan::\&. See the perl documentation for
  36 Amanda::Taper::Scan
  37 for more information\&.
  38 .SH "TAPERSCAN ALGORITHMS"
  39 .PP
  40 In general, these volumes will only select reusable volumes\&. These are volumes which are listed in the
  41 \fBtapelist\fR(5)
  42 with the
  43 \fIreuse\fR
  44 flag, and which are not among the
  45 \fItapecycle\-1\fR
  46 most recent volumes in the list\&. Put another way, reusable volumes do not contain data that must be retained\&. Note that if fewer than
  47 \fItapecycle\-1\fR
  48 volumes have been written then there are no reusable volumes\&. Newly labeled volumes (volumes that have been labeled with
  49 \fBamlabel\fR
  50 but never used) are considered reusable\&.
  51 .PP
  52 Many of these algorithms look for the oldest reusable volume\&. In most cases, this is the best volume to overwrite, as the data it contains is older than that on any other volume\&. If there are no reusable volumes, then there is no oldest reusable volume\&.
  53 .SS "traditional"
  54 .PP
  55 This algorithm duplicates Amanda\'s historical behavior, and it operates in two stages\&.
  56 .PP
  57 First, if there is an oldest reusable volume and if the changer supports "fast" searches, then the algorithm uses the changer to search for that volume\&. Newly labeled volumes are not considered when calculating the oldest reusable volume\&. Consequently, this taperscan algorithm prefers volumes which have been used before to newly\-labeled volumes when a fast\-searchable changer is in use\&.
  58 .PP
  59 Second, if there is no oldest reusable volume, or if that volume is not available in the changer, then the algorithm begins a sequential scan of the changer, starting at the current slot\&. It selects the first suitable volume it finds: a reusable volume (perhaps newly\-labeled) or, if
  60 \fIlabel_new_tapes\fR
  61 is true, a blank volume\&. Even across multiple invocations (when
  62 \fIruntapes > 1\fR), it will not return the same slot twice\&.
  63 .if n \{\
  64 .sp
  65 .\}
  66 .RS 4
  67 .it 1 an-trap
  68 .nr an-no-space-flag 1
  69 .nr an-break-flag 1
  70 .br
  71 .ps +1
  72 \fBNote\fR
  73 .ps -1
  74 .br
  75 This algorithm shows an undue preference for volumes already containing
  76 data, by omitting newly\-labeled volumes from its first stage\&.  Historically,
  77 many Amanda changer scripts were not fast\-searchable (including
  78 \fIchg\-multi\fR, \fIchg\-disk\fR and, if
  79 \fIhavereader=0\fR, \fIchg\-zd\-mtx\fR), and thus
  80 skipped the first stage, allowing new volumes to find their way into the tape
  81 cycle\&.  New changers are almost all fast\-searchable, so both stages of the
  82 algorithm are used and new tapes may be unexpectedly excluded\&.  If this causes
  83 an undesirable change in behavior, consider one of the other taperscan
  84 algorithms\&..sp .5v
  85 .RE
  86 .SH "SEE ALSO"
  87 .PP
  88 \fBamanda\fR(8),
  89 \fBamanda.conf\fR(5),
  90 \fBtapelist\fR(5),
  91 \fBamanda-changers\fR(7)
  92 .PP
  93 The Amanda Wiki:
  94 : http://wiki.zmanda.com/
  95 .SH "AUTHOR"
  96 .PP
  97 \fBDustin J\&. Mitchell\fR <\&dustin@zmanda\&.com\&>
  98 .RS 4
  99 Zmanda, Inc\&. (http://www\&.zmanda\&.com)
 100 .RE