doc/html/AdminReference/auarf230.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="auarf229.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="auarf231.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="HDRRUNNTP" HREF="auarf002.htm#ToC_244">runntp</A></H2>
  19 <A NAME="IDX5433"></A>
  20 <A NAME="IDX5434"></A>
  21 <A NAME="IDX5435"></A>
  22 <A NAME="IDX5436"></A>
  23 <A NAME="IDX5437"></A>
  24 <A NAME="IDX5438"></A>
  25 <A NAME="IDX5439"></A>
  26 <P><STRONG>Purpose</STRONG>
  27 <P>Initializes the Network Time Protocol Daemon
  28 <P><STRONG>Synopsis</STRONG>
  29 <PRE><B>runntp</B> [<B>-localclock</B>] [<B>-precision</B> &lt;<VAR>small&nbsp;negative&nbsp;integer</VAR>>]
  30        [<B>-logfile</B> &lt;<VAR>filename&nbsp;for&nbsp;ntpd's&nbsp;stdout/stderr</VAR>>]
  31        [<B>-ntpdpath</B> &lt;<VAR>pathname&nbsp;of&nbsp;ntpd&nbsp;executable&nbsp;(/usr/afs/bin/ntpd)</VAR>>]
  32        [&lt;<VAR>host</VAR>><SUP>+</SUP>] [<B>-help</B>]
  33 </PRE>
  34 <P>This command does not use the syntax conventions of the AFS command
  35 suites. Provide the command name and all option names in full.
  36 <P><STRONG>Description</STRONG>
  37 <P>The <B>runntp</B> command initializes the Network Time Protocol Daemon
  38 (NTPD) and related programs on the local machine and constructs an
  39 <B>ntp.conf</B> configuration file. The intended use is on
  40 AFS file server machines as a convenient interface to the standard
  41 <B>ntpd</B> program.
  42 <P>In the conventional configuration, the binary file for the command is
  43 located in the <B>/usr/afs/bin</B> directory on a file server
  44 machine. The command is not normally issued at the command shell
  45 prompt, but rather placed into a file server machine's
  46 <B>/usr/afs/local/BosConfig</B> file with the <B>bos create</B>
  47 command. If it is ever issued at the command shell prompt, the issuer
  48 must be logged onto a server machine as the local superuser
  49 <B>root</B>.
  50 <P><STRONG>Cautions</STRONG>
  51 <P>Do not run the <B>runntp</B> program if NTPD or another time protocol
  52 is already in use in the cell. Running two time-synchronization
  53 protocols can cause errors.
  54 <P><STRONG>Options</STRONG>
  55 <DL>
  56 <P><DT><B>-localclock
  57 </B><DD>Designates the local machine's internal clock as a possible time
  58 source if a network partition separates the machine from the other source
  59 machines listed on the command line. In cells that are not connected to
  60 an exterior network or are behind a firewall, include this flag on every
  61 machine that runs the <B>runntp</B> process. In cells that
  62 frequently lose access to exterior networks (voluntarily or not), include it
  63 only on the <B>runntp</B> process running on the system control
  64 machine. Do not include the flag if the cell is reliably connected to
  65 exterior networks.
  66 <P><DT><B>-precision
  67 </B><DD>Specifies the precision of the local clock. This argument is not
  68 normally provided. As the <B>ntpd</B> process initializes, it
  69 determines the precision of the local clock on its own. If provided, it
  70 is a small integer preceded by a hyphen to show that it is negative.
  71 The value is used as an exponent on the number 2, and the result interpreted
  72 as the frequency, in fractions of a second, at which the local clock ticks
  73 (advances).
  74 <P>For example, a value of <B>-6</B>, which translates to
  75 <B>2<SUP>-6</SUP></B> or 1/64, means that the local clock ticks once every
  76 1/64th of a second, or has a precision of about 60 ticks per second. A
  77 value of <B>-7</B> translates to about 100 ticks per second. A
  78 value of <B>-10</B> translates to about 1000 ticks per second (a
  79 millisecond clock).
  80 <P><DT><B>-logfile
  81 </B><DD>Specifies the local disk pathname for the NTP daemon's log file, such
  82 as <B>/usr/afs/logs/ntp.log</B>. The log records which
  83 machines are serving as time sources and peers, what adjustments have been
  84 made to reduce drift, and so on. Use the <B>ntpd</B> process's
  85 debugging mechanism to control the amount of information produced. If
  86 this argument is omitted, the information is discarded.
  87 <P><DT><B>-ntpdpath
  88 </B><DD>Specifies the local disk pathname of the binary for the <B>ntpd</B>
  89 program. If this argument is omitted, the default is
  90 <B>/usr/afs/bin/ntpd</B>.
  91 <P><DT><B><VAR>host</VAR>
  92 </B><DD>Is the fully qualified hostname of each machine to consult as a time
  93 source. By convention, the machines are outside the cell if exterior
  94 networks are accessible.
  95 <P>In general, this argument is necessary only on the system control
  96 machine. If the issuer omits it, then the local machine consults the
  97 local database server machines listed in its copy of the
  98 <B>/usr/afs/etc/CellServDB</B> file.
  99 <P>For advice on selecting appropriate time sources, see the <I>IBM AFS
 100 Quick Beginnings</I> or ask AFS Product Support.
 101 <P><DT><B>-help
 102 </B><DD>Prints the online help for this command. All other valid options
 103 are ignored.
 104 </DL>
 105 <P><STRONG>Privilege Required</STRONG>
 106 <P>The issuer must be logged in as the superuser <B>root</B> on a file
 107 server machine to issue the command at a command shell prompt. It is
 108 conventional instead to create and start the process by issuing the <B>bos
 109 create</B> command.
 110 <P><STRONG>Related Information</STRONG>
 111 <P><A HREF="auarf098.htm#HDRBOS_CREATE">bos create</A>
 112 <P>UNIX manual page for <B>ntp</B>
 113 <P>UNIX manual page for <B>ntpd</B>
 114 <P>UNIX manual page for <B>ntpdc</B>
 115 <P>
 116 <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="auarf229.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="auarf231.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>
 117 <!-- Begin Footer Records  ========================================== -->
 118 <P><HR><B>
 119 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 120 </B>
 121 <!-- End Footer Records  ============================================ -->
 122 <A NAME="Bot_Of_Page"></A>
 123 </BODY></HTML>