+++ /dev/null
-<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
-<HTML><HEAD>
-<TITLE>Administration Reference</TITLE>
-<!-- Begin Header Records ========================================== -->
-<!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID -->
-<!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30 -->
-<META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
-<META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
-<META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18:29">
-</HEAD><BODY>
-<!-- (C) IBM Corporation 2000. All Rights Reserved -->
-<BODY bgcolor="ffffff">
-<!-- End Header Records ============================================ -->
-<A NAME="Top_Of_Page"></A>
-<H1>Administration Reference</H1>
-<HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf125.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Bot_Of_Page"><IMG SRC="../bot.gif" BORDER="0" ALT="[Bottom of Topic]"></A> <A HREF="auarf127.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
-<P>
-<H2><A NAME="HDRBUTC" HREF="auarf002.htm#ToC_140">butc</A></H2>
-<A NAME="IDX4691"></A>
-<A NAME="IDX4692"></A>
-<A NAME="IDX4693"></A>
-<A NAME="IDX4694"></A>
-<A NAME="IDX4695"></A>
-<A NAME="IDX4696"></A>
-<P><STRONG>Purpose</STRONG>
-<P>Initializes the Tape Coordinator process
-<P><STRONG>Synopsis</STRONG>
-<PRE><B>butc</B> [<B>-port</B> <<VAR>port offset</VAR>>] [<B>-debuglevel</B> < <B>0</B> | <B>1</B> | <B>2</B> >]
- [<B>-cell</B> <<VAR>cell name</VAR>>] [<B>-noautoquery</B>]
- [<B>-localauth</B>] [<B>-help</B>]
-
-<B>butc</B> [<B>-p</B> <<VAR>port offset</VAR>>] [<B>-d</B> < <B>0</B> | <B>1</B> | <B>2</B> >]
- [<B>-c</B> <<VAR>cell name</VAR>>] [<B>-n</B>] [<B>-l</B>] [<B>-h</B>]
-</PRE>
-<P><STRONG>Description</STRONG>
-<P>The <B>butc</B> command initializes a Tape Coordinator process on a
-Tape Coordinator machine, enabling an operator to direct Backup System
-requests to the associated tape device or backup data file. (The Tape
-Coordinator controls a backup data file if the <B>FILE YES</B> instruction
-appears in the <B>/usr/afs/backup/CFG_</B><VAR>device_name</VAR> file that
-corresponds to the Tape Coordinator's entry in the
-<B>/usr/afs/backup/tapeconfig</B> file. For the sake of simplicity,
-the following discusses tape devices only.)
-<P>It is conventional to start and run the Tape Coordinator in the
-foreground. In this case, it runs on its own connection, which is
-unavailable for any other use and must remain open the entire time the Tape
-Coordinator is to accept backup requests and while it is executing
-them. (When using a window manager, the connection corresponds to a
-separate command shell window.) The Tape Coordinator can run in the
-background if the <B>CFG_</B><VAR>device_name</VAR> file is configured to
-eliminate any need for the Tape Coordinator to prompt the operator. In
-both the foreground and background, the Tape Coordinator writes operation
-traces and other output to the standard output stream on the connection over
-which it was started. Use the <B>-debuglevel</B> argument to
-control the amount of information that appears. The Tape Coordinator
-also writes traces and error messages to two files in the local
-<B>/usr/afs/backup</B> directory:
-<UL>
-<P><LI>The <B>TE_</B><VAR>device_name</VAR> file records problems that the Tape
-Coordinator encounters as it executes backup operations.
-<P><LI>The <B>TL_</B><VAR>device_name</VAR> file records a trace of operations
-as well as the same errors written to the <B>TE_</B><VAR>device_name</VAR>
-file.
-</UL>
-<P>The Tape Coordinator creates the files automatically as it
-initializes. If there are existing files, the Tape Coordinator renames
-them with a <B>.old</B> extension, overwriting the existing
-<B>.old</B> files if they exist. It derives the
-<VAR>device_name</VAR> part of the file names by stripping off the device
-name's <B>/dev/</B> prefix and replacing any other slashes with
-underscores. For example, the files are called <B>TE_rmt_4m</B> and
-<B>TL_rmt_4m</B> for a device called <B>/dev/rmt/4m</B>.
-<P>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
-<<B>Return</B>>. To suppress this prompt, include the
-<B>-noautoquery</B> flag on the command line or the instruction
-<B>AUTOQUERY NO</B> in the
-<B>/usr/afs/backup/CFG_</B><VAR>device_name</VAR> file. When the
-prompt is suppressed, the first required tape must be in the drive before a
-<B>backup</B> command is issued. For subsequent tapes, the Tape
-Coordinator uses its normal tape acquisition routine: if the
-<B>/usr/afs/backup/CFG_</B><VAR>device_name</VAR> file includes a
-<B>MOUNT</B> instruction, the Tape Coordinator invokes the indicated
-command; otherwise, it prompts the operator for the next tape.
-<P>To stop the Tape Coordinator process, enter an interrupt signal such as
-<<B>Ctrl-c</B>> over the dedicated connection (in the command shell
-window).
-<P>To cancel a <B>backup</B> operation that involves a tape before it
-begins (assuming the initial tape prompt has not been suppressed), enter the
-letter <B>a</B> (for <B>abort</B>) and press <<B>Return</B>> at
-the Tape Coordinator's prompt for the first tape.
-<P>Tape Coordinator operation depends on the correct configuration of certain
-files, as described in the following list:
-<UL>
-<P><LI>The local <B>/usr/afs/backup/tapeconfig</B> file must include an entry
-for the Tape Coordinator that specifies its device name and port offset
-number, among other information; for details, see the
-<B>tapeconfig</B> reference page.
-<P><LI>The port offset number recorded in the Tape Coordinator's entry in
-the Backup Database must match the one in the <B>tapeconfig</B>
-file. Create the Backup Database entry by using the <B>backup
-addhost</B> command.
-<P><LI>The optional <B>/usr/afs/backup/CFG_</B><VAR>device_name</VAR> 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 <VAR>device_name</VAR> part of the name is
-derived as described previously for the <B>TE_</B><VAR>device_name</VAR> and
-<B>TL_</B><VAR>device_name</VAR> files.
-</UL>
-<P><STRONG>Cautions</STRONG>
-<P>If the Tape Coordinator machine is an AIX machine, use the <B>SMIT</B>
-utility to set the device's 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 <I>IBM AFS Administration Guide</I> chapter
-about configuring the Backup System.
-<P><STRONG>Options</STRONG>
-<DL>
-<P><DT><B>-port
-</B><DD>Specifies the port offset number of the Tape Coordinator to
-initialize.
-<P><DT><B>-debuglevel
-</B><DD>Controls the amount and type of messages the Tape Coordinator displays on
-the standard output stream. Provide one of three acceptable
-values:
-<UL>
-<P><LI><B>0</B> 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.
-<P><LI><B>1</B> to display the names of the volumes being dumped or restored
-as well as the information displayed at level 0.
-<P><LI><B>2</B> to display all messages also being written to the
-<B>TL_</B><VAR>device_name</VAR> log file.
-</UL>
-<P><DT><B>-cell
-</B><DD>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 <B>/usr/vice/etc/ThisCell</B> file. Do not combine this
-flag with the <B>-localauth</B> argument.
-<P><DT><B>-noautoquery
-</B><DD>Suppresses the Tape Coordinator's prompt for insertion of the first
-tape needed for an operation. The operator must insert the tape into
-the drive before issuing the <B>backup</B> command that initializes the
-operation.
-<P><DT><B>-localauth
-</B><DD>Constructs a server ticket using the server encryption key with the
-highest key version number in the local
-<B>/usr/afs/etc/KeyFile</B>. The <B>butc</B> command
-interpreter presents the ticket, which never expires, to the Volume Server and
-Volume Location Server to use in mutual authentication.
-<P>Do not combine this argument with the <B>-cell</B> flag, and use it
-only when logged on to a server machine as the local superuser
-<B>root</B>; client machines do not have
-<B>/usr/afs/etc/KeyFile</B> file.
-<P><DT><B>-help
-</B><DD>Prints the online help for this command. All other valid options
-are ignored.
-</DL>
-<P><STRONG>Examples</STRONG>
-<P>The following command starts the Tape Coordinator with port offset
-<B>7</B> at debug level <B>1</B>, meaning the Tape Coordinator reports
-the names of volumes it is dumping or restoring.
-<PRE> % <B>butc -port 7 -debuglevel 1</B>
-
-</PRE>
-<P><STRONG>Privilege Required</STRONG>
-<P>The issuer must be listed in the <B>/usr/afs/etc/UserList</B> 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 <B>-localauth</B> flag is included, the issuer must
-instead be logged on to the Tape Coordinator machine as the local superuser
-<B>root.</B> In addition, the issuer must be able to read and write
-to the log and configuration files in the local <B>/usr/afs/backup</B>
-directory.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf018.htm#HDRCFG">CFG_<I>device_name</I></A>
-<P><A HREF="auarf023.htm#HDRKEYFILE">KeyFile</A>
-<P><A HREF="auarf031.htm#HDRTE">TE_<I>device_name</I></A>
-<P><A HREF="auarf032.htm#HDRCLI_THISCELL">ThisCell (client version)</A>
-<P><A HREF="auarf034.htm#HDRTL">TL_<I>device_name</I></A>
-<P><A HREF="auarf035.htm#HDRUSERLIST">UserList</A>
-<P><A HREF="auarf050.htm#HDRTAPECONFIG">tapeconfig</A>
-<P><A HREF="auarf062.htm#HDRBK_ADDHOST">backup addhost</A>
-<P>
-<HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf125.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Top_Of_Page"><IMG SRC="../top.gif" BORDER="0" ALT="[Top of Topic]"></A> <A HREF="auarf127.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
-<!-- Begin Footer Records ========================================== -->
-<P><HR><B>
-<br>© <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A> All Rights Reserved
-</B>
-<!-- End Footer Records ============================================ -->
-<A NAME="Bot_Of_Page"></A>
-</BODY></HTML>
git://git.openafs.org / openafs.git / blobdiff