backup labeltape - Creates the magnetic label on a tape

backup labeltape << [-name <AFS tape name, defaults to NULL] >>> << [-size <tape size in Kbytes, defaults to size in tapeconfig] >>> << [-portoffset <TC port offset] >>> << [-pname <permanent tape name] >>> [-localauth] << [-cell <cell name] >>> [-help]

backup la << [-n <AFS tape name, defaults to NULL] >>> << [-s <tape size in Kbytes, defaults to size in tapeconfig] >>> << [-po <TC port offset] >>> << [-pn <permanent tape name] >>> [-l] << [-c <cell name] >>> [-h]

The backup labeltape command creates a magnetic label, readable by the Backup System, at the beginning of a tape. The label records the tape's name (either a permanent name, or an AFS tape name that reflects the tape's contents in a prescribed format) and its capacity.

(If the CWFILE YES instruction appears in the /var/lib/openafs/backup/CFG_device_name file on the Tape Coordinator machine associated with the specified port offset, then the backup command writes label information to the first 16 KB block in the backup data file listed for that port offset in the Tape Coordinator's /var/lib/openafs/backup/tapeconfig file, rather than at the beginning of a tape. For the sake of clarity, the following text refers to tapes only, but the Backup System handles backup data files in much the same way.)

Relabeling a tape that already contains AFS backup data effectively makes the data unusable, because the command removes the Backup Database record of the complete dump set of which the tape is a part. Use this command to enable recycling of a tape that contains unexpired dumps that are not actually still needed.

To write a permanent name on the label, include the -pname argument to specify a string of up to 32 characters. The permanent name persists until the -pname argument is again included on the backup labeltape command, regardless of the tape's contents and of how often the tape is otherwise relabeled or recycled. Include this argument or the -name argument, but not both. If this argument is included, the AFS tape name is set to CW< <NULL >>. The permanent name is set to CW< <NULL >> if this argument is omitted and no permanent name already exists.

The issuer must ensure that a permanent name is unique among the tapes used for AFS backup in the cell, because the backup command interpreter does not verify that another tape does not already have the same permanent name. When a tape has a permanent name, the Backup System uses it instead of the AFS tape name in most prompts and when referring to the tape in output from backup commands. The permanent name appears in the CWtape name field of the output from the backup readlabel command.

To write an AFS tape name on the label, provide a value for the -name argument in the required format described in the OPTIONS manpage. Include the -name argument or the -pname argument, but not both. If this argument is omitted, the AFS tape name is set to CW< <NULL >>, but the Backup System automatically assigns the appropriate name when the tape is used in a future backup dump or backup savedb operation. The AFS tape name appears in the CWAFS tape name field of the output from the backup readlabel and backup scantape commands.

The backup command interpreter does not accept the -name argument if the tape already has a permanent name. To erase a tape's permanent name, provide a null value to the -pname argument by issuing the following command:

   % backup labeltape -pname ""

To determine how much data can be written to a tape during a backup dump or backup savedb operation, the Tape Coordinator reads the capacity recorded on the tape's label (or uses the value associated with its port offset in the /var/lib/openafs/backup/tapeconfig file, if the tape was never labeled). For further description, see the backup dump reference page.

The Tape Coordinator's default response to this command is to access the tape by invoking the CWMOUNT instruction in the local /var/lib/openafs/backup/CFG_device_name file, or by prompting the backup operator to insert the tape if there is no CWMOUNT instruction. However, if the CWAUTOQUERY NO instruction appears in the CFG_device_name file, or if the issuer of the butc command included the -noautoquery flag, the Tape Coordinator instead expects the tape to be in the device already. If it is not, the Tape Coordinator invokes the CWMOUNT instruction or prompts the operator.

Specifies the AFS tape name to record on the label. Include this argument or the -pname argument, but not both. If this argument is omitted, the AFS tape name is set to CW< <NULL >>. If this argument is provided, it must have the following format:

   <volume_set_name>.<dump_level_name>.<tape_index>

   Ubik_db_dump.<tape_index>

The following command records the AFS tape name CWuser.monthly.1 on the label of the tape in the device with port offset 3:

   % backup labeltape -name user.monthly.1 -portoffset 3

   % backup labeltape -size 2g -portoffset 4
   % backup labeltape -size 2048M -portoffset 4
   % backup labeltape -size 2097152 -portoffset 4

The issuer must be listed in the /etc/openafs/server/UserList file on every machine where the Backup Server is running, or must be logged onto a server machine as the local superuser CWroot if the -localauth flag is included.

the butc(5) manpage, the backup(8) manpage, the backup_readlabel(8) manpage, the butc(8) manpage

IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.

This documentation is covered by the IBM Public License Version 1.0. It was converted from HTML to POD by software written by Chas Williams and Russ Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.