amtape

AMTAPE(8)                System Administration Commands                AMTAPE(8)



NAME
       amtape - Control Amanda changers

SYNOPSIS
       amtape [-o configoption...] config subcommand [subcommand_options...]

DESCRIPTION
       Amtape is the command-line interface to Amanda's tape changers (amanda-
       changers(7)) and to the taperscan algorithm (amanda-taperscan(7)).

       Tape changers maintain a notion of the current slot for each
       configuration. This may or may not correspond to an actual physical state
       of the device, but is used by some taperscan algorithms to minimize
       searching through the slots.

       Amtape uses the default changer. To use a different changer, use the
       config override option, e.g., -otpchanger=otherchanger.

SUBCOMMANDS
       label label
           Search for and load the Amanda tape with label [label], also setting
           the current slot.

       slot slot
           Load the volume in the given slot, also setting the current slot. The
           slot names current, next, first, and last have special meaning.

       current
           Shorthand for slot current.

       inventory
           Show the contents of all slots, based on the changer's cached
           metadata. This is a quick operation as it does not load or unload any
           volumes, but is not supported by all changers.

       show [slots]
           Show the contents of all slots (or listed slots) by loading each slot
           and reading its label. This can be very slow. The slots arguments is
           of the form 1,3-5,7.

       reset
           Reset the changer to a known state. This subcommand is intended to
           clear any unknown and potentially incorrect state the changer may
           have stored.

       eject [drive]
           Eject the tape currently in the drive. This only applies to some
           changers. Specify a drive (by drive number) if more than one drive is
           available.

       clean [drive]
           If a cleaning tape is defined for the changer, used it to clean the
           specified drive. The [drive] is optional if the changer only has one
           drive.

       taper
           Run the taperscan algorithm (see amanda-taperscan(7)), displaying
           information about the progress of the scan.

       update [what]
           Update changer state. Consult amanda-changers(7) for changer-specific
           details on the format of what.

       -o configoption
           See the "CONFIGURATION OVERRIDE" section in amanda(8).

SEE ALSO
       amanda(8), amanda-changers(7), amanda-taperscan(7), amanda-devices(7)

       The Amanda Wiki: : http://wiki.zmanda.com/

AUTHORS
       Dustin J. Mitchell <dustin@zmanda.com>
           Zmanda, Inc. (http://www.zmanda.com)

       James da Silva <jds@amanda.org>

       Stefan G. Weichinger <sgw@amanda.org>



Amanda 3.3.1                       02/21/2012                          AMTAPE(8)