src/WINNT/doc/install/Documentation/en_US/html/CmdRef/auarf062.htm

   1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
   2 <HTML><HEAD>
   3 <TITLE>Administration Reference</TITLE>
   4 <!-- Begin Header Records  ========================================== -->
   5 <!-- /tmp/idwt3190/auarf000.scr converted by idb2h R4.2 (359) ID      -->
   6 <!-- Workbench Version (AIX) on 5 Nov 1999 at 13:58:29                -->
   7 <META HTTP-EQUIV="updated" CONTENT="Fri, 05 Nov 1999 13:58:29">
   8 <META HTTP-EQUIV="review" CONTENT="Sun, 05 Nov 2000 13:58:29">
   9 <META HTTP-EQUIV="expires" CONTENT="Mon, 05 Nov 2001 13:58:29">
  10 </HEAD><BODY>
  11 <!-- (C) IBM Corporation 2000. All Rights Reserved    -->
  12 <BODY bgcolor="ffffff">
  13 <!-- End Header Records  ============================================ -->
  14 <A NAME="Top_Of_Page"></A>
  15 <H1>Administration Reference</H1>
  16 <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="auarf061.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="auarf063.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>
  17 <P>
  18 <H2><A NAME="HDRBK_ADDHOST" HREF="auarf002.htm#ToC_76">backup addhost</A></H2>
  19 <A NAME="IDX4229"></A>
  20 <A NAME="IDX4230"></A>
  21 <A NAME="IDX4231"></A>
  22 <A NAME="IDX4232"></A>
  23 <A NAME="IDX4233"></A>
  24 <A NAME="IDX4234"></A>
  25 <A NAME="IDX4235"></A>
  26 <A NAME="IDX4236"></A>
  27 <A NAME="IDX4237"></A>
  28 <A NAME="IDX4238"></A>
  29 <P><STRONG>Purpose</STRONG>
  30 <P>Adds a Tape Coordinator entry to the Backup Database
  31 <P><STRONG>Synopsis</STRONG>
  32 <PRE><B>backup addhost -tapehost</B> &lt;<VAR>tape&nbsp;machine&nbsp;name</VAR>> [<B>-portoffset</B> &lt;<VAR>TC&nbsp;port&nbsp;offset</VAR>>]
  33                [<B>-localauth</B>]  [<B>-cell</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-help</B>]
  34
  35 <B>backup addh -t</B> &lt;<VAR>tape&nbsp;machine&nbsp;name</VAR>>  [<B>-p</B> &lt;<VAR>TC&nbsp;port&nbsp;offset</VAR>>]
  36             [<B>-l</B>]  [<B>-c</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-h</B>]
  37 </PRE>
  38 <P><STRONG>Description</STRONG>
  39 <P>The <B>backup addhost</B> command creates a Tape Coordinator entry in
  40 the Backup Database. The entry records
  41 <UL>
  42 <P><LI>The host name of the Tape Coordinator machine where the Tape Coordinator
  43 (<B>butc</B>) process runs, as specified with the <B>-tapehost</B>
  44 argument.
  45 <P><LI>The Tape Coordinator&#39;s port offset number, as specified with the
  46 <B>-portoffset</B> argument. An entry for the port offset must also
  47 appear in the <B>/usr/afs/backup/tapeconfig</B> file on the Tape
  48 Coordinator machine, where it is mapped to a UNIX device name (for a tape
  49 device) or pathname (for a backup data file).
  50 </UL>
  51 <P>Each Tape Coordinator must have its own port offset number, and the command
  52 fails if a Backup Database entry already exists for the requested port offset
  53 number. To display existing Tape Coordinator entries, use the
  54 <B>backup listhosts</B> command.
  55 <P><STRONG>Options</STRONG>
  56 <DL>
  57 <P><DT><B>-tapehost
  58 </B><DD>Specifies the fully-qualified hostname of the machine for which to create
  59 a Tape Coordinator entry in the Backup Database. The machine must have
  60 an entry in either the cell&#39;s naming service (such as the Domain Name
  61 Service) or the host file (<B>/etc/hosts</B> or equivalent) on the machine
  62 where the command is issued.
  63 <P><DT><B>-portoffset
  64 </B><DD>Specifies the Tape Coordinator&#39;s port offset number. Provide
  65 an integer from the range <B>0</B> through <B>58510</B>, or omit this
  66 argument to use the default value of <B>0</B> (zero). The value
  67 must match the port offset number recorded for the same combination of Tape
  68 Coordinator and tape device or file in the
  69 <B>/usr/afs/backup/tapeconfig</B> file on the Tape Coordinator machine
  70 named by the <B>-tapehost</B> argument.
  71 <P><DT><B>-localauth
  72 </B><DD>Constructs a server ticket using a key from the local
  73 <B>/usr/afs/etc/KeyFile</B> file. The <B>backup</B> command
  74 interpreter presents it to the Backup Server, Volume Server and VL Server
  75 during mutual authentication. Do not combine this flag with the
  76 <B>-cell</B> argument. For more details, see the introductory
  77 <B>backup</B> reference page.
  78 <P><DT><B>-cell
  79 </B><DD>Names the cell in which to run the command. Do not combine this
  80 argument with the <B>-localauth</B> flag. For more details, see the
  81 introductory <B>backup</B> reference page.
  82 <P><DT><B>-help
  83 </B><DD>Prints the online help for this command. All other valid options
  84 are ignored.
  85 </DL>
  86 <P><STRONG>Examples</STRONG>
  87 <P>The following command creates an entry in the Backup Database that assigns
  88 port offset number 4 to a Tape Coordinator running on the machine
  89 <B>backup1.abc.com</B>&#58;
  90 <PRE>   % <B>backup addhost -tapehost backup1.abc.com -portoffset 4</B>
  91
  92 </PRE>
  93 <P>The following command creates a Backup Database entry that assigns port
  94 offset number 0 to a Tape Coordinator on the machine
  95 <B>backup3.abc.com</B>&#58;
  96 <PRE>   % <B>backup addhost backup3.abc.com</B>
  97
  98 </PRE>
  99 <P><STRONG>Privilege Required</STRONG>
 100 <P>The issuer must be listed in the <B>/usr/afs/etc/UserList</B> file on
 101 every machine where the Backup Server is running, or must be logged onto a
 102 server machine as the local superuser <B>root</B> if the
 103 <B>-localauth</B> flag is included.
 104 <P><STRONG>Related Information</STRONG>
 105 <P><A HREF="auarf060.htm#HDRBK_INTRO">backup</A>
 106 <P><A HREF="auarf069.htm#HDRBK_DELHOST">backup delhost</A>
 107 <P><A HREF="auarf081.htm#HDRBK_LISTHOSTS">backup listhosts</A>
 108 <P>
 109 <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="auarf061.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="auarf063.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>
 110 <!-- Begin Footer Records  ========================================== -->
 111 <P><HR><B>
 112 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 113 </B>
 114 <!-- End Footer Records  ============================================ -->
 115 <A NAME="Bot_Of_Page"></A>
 116 </BODY></HTML>