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

   1
   2                               amlabel
   3 Prev  Chapter 36. The Amanda Manual Pages.  Next
   4
   5 -------------------------------------------------------------------------------
   6
   7 Name
   8
   9 amlabel \14 label an Amanda tape
  10
  11 Synopsis
  12
  13 amlabel [-f ] config label [ slot | slot ] [ -o | configoption ]*
  14
  15 DESCRIPTION
  16
  17 All Amanda tapes must be pre-labeled before they are used. Amanda verifies the
  18 label in amdump and amflush before writing to make sure the proper tape is
  19 loaded.
  20 Amlabel writes an Amanda label on the tape in the device specified by the
  21 amanda.conf file in /usr/local/etc/amanda/config. Label may be any string that
  22 does not contain whitespace and that matches the amanda.conf labelstr regular
  23 expression option. It is up to the system administrator to define a naming
  24 convention.
  25 Amlabel appends the new tape to the tapelist file so it will be used by Amanda
  26 before it reuses any other tapes. When you amlabel multiple tapes, they will be
  27 used in the order you amlabel them.
  28 Amlabel will not write the label if the tape contains an active Amanda tape or
  29 if the label specified is on an active tape. The -f (force) flag bypasses these
  30 verifications.
  31 An optional slot may be specified after the tape label. If a tape changer is in
  32 use, amlabel will label the tape in the specified slot instead of the currently
  33 loaded tape.
  34 See the amanda(8) man page for more details about Amanda.
  35
  36 OPTIONS
  37
  38
  39
  40   -o configoption
  41       See the "CONFIGURATION OVERWRITE" section in amanda(8).
  42
  43
  44 EXAMPLE
  45
  46 Write an Amanda label with the string "DMP000" on the tape loaded in the device
  47 named in the tapedev option in /usr/local/etc/amanda/daily/amanda.conf:
  48
  49   % amlabel daily DMP000
  50
  51 Label the tape in slot 3 of the currently configured tape changer with the
  52 string "DMP003":
  53
  54   % amlabel daily DMP003 slot 3
  55
  56
  57 MESSAGES
  58
  59
  60
  61   label label doesn't match labelstr str
  62       Label label on the command line does not match the labelstr regular
  63       expression str from amanda.conf.
  64
  65   label label already on a tape
  66       Label label is already listed as an active Amanda tape.
  67
  68   no tpchanger specified in path , so slot command invalid
  69       The command line has the slot parameter but the amanda.conf file in path
  70       does not have a tape changer configured.
  71
  72   reading label label, tape is in another amanda configuration
  73       This tape appears to be a valid Amanda tape, but label does not match
  74       labelstr for this configuration so it is probably part of a different
  75       Amanda configuration.
  76
  77   reading label label, tape is active
  78       Tape label appears to already be part of this Amanda configuration and
  79       active, i.e. has valid data on it.
  80
  81   no label found, are you sure tape is non-rewinding?
  82       While checking that the label was written correctly, amlabel got an error
  83       that might be caused by mis-configuring Amanda with a rewinding tape
  84       device name instead of a non-rewinding device name for tape.
  85
  86
  87 AUTHOR
  88
  89 James da Silva, <jds@amanda.org>: Original text
  90 Stefan G. Weichinger, <sgw@amanda.org>, maintainer of the Amanda-documentation:
  91 XML-conversion
  92
  93 SEE ALSO
  94
  95 amanda(8) amdump(8) amflush(8)
  96 -------------------------------------------------------------------------------
  97
  98 Prev        Up   Next
  99 amgetconf  Home  ammt
 100