source: server/other/leafnode/leafnode-config.xml@ 65df9fca

<sect2>
<title>Configuring <application>Leafnode</application></title>

<sect3><title>Config files</title>
<para><filename>/etc/news/config</filename>,
<filename>/etc/inetd.conf</filename> or
<filename>/etc/xinetd.conf</filename></para>

<para><application>Leafnode</application> may be configured to use
<command>inetd</command> by adding an entry
to the <filename>/etc/inetd.conf</filename> file with the following
command:</para>

<screen><userinput><command>echo "nntp stream tcp nowait news /usr/sbin/tcpd /usr/sbin/leafnode" \
&gt;&gt; /etc/inetd.conf</command></userinput></screen>

<para>Issue a <command>killall -HUP inetd</command> to reread the
changed <filename>inetd.conf</filename> file.</para>

<para>Alternatively, <application>Leafnode</application> may be configured to 
use <command>xinetd</command> by adding an entry to the <filename>
/etc/xinetd.conf</filename> file with the following command:</para>

<screen><userinput><command>cat &gt;&gt; /etc/xinetd.conf &lt;&lt; "EOF" </command>
        service nntp
        {
           flags           = NAMEINARGS NOLIBWRAP
           socket_type     = stream
           protocol        = tcp
           wait            = no
           user            = news
           server          = /usr/sbin/tcpd
           server_args     = /usr/sbin/leafnode
           instances       = 7
           per_source      = 3
        }
<command>EOF</command></userinput></screen>

<para>Issue a <command>killall -HUP xinetd</command> to reread the
changed <filename>xinetd.conf</filename> file.</para>

<para>The <filename>/etc/news/config</filename> file must be
edited to reflect the name of the upstream <acronym>NNTP</acronym>
provider. Copy the
example configuration file to <filename>/etc/news/config</filename>
and save the original for reference: </para>

<screen><userinput><command>cp /etc/news/config.example /etc/news/config
</command></userinput></screen>

<para>Change the
<screen><userinput>server = </userinput></screen>
entry to reflect your news provider.</para>

<para>The <envar>NNTPSERVER</envar> environment variable must be set to 
127.0.0.1 to prevent news clients from reading news from the upstream feed, 
so add the following to <filename>/etc/profile</filename> or
<filename>$HOME/.bash_profile</filename>:</para>

<screen><userinput><command>export NNTPSERVER=127.0.0.1</command></userinput></screen>

</sect3>

</sect2>