Update of /cvsroot/leaf/doc/guide/user-bering-uclibc
In directory sc8-pr-cvs6.sourceforge.net:/tmp/cvs-serv16181

Modified Files:
        book.xml 
Added Files:
        bucu-ntp.xml 
Log Message:
new chapter for openntpd


--- NEW FILE: bucu-ntp.xml ---
<?xml version="1.0" encoding="UTF-8"?>
<chapter id="bucu-ntp">
  <title>Configure a timeserver on LEAF Bering-uClibc</title>

  <section>
    <title>Objective</title>

    <para>This instructions explain, how to make shure, you have the exact
    time (UTC) on your router and to act as a timeserver for the local net. We
    use openntpd, a very small ntp package, to achieve that goals.</para>

    <para>It is assumed, that you have a basic knowledge about how add
    packages, edit and save files with Bering-uClibc.</para>
  </section>

  <section>
    <title>Installing and configuring openntpd</title>

    <para><citation>OpenNTPD is a FREE, easy to use implementation of the
    Network Time Protocol. It provides the ability to sync the local clock to
    remote NTP servers and can act as NTP server itself, redistributing the
    local clock.</citation></para>

    <para>The openntpd package has been provided on the ISO images and
    packages page for quite a while. Beginning with Bering-uClibc v3.1
    openntpd has been added to the floppy images as a feature-enhanced
    replacement for rdate.</para>

    <para>If you do not use a new floppy image, you'll have to add the
    openntpd package to your boot media and add it to the packages list in
    <filename>leaf.cfg</filename>. You can now either reboot and configure
    later, or install the package (apkg -i), configure it and save the
    configuration.</para>

    <para>There are the two configuration files
    <filename>/etc/default/openntpd</filename> and
    <filename>/etc/openntpd/ntpd.conf.</filename></para>

    <para>In the first file the start options of openntpd are defined. The
    default for the Bering-uClibc package is "-s", which sets the time
    immediately at startup if the local clock is off by more than 180 seconds.
    Allows for an unusual large time correction.</para>

    <para>All other start options are documented in the man page for ntpd,
    available for online reading on the openntpd web pages.</para>

    <para>In the second configuration file,
    <filename>/etc/openntpd/ntpd.conf</filename>, you can define the server(s)
    you take the time off and the network (adresses) the ntpd daemon listens
    to (which means: the network (adresses) ntpd acts as server to requests by
    clients asking for the exact time).</para>

    <para>It's a good idea to sync the time with the pool of stratum 2
    timeservers <ulink
    
url="http://twiki.ntp.org/bin/view/Servers/NTPPoolServers";>pool.ntp.org</ulink>.
    This setting is default, and usually there is no need to change
    it.<screen># use a random selection of 8 public stratum 2 servers
# see http://twiki.ntp.org/bin/view/Servers/NTPPoolServers
servers pool.ntp.org</screen></para>

    <para>If you want to serve the exact time you get from pool.ntp.org (or
    whatever time service you haven choosen) to your local network, you have
    to add the ip address of the local interface in the with the keyword
    "listen". <screen># Addresses to listen on (ntpd does not listen by default)
#listen on *
#listen on 127.0.0.1
#listen on ::1
listen 192.168.1.254</screen>You can add more than one interface if you have
    more than one net you want to serve with time.</para>
  </section>

  <section>
    <title>Open your firewall for time services</title>

    <para>openntpd needs open ports for ntp from the firewall to the net, to
    sync your router with the pool of stratum servers on the net, and to allow
    a connection from your LAN clients to your timeserver on the
    router.</para>

    <para>The first one is open by default with recent versions of
    Bering-uClibc, to allow access from the LAN to the firewall/router you
    have to outcomment the according entry in
    <filename>/etc/shorewall/rules.</filename></para>

    <para><screen># timeserver (allow syncing with time servers (default: 
pool.ntp.org))
NTP/ACCEPT         fw       net
# timeserver (allow LAN clients to sync with the time service on this machine) )
# NTP/ACCEPT         loc    fw</screen></para>
  </section>

  <section>
    <title>Further readings</title>

    <para>For more information see:<orderedlist>
        <listitem>
          <para><ulink url="http://www.ntp.org";>ntp.org</ulink> - the home of
          the Network Time Protocol project with an extensive
          documentation.</para>
        </listitem>

        <listitem>
          <para><ulink url="http://www.ntp.org/ntpfaq/NTP-a-faq.htm";>The NTP
          FAQ and HOWTO</ulink> - "A first try on a non-technical Mini-HOWTO
          and FAQ on NTP"</para>
        </listitem>

        <listitem>
          <para><ulink url="http://www.openntpd.org";>openntpd.org</ulink> -
          the home of openntpd with some specific documentation (incl. the man
          page).</para>
        </listitem>
      </orderedlist></para>
  </section>
</chapter>
Index: book.xml
===================================================================
RCS file: /cvsroot/leaf/doc/guide/user-bering-uclibc/book.xml,v
retrieving revision 1.28
retrieving revision 1.29
diff -C2 -d -r1.28 -r1.29
*** book.xml    25 Nov 2006 04:15:34 -0000      1.28
--- book.xml    3 Feb 2007 17:56:49 -0000       1.29
***************
*** 10,13 ****
--- 10,15 ----
    <xi:include href="bucu-ezipupd.xml"
      xmlns:xi="http://www.w3.org/2001/XInclude"; />
+   <xi:include href="bucu-ntp.xml"
+     xmlns:xi="http://www.w3.org/2001/XInclude"; />
    <xi:include href="bucu-ipv6.xml"
      xmlns:xi="http://www.w3.org/2001/XInclude"; />


-------------------------------------------------------------------------
Using Tomcat but need to do more? Need to support web services, security?
Get stuff done quickly with pre-integrated technology to make your job easier.
Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642
_______________________________________________
leaf-cvs-commits mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/leaf-cvs-commits

Reply via email to