doc/html/AdminReference/auarf069.htm

   1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
   2 <HTML><HEAD>
   3 <TITLE>Administration Reference</TITLE>
   4 <!-- Begin Header Records  ========================================== -->
   5 <!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID      -->
   6 <!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30                -->
   7 <META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
   8 <META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
   9 <META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18: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="auarf068.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="auarf070.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_DELHOST" HREF="auarf002.htm#ToC_83">backup delhost</A></H2>
  19 <A NAME="IDX4280"></A>
  20 <A NAME="IDX4281"></A>
  21 <A NAME="IDX4282"></A>
  22 <A NAME="IDX4283"></A>
  23 <A NAME="IDX4284"></A>
  24 <P><STRONG>Purpose</STRONG>
  25 <P>Deletes a Tape Coordinator entry from the Backup Database
  26 <P><STRONG>Synopsis</STRONG>
  27 <PRE><B>backup delhost -tapehost</B> &lt;<VAR>tape&nbsp;machine&nbsp;name</VAR>> [<B>-portoffset</B> &lt;<VAR>TC&nbsp;port&nbsp;offset</VAR>>]
  28                [<B>-localauth</B>]  [<B>-cell</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-help</B>]
  29
  30 <B>backup delh -t</B> &lt;<VAR>tape&nbsp;machine&nbsp;name</VAR>>  [<B>-p</B> &lt;<VAR>TC&nbsp;port&nbsp;offset</VAR>>]
  31             [<B>-l</B>]  [<B>-c</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-h</B>]
  32 </PRE>
  33 <P><STRONG>Description</STRONG>
  34 <P>The <B>backup delhost</B> command deletes the indicated Tape
  35 Coordinator entry from the Backup Database. It is then impossible to
  36 submit backup operations to that Tape Coordinator, even if it is still
  37 running. To keep configuration information consistent, also remove the
  38 corresponding entry from the <B>/usr/afs/backup/tapeconfig</B> file on the
  39 Tape Coordinator machine.
  40 <P>To list the Tape Coordinator machines and port offsets defined in the
  41 Backup Database, issue the <B>backup listhosts</B> command.
  42 <P><STRONG>Options</STRONG>
  43 <DL>
  44 <P><DT><B>-tapehost
  45 </B><DD>Specifies the hostname of the machine housing the Tape Coordinator to
  46 delete.
  47 <P><DT><B>-portoffset
  48 </B><DD>Specifies the port offset number of the Tape Coordinator to delete.
  49 If omitted, it defaults to <B>0</B>. If provided, it is an integer
  50 between <B>0</B> (zero) and <B>58510</B>, and must match the port
  51 offset number assigned to the same combination of Tape Coordinator and tape
  52 device or file in the <B>/usr/afs/backup/tapeconfig</B> file on the Tape
  53 Coordinator machine indicated by the <B>-tapehost</B> argument.
  54 <P><DT><B>-localauth
  55 </B><DD>Constructs a server ticket using a key from the local
  56 <B>/usr/afs/etc/KeyFile</B> file. The <B>backup</B> command
  57 interpreter presents it to the Backup Server, Volume Server and VL Server
  58 during mutual authentication. Do not combine this flag with the
  59 <B>-cell</B> argument. For more details, see the introductory
  60 <B>backup</B> reference page.
  61 <P><DT><B>-cell
  62 </B><DD>Names the cell in which to run the command. Do not combine this
  63 argument with the <B>-localauth</B> flag. For more details, see the
  64 introductory <B>backup</B> reference page.
  65 <P><DT><B>-help
  66 </B><DD>Prints the online help for this command. All other valid options
  67 are ignored.
  68 </DL>
  69 <P><STRONG>Examples</STRONG>
  70 <P>The following command deletes the Backup Database entry for the Tape
  71 Coordinator with port offset 2 on the Tape Coordinator machine
  72 <B>backup3.abc.com</B>:
  73 <PRE>   % <B>backup delhost -tapehost backup3.abc.com -portoffset 2</B>
  74
  75 </PRE>
  76 <P><STRONG>Privilege Required</STRONG>
  77 <P>The issuer must be listed in the <B>/usr/afs/etc/UserList</B> file on
  78 every machine where the Backup Server is running, or must be logged onto a
  79 server machine as the local superuser <B>root</B> if the
  80 <B>-localauth</B> flag is included.
  81 <P><STRONG>Related Information</STRONG>
  82 <P><A HREF="auarf060.htm#HDRBK_INTRO">backup</A>
  83 <P><A HREF="auarf062.htm#HDRBK_ADDHOST">backup addhost</A>
  84 <P><A HREF="auarf081.htm#HDRBK_LISTHOSTS">backup listhosts</A>
  85 <P>
  86 <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="auarf068.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="auarf070.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>
  87 <!-- Begin Footer Records  ========================================== -->
  88 <P><HR><B>
  89 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
  90 </B>
  91 <!-- End Footer Records  ============================================ -->
  92 <A NAME="Bot_Of_Page"></A>
  93 </BODY></HTML>