src/WINNT/doc/install/Documentation/en_US/html/CmdRef/auarf105.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="auarf104.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="auarf106.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="HDRBOS_INSTALL" HREF="auarf002.htm#ToC_119">bos install</A></H2>
  19 <A NAME="IDX4548"></A>
  20 <A NAME="IDX4549"></A>
  21 <A NAME="IDX4550"></A>
  22 <A NAME="IDX4551"></A>
  23 <A NAME="IDX4552"></A>
  24 <A NAME="IDX4553"></A>
  25 <A NAME="IDX4554"></A>
  26 <A NAME="IDX4555"></A>
  27 <P><STRONG>Purpose</STRONG>
  28 <P>Installs a new version of a binary file
  29 <P><STRONG>Synopsis</STRONG>
  30 <PRE><B>bos install -server</B> &lt;<VAR>machine&nbsp;name</VAR>>  <B>-file</B> &lt;<VAR>files to install</VAR>><SUP>+</SUP>
  31             [<B>-dir</B> &lt;<VAR>destination dir</VAR>>]  [<B>-cell</B> &lt;<VAR>cell&nbsp;name</VAR>>]
  32             [<B>-noauth</B>]  [<B>-localauth</B>]  [<B>-help</B>]
  33
  34 <B>bos i -s</B> &lt;<VAR>machine&nbsp;name</VAR>>  <B>-f</B> &lt;<VAR>files to install</VAR>><SUP>+</SUP>
  35       [<B>-d</B> &lt;<VAR>destination dir</VAR>>]  [<B>-c</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-n</B>]  [<B>-l</B>]  [<B>-h</B>]
  36 </PRE>
  37 <P><STRONG>Description</STRONG>
  38 <P>The <B>bos install</B> command copies each binary file specified with
  39 the <B>-file</B> argument to the local disk of the server machine named by
  40 the <B>-server</B> argument, which is normally the binary distribution
  41 machine for its CPU/operating system type. The destination directory is
  42 <B>/usr/afs/bin</B> unless the <B>-dir</B> argument indicates an
  43 alternate directory. The source file&#39;s UNIX mode bits are
  44 preserved in the transfer.
  45 <P>If there is already a file of the same name in the destination directory,
  46 the BOS Server automatically saves it by adding a <TT>.BAK</TT>
  47 extension. If there is a current <TT>.BAK</TT> version at
  48 least seven days old, it replaces the current <TT>.OLD</TT>
  49 version. If there is no current <TT>.OLD</TT> version, the
  50 current <TT>.BAK</TT> version becomes the <TT>.OLD</TT>
  51 version automatically. The <B>bos getdate</B> command displays the
  52 timestamps on the current versions of the file.
  53 <P>To start using the new binary immediately, issue the <B>bos restart</B>
  54 command. Otherwise, the BOS Server automatically restarts the process
  55 at the time defined in the <B>/usr/afs/local/BosConfig</B> file; use
  56 the <B>bos getrestart</B> command to display the time and the <B>bos
  57 setrestart</B> time to set it.
  58 <P><STRONG>Options</STRONG>
  59 <DL>
  60 <P><DT><B><B>-server</B>
  61 </B><DD>Indicates the binary distribution machine on which to install the new
  62 binaries. Identify the machine by IP address or its host name (either
  63 fully-qualified or abbreviated unambiguously). For details, see the
  64 introductory reference page for the <B>bos</B> command suite.
  65 <P>If the machine is not a binary distribution machine and is running an
  66 <B>upclientbin</B> process, then the files are overwritten the next time
  67 the <B>upclientbin</B> process fetches the corresponding file from the
  68 distribution machine (by default within five minutes).
  69 <P><DT><B><B>-file</B>
  70 </B><DD>Specifies the complete pathname of each binary file to copy into the
  71 destination directory. Each source directory can be on the local disk
  72 or in AFS, in which case the issuer of the <B>bos install</B> command must
  73 have the necessary AFS access rights and the local machine must run the Cache
  74 Manager. For the BOS Server to create <TT>.BAK</TT> and
  75 <TT>.OLD</TT> versions, the last element in the pathname (the
  76 filename) must match the name of a file in the destination directory.
  77 The reference page for the <B>bos create</B> command lists the standard
  78 binary file names.
  79 <P><DT><B><B>-dir</B>
  80 </B><DD>Provides the complete pathname of the local disk directory in which to
  81 install binary files. It is necessary only if the destination directory
  82 is not <B>/usr/afs/bin</B>.
  83 <P><DT><B><B>-cell</B>
  84 </B><DD>Names the cell in which to run the command. Do not combine this
  85 argument with the <B>-localauth</B> flag. For more details, see the
  86 introductory <B>bos</B> reference page.
  87 <P><DT><B><B>-noauth</B>
  88 </B><DD>Assigns the unprivileged identity <B>anonymous</B> to the
  89 issuer. Do not combine this flag with the <B>-localauth</B>
  90 flag. For more details, see the introductory <B>bos</B> reference
  91 page.
  92 <P><DT><B><B>-localauth</B>
  93 </B><DD>Constructs a server ticket using a key from the local
  94 <B>/usr/afs/etc/KeyFile</B> file. The <B>bos</B> command
  95 interpreter presents the ticket to the BOS Server during mutual
  96 authentication. Do not combine this flag with the <B>-cell</B> or
  97 <B>-noauth</B> options. For more details, see the introductory
  98 <B>bos</B> reference page.
  99 <P><DT><B>-help
 100 </B><DD>Prints the online help for this command. All other valid options
 101 are ignored.
 102 </DL>
 103 <P><STRONG>Examples</STRONG>
 104 <P>The following command copies the file
 105 <B>/afs/abc.com/rs_aix42/usr/afs/bin/vlserver</B> to the file
 106 <B>/usr/afs/bin/vlserver</B> on the machine
 107 <B>fs3.abc.com</B>, which is the binary distribution machine
 108 for server machines running AIX 4.2 in the <B>abc.com</B>
 109 cell. The current version of the <B>/usr/afs/bin/vlserver</B> file
 110 is moved to <B>/usr/afs/bin/vlserver.BAK</B>.
 111 <PRE>   % <B>bos install -server fs3.abc.com </B>   \
 112                  <B>-file /afs/abc.com/rs_aix42/usr/afs/bin/vlserver</B>
 113
 114 </PRE>
 115 <P><STRONG>Privilege Required</STRONG>
 116 <P>The issuer must be listed in the <B>/usr/afs/etc/UserList</B> file on
 117 the machine named by the <B>-server</B> argument, or must be logged onto a
 118 server machine as the local superuser <B>root</B> if the
 119 <B>-localauth</B> flag is included.
 120 <P><STRONG>Related Information</STRONG>
 121 <P><A HREF="auarf016.htm#HDRBOSCONFIG">BosConfig</A>
 122 <P><A HREF="auarf023.htm#HDRKEYFILE">KeyFile</A>
 123 <P><A HREF="auarf035.htm#HDRUSERLIST">UserList</A>
 124 <P><A HREF="auarf093.htm#HDRBOS_INTRO">bos</A>
 125 <P><A HREF="auarf101.htm#HDRBOS_GETDATE">bos getdate</A>
 126 <P><A HREF="auarf103.htm#HDRBOS_GETRESTART">bos getrestart</A>
 127 <P><A HREF="auarf113.htm#HDRBOS_RESTART">bos restart</A>
 128 <P><A HREF="auarf117.htm#HDRBOS_SETRESTART">bos setrestart</A>
 129 <P>
 130 <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="auarf104.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="auarf106.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>
 131 <!-- Begin Footer Records  ========================================== -->
 132 <P><HR><B>
 133 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 134 </B>
 135 <!-- End Footer Records  ============================================ -->
 136 <A NAME="Bot_Of_Page"></A>
 137 </BODY></HTML>