|o||The TE_device_name file records problems that the Tape Coordinator encounters as it executes backup operations.|
|o||The TL_device_name file records a trace of operations as well as the same errors written to the TE_device_name file.|
By default, at the beginning of each operation the Tape Coordinator prompts for the operator to insert the first tape into the drive and press Return. To suppress this prompt, include the -noautoquery flag on the command line or the instruction AUTOQUERY NO in the /var/openafs/backup/CFG_device_name file. When the prompt is suppressed, the first required tape must be in the drive before a backup command is issued. For subsequent tapes, the Tape Coordinator uses its normal tape acquisition routine: if the /var/openafs/backup/CFG_device_name file includes a MOUNT instruction, the Tape Coordinator invokes the indicated command; otherwise, it prompts the operator for the next tape.
To stop the Tape Coordinator process, enter an interrupt signal such as Ctrl-C over the dedicated connection (in the command shell window).
To cancel a backup operation that involves a tape before it begins (assuming the initial tape prompt has not been suppressed), enter the letter a (for abort) and press Return at the Tape Coordinators prompt for the first tape.
Tape Coordinator operation depends on the correct configuration of certain files, as described in the following list:
|o||The local /var/openafs/backup/tapeconfig file must include an entry for the Tape Coordinator that specifies its device name and port offset number, among other information; for details, tapeconfig(5).|
|o||The port offset number recorded in the Tape Coordinators entry in the Backup Database must match the one in the tapeconfig file. Create the Backup Database entry by using the backup addhost command.|
|o||The optional /var/openafs/backup/CFG_device_name file can contain instructions for mounting and unmounting tapes automatically (when using a tape stacker or jukebox, for instance) or automating other aspects of the backup process. The device_name part of the name is derived as described previously for the TE_device_name and TL_device_name files.|
If the Tape Coordinator machine is an AIX machine, use the SMIT utility to set the devices block size to 0 (zero), indicating variable block size. Otherwise, tape devices attached to machines running other operating systems sometimes cannot read tapes written on AIX machines. For instructions, see the OpenAFS Administration Guide chapter about configuring the Backup System.
-port <port offset> Specifies the port offset number of the Tape Coordinator to initialize. -debuglevel Controls the amount and type of messages the Tape Coordinator displays on the standard output stream. Provide one of three acceptable values:
o 0 to display the minimum level of detail required to describe Tape Coordinator operations, including prompts for tapes, messages that indicate the beginning and end of operations, and error messages. This is the default value. o 1 to display the names of the volumes being dumped or restored as well as the information displayed at level 0. o 2 to display all messages also being written to the TL_device_name log file. -cell <cell name> Names the cell in which the Tape Coordinator operates (the cell to which the file server machines that house affected volumes belong). If this argument is omitted, the Tape Coordinator runs in the local cell as defined in the local /usr/local/etc/openafs/ThisCell file. Do not combine this flag with the -localauth argument. -noautoquery Suppresses the Tape Coordinators prompt for insertion of the first tape needed for an operation. The operator must insert the tape into the drive before issuing the backup command that initializes the operation. -localauth Constructs a server ticket using the server encryption key with the highest key version number in the local /usr/local/etc/openafs/server/KeyFile. The butc command interpreter presents the ticket, which never expires, to the Volume Server and Volume Location Server to use in mutual authentication.
Do not combine this argument with the -cell flag, and use it only when logged on to a server machine as the local superuser root; client machines do not have /usr/local/etc/openafs/server/KeyFile file.
-help Prints the online help for this command. All other valid options are ignored.
The following command starts the Tape Coordinator with port offset 7 at debug level 1, meaning the Tape Coordinator reports the names of volumes it is dumping or restoring.
% butc -port 7 -debuglevel 1
The issuer must be listed in the /usr/local/etc/openafs/server/UserList file on every machine where the Backup Server or Volume Location (VL) Server is running, and on every file server machine that houses a volume to be backed up. If the -localauth flag is included, the issuer must instead be logged on to the Tape Coordinator machine as the local superuser root. In addition, the issuer must be able to read and write to the log and configuration files in the local /var/openafs/backup directory.
KeyFile(5), ThisCell(5), UserList(5), butc(5), butc_logs(5), tapeconfig(5), backup_addhost(8)
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.