1AMTAPE(8)               System Administration Commands               AMTAPE(8)
2
3
4

NAME

6       amtape - Control Amanda changers
7

SYNOPSIS

9       amtape [-o configoption...] config subcommand [subcommand_options...]
10

DESCRIPTION

12       Amtape is the command-line interface to Amanda's tape changers (amanda-
13       changers(7)) and to the taperscan algorithm (amanda-taperscan(7)).
14
15       Tape changers maintain a notion of the current slot for each
16       configuration. This may or may not correspond to an actual physical
17       state of the device, but is used by some taperscan algorithms to
18       minimize searching through the slots.
19
20       Amtape uses the default changer. To use a different changer, use the
21       config override option, e.g., -otpchanger=otherchanger.
22

SUBCOMMANDS

24       create
25           Call the changer create method, it create the vtape root dirtectory
26           or the s3 bucket.
27
28       label label
29           Search for and load the Amanda tape with label [label], also
30           setting the current slot.
31
32       slot slot [drive drive]
33           Load the volume in the given slot, also setting the current slot.
34           The slot names current, next, first, and last have special meaning.
35
36       current
37           Shorthand for slot current.
38
39       inventory
40           Show the contents of all slots, based on the changer's cached
41           metadata. This is a quick operation as it does not load or unload
42           any volumes, but is not supported by all changers.
43
44       show [slots]
45           Show the contents of all slots (or listed slots) by loading each
46           slot and reading its label. This can be very slow. The slots
47           arguments is of the form 1,3-5,7.
48
49       reset
50           Reset the changer to a known state. This subcommand is intended to
51           clear any unknown and potentially incorrect state the changer may
52           have stored.
53
54       eject [drive]
55           Eject the tape currently in the drive. This only applies to some
56           changers. Specify a drive (by drive number) if more than one drive
57           is available.
58
59       clean [drive]
60           If a cleaning tape is defined for the changer, used it to clean the
61           specified drive. The [drive] is optional if the changer only has
62           one drive.
63
64       sync-catalog
65           sync the catalog with a device that support it,
66
67       taper
68           Run the taperscan algorithm (see amanda-taperscan(7)), displaying
69           information about the progress of the scan.
70
71       update [what]
72           Update changer state. Consult amanda-changers(7) for
73           changer-specific details on the format of what.
74
75       verify
76           Verify the changer is correctly configured. Can be useful for
77           chg-robot and chg-ndmp.
78
79       -o configoption
80           See the "CONFIGURATION OVERRIDE" section in amanda(8).
81

SEE ALSO

83       amanda(8), amanda-changers(7), amanda-taperscan(7), amanda-devices(7)
84
85       The Amanda Wiki: : http://wiki.zmanda.com/
86

AUTHORS

88       Dustin J. Mitchell <dustin@zmanda.com>
89           Zmanda, Inc. (http://www.zmanda.com)
90
91       James da Silva <jds@amanda.org>
92
93       Stefan G. Weichinger <sgw@amanda.org>
94
95
96
97Amanda 3.5.4                      07/27/2023                         AMTAPE(8)
Impressum