source: server/other/leafnode/leafnode-config.xml@ 786d85c

<sect2>
<title>Configuring leafnode</title>

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

<para>leafnode may be configured to use inetd by adding a leafnode 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>Alternatively, leafnode may be configured to use xinetd by 
adding a leafnode 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"
        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
        }
EOF</command></userinput></screen>

<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><command>server = </command></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, 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>