source: server/other/leafnode.xml@ 1f672c1

10.0 10.1 11.0 6.1 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 1f672c1 was 1f672c1, checked in by Bruce Dubbs <bdubbs@…>, 17 years ago

Update to xinetd configuration files from patch by John Gnew

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@3614 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 9.6 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
3 "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7<!ENTITY leafnode-download-http "http://prdownloads.sourceforge.net/leafnode/leafnode-&leafnode-version;.rel.tar.bz2">
8<!ENTITY leafnode-download-ftp "ftp://ftp.gwdg.de/pub/linux/mirrors/sunsite/system/news/transport/leafnode-&leafnode-version;.rel.tar.bz2">
9<!ENTITY leafnode-md5sum "1d8d27673780ba49fcb69883c2cabdec">
10<!ENTITY leafnode-size "385 KB">
11<!ENTITY leafnode-buildsize "6.3 MB">
12<!ENTITY leafnode-time "0.10 SBU">
13]>
14
15<sect1 id="leafnode" xreflabel="Leafnode-&leafnode-version;">
16<sect1info>
17<othername>$LastChangedBy$</othername>
18<date>$Date$</date>
19</sect1info>
20<?dbhtml filename="leafnode.html"?>
21<title>Leafnode-&leafnode-version;</title>
22<indexterm zone="leafnode">
23<primary sortas="a-Leafnode">Leafnode</primary></indexterm>
24
25<sect2>
26<title>Introduction to <application>Leafnode</application></title>
27
28<para><application>Leafnode</application> is an <acronym>NNTP</acronym>
29server designed for small sites to provide a local USENET spool.</para>
30
31<sect3><title>Package information</title>
32<itemizedlist spacing='compact'>
33<listitem><para>Download (HTTP):
34<ulink url="&leafnode-download-http;"/></para></listitem>
35<listitem><para>Download (FTP):
36<ulink url="&leafnode-download-ftp;"/></para></listitem>
37<listitem><para>Download MD5 sum: &leafnode-md5sum;</para></listitem>
38<listitem><para>Download size: &leafnode-size;</para></listitem>
39<listitem><para>Estimated disk space required:
40&leafnode-buildsize;</para></listitem>
41<listitem><para>Estimated build time:
42&leafnode-time;</para></listitem></itemizedlist>
43</sect3>
44
45<sect3><title><application>Leafnode</application> dependencies</title>
46<sect4><title>Required</title>
47<para><xref linkend="pcre"/> and <xref linkend="tcpwrappers"/></para>
48</sect4>
49
50<sect4><title>Recommended</title>
51<para><xref linkend="xinetd"/> and <xref linkend="fcron"/></para>
52</sect4>
53</sect3>
54
55</sect2>
56
57<sect2>
58<title>Installation of <application>Leafnode</application></title>
59
60<para>Create the group and user news, if not present:</para>
61
62<screen><userinput><command>groupadd news &amp;&amp;
63useradd -c "Leafnode News Server" -d /var/spool/news -g news news</command></userinput></screen>
64
65<para>Install <application>Leafnode</application> by running the following
66commands:</para>
67
68<screen><userinput><command>./configure --prefix=/usr \
69 --localstatedir=/var --sysconfdir=/etc/leafnode \
70 --with-lockfile=/var/lock/leafnode/fetchnews.lck &amp;&amp;
71make</command></userinput></screen>
72
73<para>Now, as the root user:</para>
74
75<screen><userinput role='root'><command>make install</command></userinput></screen>
76
77</sect2>
78
79<sect2>
80<title>Installation command explanations</title>
81
82<para><parameter>--localstatedir=/var</parameter>: Change the default
83spool directory of <filename class="directory">/usr/var</filename>.</para>
84
85<para><parameter>--sysconfdir=/etc/leafnode</parameter>:
86<application>Leafnode</application> reads its configuration data from a file
87called <filename>config</filename> which will be created in
88<filename class="directory">/etc/leafnode</filename> to
89avoid any potential conflict with other packages.</para>
90
91<para><command>make update</command>: Run this command if you are upgrading
92from a very old version of <application>Leafnode</application>.</para>
93
94</sect2>
95
96<sect2>
97<title>Configuring <application>Leafnode</application></title>
98
99<sect3 id="leafnode-config"><title>Config files</title>
100<para><filename>/etc/leafnode/config</filename>,
101<filename>/etc/nntpserver</filename>,
102<filename>/etc/xinetd.conf</filename> or
103<filename>/etc/inetd.conf</filename> and
104<filename>/etc/sysconfig/createfiles</filename></para>
105<indexterm zone="leafnode leafnode-config">
106<primary sortas="e-etc-leafnode-config">/etc/leafnode/config</primary>
107</indexterm>
108<indexterm zone="leafnode leafnode-config">
109<primary sortas="e-etc-nntpserver">/etc/nntpserver</primary></indexterm>
110<indexterm zone="leafnode leafnode-config">
111<primary sortas="e-etc-xinetd.conf">/etc/xinetd.conf</primary></indexterm>
112<indexterm zone="leafnode leafnode-config">
113<primary sortas="e-etc-inetd.conf">/etc/inetd.conf</primary></indexterm>
114<indexterm zone="leafnode leafnode-config"><primary
115sortas="e-etc-sysconfig-createfiles">/etc/sysconfig/createfiles</primary>
116</indexterm>
117</sect3>
118
119<sect3><title>Configuration commands</title>
120
121<para>The <filename>/etc/leafnode/config</filename> file must be
122edited to reflect the name of the upstream <acronym>NNTP</acronym>
123provider. Copy the example configuration file to
124<filename>/etc/leafnode/config</filename> and save the original for
125reference:</para>
126
127<screen><userinput><command>cp /etc/leafnode/config.example /etc/leafnode/config</command></userinput></screen>
128
129<para>Change the
130<screen><userinput>server = </userinput></screen>
131entry to reflect your news provider.</para>
132
133<para>The <filename>/etc/nntpserver</filename> file must contain 127.0.0.1 to
134prevent news clients from reading news from the upstream feed. Create this
135file using the following command:</para>
136
137<screen><userinput><command>cat &gt; /etc/nntpserver &lt;&lt; "EOF"</command>
138127.0.0.1
139
140<command>EOF</command></userinput></screen>
141
142<para>The <command>/etc/rc.d/init.d/cleanfs</command> script, part of the
143<acronym>LFS</acronym> bootscript package, will remove the
144<filename class="directory">/var/lock/leafnode</filename> directory during
145the system boot sequence. Install the following line in the
146<filename>/etc/sysconfig/createfiles</filename> file to re-create the
147directory:</para>
148
149<screen><userinput>/var/lock/leafnode dir 2775 news news</userinput></screen>
150
151<para><application>Leafnode</application> may be configured to use
152<command>inetd</command> by adding an entry to the
153<filename>/etc/inetd.conf</filename> file with the following
154command:</para>
155
156<screen><userinput><command>echo "nntp stream tcp nowait news /usr/sbin/tcpd /usr/sbin/leafnode" \
157&gt;&gt; /etc/inetd.conf</command></userinput></screen>
158
159<para>Issue a <command>killall -HUP inetd</command> to reread the
160changed <filename>inetd.conf</filename> file.</para>
161
162<para>If you use <command>xinetd</command>, the following command will create the
163<application>Leafnode</application> file as <filename>/etc/xinetd.d/nntp</filename>:</para>
164
165<screen><userinput><command>cat &gt;&gt; /etc/xinetd.d/nntp &lt;&lt; "EOF"</command>
166# Begin /etc/xinetd.d/nntp
167
168 service nntp
169 {
170 flags = NAMEINARGS NOLIBWRAP
171 socket_type = stream
172 protocol = tcp
173 wait = no
174 user = news
175 server = /usr/sbin/tcpd
176 server_args = /usr/sbin/leafnode
177 instances = 7
178 per_source = 3
179 }
180
181# End /etc/xinetd.d/nntp
182<command>EOF</command></userinput></screen>
183
184<para>Issue a <command>killall -HUP xinetd</command> to reread the
185changed <filename>xinetd.conf</filename> file.</para>
186
187<para>Add entries to the root or news user's crontab to run the
188<command>fetchnews</command> and <command>texpire</command> commands at the
189desired time intervals.</para>
190
191</sect3>
192
193</sect2>
194
195<sect2>
196<title>Contents</title>
197
198<segmentedlist>
199<segtitle>Installed Programs</segtitle>
200<segtitle>Installed Libraries</segtitle>
201<segtitle>Installed Directories</segtitle>
202
203<seglistitem>
204<seg>applyfilter, checkgroups, fetchnews, leafnode, leafnode-version,
205newsq and texpire</seg>
206<seg>None</seg>
207<seg>/etc/leafnode, /var/lock/leafnode and /var/spool/news</seg>
208</seglistitem>
209</segmentedlist>
210
211<variablelist>
212<bridgehead renderas="sect3">Short Descriptions</bridgehead>
213<?dbfo list-presentation="list"?>
214
215<varlistentry id="applyfilter">
216<term><command>applyfilter</command></term>
217<listitem><para>filters newsgroup articles according to regular
218expressions.</para>
219<indexterm zone="leafnode applyfilter">
220<primary sortas="b-applyfilter">applyfilter</primary>
221</indexterm></listitem>
222</varlistentry>
223
224<varlistentry id="checkgroups">
225<term><command>checkgroups</command></term>
226<listitem><para>inserts newsgroup titles into the newsgroup database.</para>
227<indexterm zone="leafnode checkgroups">
228<primary sortas="b-checkgroups">checkgroups</primary>
229</indexterm></listitem>
230</varlistentry>
231
232<varlistentry id="fetchnews">
233<term><command>fetchnews</command></term>
234<listitem><para>sends posted articles to and retrieves new articles from an
235upstream news server.</para>
236<indexterm zone="leafnode fetchnews">
237<primary sortas="b-fetchnews">fetchnews</primary>
238</indexterm></listitem>
239</varlistentry>
240
241<varlistentry id="leafnode-prog">
242<term><command>leafnode</command></term>
243<listitem><para>is an <acronym>NNTP</acronym> server daemon.</para>
244<indexterm zone="leafnode leafnode-prog">
245<primary sortas="b-leafnode">leafnode</primary>
246</indexterm></listitem>
247</varlistentry>
248
249<varlistentry id="leafnode-version">
250<term><command>leafnode-version</command></term>
251<listitem><para>prints the <application>Leafnode</application> version.</para>
252<indexterm zone="leafnode leafnode-version">
253<primary sortas="b-leafnode-version">leafnode-version</primary>
254</indexterm></listitem>
255</varlistentry>
256
257<varlistentry id="newsq">
258<term><command>newsq</command></term>
259<listitem><para>shows articles waiting to be sent upstream.</para>
260<indexterm zone="leafnode newsq">
261<primary sortas="b-newsq">newsq</primary>
262</indexterm></listitem>
263</varlistentry>
264
265<varlistentry id="texpire">
266<term><command>texpire</command></term>
267<listitem><para>expires old articles and unread groups.</para>
268<indexterm zone="leafnode texpire">
269<primary sortas="b-texpire">texpire</primary>
270</indexterm></listitem>
271</varlistentry>
272</variablelist>
273
274</sect2>
275
276</sect1>
Note: See TracBrowser for help on using the repository browser.