amlabel - label an Amanda tape


SYNOPSIS

       amlabel [-f] config label [ slot slot ]


DESCRIPTION

       All Amanda tapes must be pre-labeled before they are used.
       Amanda verifies the label in  amdump  and  amflush  before
       writing to make sure the proper tape is loaded.

       Amlabel  writes  an Amanda label on the tape in the device
       specified by the amanda.conf file  in  /etc/amanda/config.
       Label  may  be any string that does not contain whitespace
       and that matches the amanda.conf labelstr regular  expres­
       sion  option.   It  is  up  to the system administrator to
       define a naming convention.

       Amlabel appends the new tape to the tapelist  file  so  it
       will  be  used by Amanda before it reuses any other tapes.
       When you amlabel multiple tapes, they will be used in  the
       order you amlabel them.

       Amlabel  will  not write the label if the tape contains an
       active Amanda tape or if the  label  specified  is  on  an
       active tape.  The -f (force) flag bypasses these verifica­
       tions.

       An optional slot may be specified after  the  tape  label.
       If  a  tape changer is in use, amlabel will label the tape
       in the specified slot  instead  of  the  currently  loaded
       tape.

       See  the amanda(8) man page for more details about Amanda.


EXAMPLE

       Write an Amanda label with the string "DMP000" on the tape
       loaded  in  the  device  named  in  the  tapedev option in
       /etc/amanda/DailySet1/amanda.conf:

              % amlabel DailySet1 DMP000

       Label the tape in slot 3 of the currently configured  tape
       changer with the string "DMP003":

              % amlabel DailySet1 DMP003 slot 3


MESSAGES

       label label doesn't match labelstr "str"
              Label  label on the command line does not match the
              labelstr regular expression str from amanda.conf.

       label label already on a tape
              Label label is already listed as an  active  Amanda


       no tpchanger specified in "path", so slot command invalid
              The  command  line  has  the slot parameter but the
              amanda.conf file in  path  does  not  have  a  tape
              changer configured.

       reading label label, tape is in another amanda configura­
              tion
              This tape appears to be a valid  Amanda  tape,  but
              label  does  not match labelstr for this configura­
              tion so it is probably part of a  different  Amanda
              configuration.

       reading label label, tape is active
              Tape  label  appears  to  already  be  part of this
              Amanda configuration and  active,  i.e.  has  valid
              data on it.

       no label found, are you sure tape is non-rewinding?
              While  checking  that  the  label  was written cor­
              rectly, amlabel got an error that might  be  caused
              by  mis-configuring  Amanda  with  a rewinding tape
              device name instead of a non-rewinding device  name
              for tape.


AUTHOR

       James da Silva <jds@cs.umd.edu>
       University of Maryland, College Park


SEE ALSO

       amanda(8) amdump(8) amflush(8)


Man(1) output converted with man2html