git.gag.com Git - debian/amanda/blob - docs/amtape.8.txt

   1
   2                                amtape
   3 Prev  Chapter 35. The AMANDA Manual Pages.  Next
   4
   5 -------------------------------------------------------------------------------
   6
   7 Name
   8
   9 amtape \14 user interface to AMANDA tape changer controls
  10
  11 Synopsis
  12
  13 amtape config command [ command options ]
  14
  15 DESCRIPTION
  16
  17 Amtape performs tape changer control operations. It uses the underlying tape
  18 changer script defined by the tpchanger option for a particular AMANDA
  19 configuration as specified by the config argument.
  20 Tape changers maintain a notion of the current and next slot for each
  21 configuration. These may or may not correspond to an actual physical state of
  22 the device, but do tend to minimize searching through the tape storage slots.
  23 If the desired tape is in the current slot, it is likely the next tape needed
  24 is in the next slot rather than at some random position in the storage slots.
  25 See the amanda(8) man page for more details about AMANDA.
  26
  27 COMMANDS
  28
  29
  30
  31   reset
  32       Reset the tape changer to a known state. The current slot is set to the
  33       first slot. Other device-specific side effects may occur. Some gravity
  34       stackers need to be reset to the top position by hand. This command
  35       notifies AMANDA the stacker is back in that position.
  36
  37   eject
  38       If a tape is loaded in the drive, it is ejected and returned to the slot
  39       from which it was loaded.
  40
  41   clean
  42       If a cleaning tape is defined for the changer, it is used to clean the
  43       drive.
  44
  45   show
  46       Show the contents of all slots. This can be slow.
  47
  48   label label
  49       Search for and load the AMANDA tape with label label.
  50
  51   taper
  52       Perform the taper scan algorithm. Load the next tape in the
  53       configuration's tape sequence, or a fresh tape with a suitable label.
  54
  55   device
  56       Display the name of the current tape device on stdout.
  57
  58   current
  59       Display the current slot.
  60
  61   update
  62       Update the changer label database, if it has one, to match the tapes now
  63       available.
  64
  65   slot slot
  66       Eject any tape in the drive and put it away, then load the tape from slot
  67       slot and reset current.
  68
  69   slot current
  70       Eject any tape in the drive and put it away, then load the tape from the
  71       current slot.
  72
  73   slot prev
  74       Eject any tape in the drive and put it away, then load the tape from the
  75       previous slot and reset current.
  76
  77   slot next
  78       Eject any tape in the drive and put it away, then load the tape from the
  79       next slot and reset current.
  80
  81   slot first
  82       Eject any tape in the drive and put it away, then load the tape from the
  83       first slot and reset current.
  84
  85   slot last
  86       Eject any tape in the drive and put it away, then load the tape from the
  87       last slot and reset current.
  88
  89   slot advance
  90       Eject any tape in the drive and put it away. Advance current to the next
  91       tape, but do not load it.
  92
  93 This is useful with non-gravity stackers to unload the last tape used and set
  94 up AMANDA for the next run. If you just use eject, the current tape will be
  95 mounted again in the next run, where it will be rejected as being still in use,
  96 ejected and the next tape requested. Using slot next followed by eject does an
  97 unnecessary mount.
  98 Note: most changers optimize the slot commands to not eject the loaded tape if
  99 it is the one being requested.
 100
 101 AUTHOR
 102
 103 James da Silva, <jds@amanda.org> : Original text
 104 Stefan G. Weichinger, <sgw@amanda.org>, maintainer of the AMANDA-documentation:
 105 XML-conversion
 106
 107 SEE ALSO
 108
 109 amanda(8)
 110 -------------------------------------------------------------------------------
 111
 112 Prev       Up         Next
 113 amstatus  Home  amtapetype
 114