=====	INHALTSVERZEICHNIS

- BERBLICK
- DATEIEN UND VERZEICHNISSE
- DIE FILTERDATEI
- INSTALLATION
- UPDATE VON VERSIONEN < 1.6
- UPDATE VON VERSIONEN < 1.9.3
- UPDATE VON VERSIONEN < 1.9.20 -- WICHTIG! INKOMPATIBLE NDERUNGEN!
- UPDATE VON VERSIONEN < 1.9.23 -- WICHTIG! INKOMPATIBLE NDERUNGEN!
- UPDATE VON VERSIONEN < 1.11.0 -- WICHTIG! INKOMPATIBLE NDERUNG!
- FEHLERSUCHE
- PROBLEME


=====	BERBLICK

Leafnode ist ein USENET-Software-Paket, das fr kleine Sites mit
wenigen Lesern und einer langsamen Netzanbindung entwickelt wird.

Es besteht aus mehreren Programmen, von denen drei fr die Funktion
wichtig sind und mehreren Beigaben:

 - leafnode ist der NNTP-Server. Er kommuniziert mit den blichen
   Newsreadern und speichert die Leserdaten.

 - fetchnews ldt die Artikel vom Upstream-Server. Es entscheidet anhand
   der von leafnode gesammelten Daten, aus welchen Gruppen Postings
   heruntergeladen werden.

 - texpire lscht alte und uninteressante Postings. Es lscht alle
   alten Threads, die nicht in letzter Zeit gelesen wurden.

Dies sind die Beigaben:

 - Mit applyfilter knnen Artikel, die einem bestimmten Muster
   entsprechen, lokal gelscht werden.

 - checkgroups fgt die Beschreibung der Newsgruppen in die
   Newsgruppen-Datenbank ein.

 - newsq zeigt die Artikel an, die beim nchsten Lauf von fetchnews
   zum Upstream-Server geschickt werden sollen.

Es werden nur diejenigen Gruppen vom Upstream-Server geladen, die in
der vergangenen Woche von einem lokalen Benutzer gelesen wurden. Wird
eine Gruppe nicht mehr gelesen, ldt fetchnews eine Woche spter keine
Artikel aus dieser Gruppe mehr, beginnt jemand eine neue Gruppe zu
lesen, versucht fetchnews beim nchsten Lauf soviel Artikel wie
mglich aus dieser Gruppe zu bekommen. (Anmerkung des bersetzers: Die
Anzahl wird durch die Parameter maxfetch und initialfetch in der
config-Datei begrenzt.)

Eigenschaften von Leafnode:

 - Verbraucht im Gegensatz zu anderen NNTP-Servern sehr wenig
   Plattenplatz und Bandbreite. Dies stimmt aber eher fr eine Site mit
   3 Benutzern als fr eine mit 30. Bei 300 Benutzern stimmt es wohl
   berhaupt nicht mehr.

 - Einfache Konfiguration und Pflege. Leafnode bemht sich sehr, Fehler
   selbstttig zu korrigieren.

 - Die lokal vorhandenen News knnen sehr einfach durch eigene Skripte
   manipuliert werden. Einige kleine Beispiele hierfr finden sich im
   Unterverzeichnis tools/ .

Schwchen von Leafnode:

 - Leafnode 'verliert' News. In fast jeder Fehlersituation versucht
   leafnode diese zu bereinigen, indem es das den Fehler auslsenden
   Posting lscht.

 - Leafnode skaliert sehr schlecht.

Die neueste Version von leafnode steht immer unter

	http://www.leafnode.org/

zur Verfgung.

Auerdem gibt es eine Mailing-Liste fr leafnode. Um sie zu bestellen,
braucht man nur eine Mail an

	leafnode-list-subscribe@dt.e-technik.uni-dortmund.de

zu schreiben, oder die folgende Webseite zu besuchen:

	http://www.dt.e-technik.uni-dortmund.de/mailman/listinfo/leafnode-list

Die Bestellung der Mailingliste lst eine Rckfragemail aus, die Sie
beantworten mssen, bevor die Bestellung wirksam wird, damit niemand
ohne Ihr Einverstndnis die Liste fr Sie bestellen kann.

Dem Maintainer sind am 2005-04-17 drei Archive der Mailingliste bekannt:

http://www.dt.e-technik.uni-dortmund.de/pipermail/leafnode-list/
http://www.leafnode.de/maillist-eng.htm
http://news.gmane.org/gmane.network.leafnode


=====	DATEIEN UND VERZEICHNISSE

Leafnode legt seine Dateien in drei verschiedenen Verzeichnissen ab:
im spool-Verzeichnis, im library-Verzeichnis und im
binaries-Verzeichnis.

Im spool-Verzeichnis liegen die gespeicherten News, das active-File
und einige kurzlebige Konfigurationsdateien. Auerdem gibt es hier
einige spezielle Verzeichnisse, mehr Informationen dazu gibt es in
man leafnode(8). Die Grundeinstellung fr das spool-Verzeichnis ist
/var/spool/news, sie kann aber bei der Compilierung gendert werden.

Im library-Verzeichnis liegen die langlebigen Konfigurationsdateien.
Es ist blicherweise /etc/leafnode, kann aber gendert werden.

Das binaries-Verzeichnis /usr/local/sbin enthlt die ausfhrbaren
Programme texpire, fetchnews und leafnode. Auch dieses Verzeichnis
kann angepat werden.

Auerdem wird im Verzeichnis /usr/local/bin das Programm newsq
abgelegt.


=====	DIE FILTER-DATEI

Seit Version 1.8 untersttzt leafnode das Filtern ankommender Artikel-
header nach beliebigen regulren Ausdrcken. Diese Mglichkeit ist
normalerweise abgeschaltet; um sie zu aktivieren, mssen Sie eine
Datei anlegen (die "Filter-Datei"), die die gewnschten Ausdrcke
enthlt. Auerdem mssen Sie leafnode mitteilen, wo diese Datei
gefunden werden kann. Dies geschieht durch Eintrag einer Zeile der Art

filterfile = /path/to/your/filterfile

in die Datei $(LIBDIR)/config.

Die Filterdatei hat das folgende Format:
1) Pro Zeile darf ein regulrer Ausdruck stehen
2) Kommentarzeilen werden durch ein # am Zeilenanfang gekennzeichnet
3) Leerzeilen sind zulssig und werden ignoriert

Hier ein kleines Beispiel, das alle Artikel abweist, die nach alt.flame
gepostet werden:

^Newsgroups:.*[, ]alt.flame$
^Newsgroups:.*[, ]alt.flame,

Der Ausdruck

^Newsgroups:.*alt.flame

funktioniert nicht richtig, weil er auch Postings nach alt.flame.nice oder
comp.alt.flame abweist.

Ab Version 1.9.3 benutzt leafnode Perl-kompatible regulre Ausdrcke,
die in Philip Hazels PCRE-Bibliothek implementiert sind.
Perl-kompatible regulre Ausdrcke sollten in jedem vernnftigem Buch
ber Perl erklrt sein; auerdem gibt es im O'Reilly-Verlag ein ganzes
Buch ber regulre Ausdrcke. Eine ziemlich technische Erklrung gibt
es in man 7 pcre.


=====	INSTALLATION

Die Installation von leafnode wird im Text INSTALL_de erklrt.


=====	UPDATE VON VERSIONEN < 1.6

Es gibt einige grere Unterschiede zwischen den aktuellen Versionen
von leafnode und denen vor 1.6, einschlielich 1.6alpha

1) Das Format der groupinfo-Datei hat sich verndert

2) Einige Dateien (einschlielich der groupinfo-Datei ) liegen nicht
   mehr im Verzeichnis /usr/lib/leafnode/, sondern in
   /var/spool/news/leaf.node/

3) Die Artikel-Informationen fr den Upstream-Server wurden aus der
   groupinfo-Datei herausgenommen und bilden nun eine eigene Datei.

Um ein funktionierendes Update zu erhalten, mu man nach dem
erfolgreichen Durchlauf von "make install" als root "make update"
ausfhren, in INSTALL_de wird dies jedoch genauer erklrt.


=====	UPDATE VON VERSIONEN < 1.9.3

Es gibt einen weiteren Unterschied im Gegensatz zu frheren Versionen
(Dies betrifft auch alle leafnode-1.9.3beta-Versionen bis
einschlielich leafnode-1.9.3beta5):

Die groupinfo-Datei ist nun abhngig von der Gro- und und
Kleinschreibung der Gruppennamen sortiert. Um ein funktionierendes
Update zu erhalten, mu man nach dem erfolgreichen Durchlauf von
"make install" als root "make update" ausfhren, in INSTALL_de wird dies
jedoch genauer erklrt.


=====	UPDATE VON VERSIONEN < 1.9.20

Leafnode wurde in Version 1.9.20 in folgenden Punkten gendert:

1. fetchnews verwendet nun auch den XOVER-Befehl, um zu schauen, welche
   neuen Artikel der/die Upstream-Server vorhalten; vorher wurde lediglich
   XHDR verwendet.  Sollte einer Ihrer Upstream-Server den XOVER-Befehl
   nicht verstehen, wird Leafnode stattdessen automatisch XHDR verwenden.

2. Die meisten Leafnode-Programme verlangen die Einstellung eines voll
   qualifizierten Domainnamens ("fully qualified domain name", FQDN) und
   beenden sich, falls gethostbyname("HOSTNAME") keinen solchen liefert
   (HOSTNAME ist dabei der Name, den gethostname zurckliefert).  Wichtig
   hierbei ist, da der Name global eindeutig sein mu:  Nur Ihr Computer
   (und sonst keiner auf der Welt) darf diesen Namen verwenden.  Eine
   solche Verwendung wrde dazu fhren, da Sie eigene Postings verlieren.
   Daher werden Domainnamen der Form "localhost.localdomain" nicht
   akzeptiert.

3. Die Semantik der out.going-Warteschlange wurde gendert:  Falls ein
   Posting zu einem Upstream-Server fehlschlgt, so wird der Artikel
   sofort in das Verzeichnis failed.postings verschoben.  In vorherigen
   Versionen wurden zunchst die anderen Server befragt.

4. In wenigen Ausnahmefllen kann fetchnews kein lockfile erstellen und
   hinterlt Dateien der Form /var/lock/news/eftchnews.lck.XXFjkle8w3 .
   Diese knnen gefahrlos entfernt werden, wenn sichergestellt ist, da
   kein fetchnews oder texpire gleichzeitig laufen.


=====	UPDATE VON VERSIONEN < 1.9.23

Falls Sie Zugriff auf leafnode von auerhalb des lokalen Netzwerks (LAN)
erlauben wollen, so hat es bislang gengt, die zugreifenden Netze in
der hosts.allow Datei freizugeben.  Ab Version 1.9.23 mu in der Konfigu-
rationsdatei von Leafnode zustzlich eine weitere Option gesetzt werden.
Das Vorgehen ist in config.example beschrieben und dient als Schutzmanahme
fr unerfahrene Benutzer vor ungebetenen Zugriffen.

AN DISTRIBUTOREN: NDERUNG DIESER EINSTELLUNG ODER NDERUNG DES KOMMENTARS
IN DER BEISPIELKONFIGURATION WIRD _NICHT_ UNTERSTTZT!  EIN SOLCHES VORGEHEN
WIRD AUF BUGTRAQ ET AL. ANGEZEIGT.

=====	UPDATE VON VERSIONEN < 1.11.0

1. nderung der Konfiguration:

Der Analysator fr die Konfigurations- und Filterdateien versteht nun
Zeichenketten in Anfhrungszeichen auf der rechten Seite der
Konfigurationszeilen, mit einfachen Fluchtsequenzen mit
Rckwrtsschrgstrich (\), um die Raute (#), Anfhrungszeichen (") oder
fhrende/nachlaufende Leerzeichen in Passwrtern oder Filtern zuzulassen.
Wenn Sie solche Zeichen in der Konfiguration oder in Filtern verwenden,
mssen Sie ggf. diese Konfigurations-/Filterzeilen anpassen. Details
sind in der leafnode(8)-Handbuchseite beschrieben.

2. IPv6-Untersttzung in fetchnews:

fetchnews untersttzt seit Version 1.11.0 IPv6. Dazu muss immer noch
./configure --with-ipv6 bentzt werden, und natrlich muss das
Betriebssystem IPv6 untersttzen und Sie einen IPv6-Netzwerkzugang
haben, der noch nicht weit verbreitet ist. Davon abgesehen, ist keine
besondere Konfiguration erforderlich, fetchnews benutzt transparent
IPv6-Adressen, wenn die Namensauflsung fr einen Server IPv6-Adressen
zurckliefert.

=====	FEHLERSUCHE

Wenn Sie Probleme mit leafnode haben, knnen Sie sehr viel ber
das, was leafnode tut, herausfinden, indem Sie "debugmode = 1" in die
config-Datei aufnehmen und anschlieend das Logging fr "news"
einschalten. Leafnode (also: fetchnews, texpire und der NNTP-Daemon)
knnen jede Menge informativen Output erzeugen.

Um das Logging einzuschalten, tut man am besten folgendes:

1. in der Datei /etc/leafnode/config die Zeile "debugmode=1" hinzufgen,

2. in der Datei /etc/syslog.cong die Zeile
   news.*	/var/log/news.all
   hinzufgen, und

3.   kill -HUP `cat /var/run/syslog.pid`
   oder
     kill -HUP `cat /var/run/syslogd.pid`
   ausfhren (distributionsabhngig).

Bei manchen syslogd-Programmen (Linux) lt sich fr asynchrone Updates
(schneller) der Meldungen ein - vor den Dateinamen stellen, z.B. so:
news.*	-/var/log/news.all

Manche syslogd-Programme verstehen den * in news.* nicht.  Schreiben Sie
news.debug stattdessen.

Achtung: Das logfile kann sehr schnell sehr gro werden ...

Wenn Sie im Usenet Fragen zu leafnode stellen wollen, knnen Sie dies
in de.comm.software.newsserver tun. (In englischer Sprache steht auch
die Gruppe news.software.nntp zur Verfgung.)


=====	PROBLEME

Dies sind die Lsungen zu hufig auftretenden Problemen:


Problem: Ich mchte meinen Upstream-Server ndern.
Lsung:  Ich habe das zwar noch nie getan, leafnode sollte aber keine
	 Probleme damit haben. Angenommen, der neue Server heit
	 "neuer.upstream.server"  und der alte "alter.upstream.server",
	 empfehle ich folgende Vorgehensweise.
	   1) Fgen Sie folgende Zeilen in Ihre config-Datei ein
	   	supplement = neuer.upstream.server
		maxfetch = 100
	      Sollten Sie maxfetch auf einem anderen Wert stehen haben,
	      reduziere Sie ihn vorbergehend.
	   2) Starten Sie fetchnews.
	   3) Ersetzen Sie
		server = alter.upstream.server
	      durch
		server = neuer.upstream.server
	      und lschen Sie die Zeilen, die in Schritt 1) eingefgt
	      wurden.
	  Das war's!


Problem: fetchnews 'hngt sich auf', nachdem es etwas wie "corrected
         123 lines in
	 /var/spool/news/de/comp/os/unix/linux/misc/.overview"
	 ausgegeben hat.
Lsung:  Dies ist berhaupt kein Problem, sondern das ganz normale
         Verhalten von fetchnews.

	 Nachdem es alle Artikel geladen und gespeichert hat, startet
         leafnode einen Sub-Proze, der ein paar Aufrumarbeiten
         durchfhrt und beendet sich. Dieser Proze wird nicht mehr
         von der Shell kontrolliert, auch wenn er noch auf das
         Terminal schreibt. Die Shell kann nicht erfassen, wann dieser
         Proze endet und darum keinen Prompt ausgeben.

Problem: Ich kann meinen Newsserver nicht erreichen.
Lsung:  Hchstwahrscheinlich stimmt etwas in Ihrem Setup nicht.
         Es gibt mehrere Mglichkeiten:
	  1) inetd luft nicht, berprfen Sie dies mit "ps axu | grep
	     inetd"
	  2) inetd luft, aber die Eintrge in /etc/inetd.conf sind
	     falsch. berprfen Sie die logfiles (blicherweise
	     /var/log/messages oder /var/log/syslog), ob dort
	     Fehlermeldungen von inetd auftauchen.
	  3) inetd luft und der Eintrag in /etc/inetd.conf ist
	     korrekt, aber der tcpd verbietet den Zugriff auf den
	     Server (in /var/log/messages mte etwas wie
	     "leafnode: connection refused from ..." auftauchen).
	     berprfen Sie die Dateien /etc/hosts.allow und
	     /etc/hosts.deny. Ein Beispiel fr einen funktionierenden
	     Eintrag dort findet sich auch in INSTALL_de.
	  4) Ein weiterer, schlecht konfigurierter NNTP-Server luft
	     bereits. Schalten Sie ihn ab.
         Man kann das Setup brigens testen, indem man mit
	 "telnet localhost 119" manuell eine Verbindung zum NNTP-Server
	 herstellt. Dabei sollte man ungefhr folgende Ausgabe
	 erhalten:
	 	200 Leafnode NNTP Daemon, version xx running at yy
	 wobei xx die Versionsnummer und yy Ihr Hostname ist.
	 Mit "quit" kann man diese Verbindung wieder beenden.
	 Sollten Sie diese Nachricht nicht erhalten, gehen Sie
	 Schritte 1) - 4) erneut durch.

Problem: tin beklagt sich, da die Datei "/var/lib/news/active" nicht
         existiert.
Lsung:  Entweder haben Sie  die falsche Version von tin gestartet
         (Die, die direkt aus dem spool-Verzeichnis liest) oder Ihre
	 groupinfo-Datei ist defekt.
         Im ersten Fall mssen Sie tin mit "tin -r" aufrufen, falls dies
	 nicht hilft, versuchen Sie, Ihre groupinfo-Datei neu erstellen
	 zu lassen, indem Sie fetchnews mit -f starten.

Problem: Wenn ich mit Netscape News suche, erhalte ich die
         Fehlermeldung "unknown command".
Lsung:  Um in den News zu suchen bentigten ltere Netscape-Versionen
         einen News-Server, der den XPAT-Befehl untersttzt. Leafnode
	 tut dies nicht. Wenn Sie wirklich Netscape benutzen wollen,
	 setzen Sie  eine  Version ab 4.5 ein und klicken Sie auf den
	 Button "options" im "search messages"-Dialog. In dem jetzt
	 erscheinenden Fenster mssen Sie "on your local system"
	 auswhlen.

Problem: fetchnews ldt keine Artikel
Lsung:  a) Ihre groupinfo-Datei ist defekt, erstellen Sie sie neu indem
            Sie fetchnews mit "fetchnews -f" neu starten.
	 b) Die Rechte in /var/spool/news stimmen nicht. /var/spool/news
	    und alle Unterverzeichnisse mssen drwxrwsr-x-Rechte
	    haben und dem User und der Gruppe news gehren.

Problem: fetchnews beendet sich mit einem "segmentation fault".
Lsung:  Das sollte nicht passieren. Falls fetchnews beim Posten
         abstrzt, hilft es, nur die zu postenden Artikel mit
	 "fetchnews -P" zu posten. Strzt es beim Download ab, sollte
	 der mehrmalig  Aufruf von fetchnews Abhilfe schaffen und alle
	 neuen Artikel holen.

Problem: Mein Newsreader beschwert sich ber hufige Timouts des
	 NNTP-Servers.
Lsung:  Auch dies ist wahrscheinlich Folge einer defekten
	 groupinfo-Datei. Erstellen Sie sie mit "fetchnews -f" neu.

Problem: leafnode erstellt fehlerhafte/unvollstndige Message-IDs.
Lsung:  Wahrscheinlich hat Ihre Maschine keinen oder nur einen
	 unvollstndigen Hostnamen. Leafnode versucht den Hostnamen
	 herauszufinden, indem es gethostname(2) aufruft und den
	 zurckgelieferten Wert an einen gethostbyname(3)-Aufruf
	 weitergibt. Wenn Sie den Hostnamen mit hostname(1) und
	 domainname(1) korrigieren, sollten Sie auch korrekte
	 Message-IDs erhalten. Falls Sie das nicht wollen, knn Sie
	 auch den Teil der Message-ID, der nach dem @ folgt ndern,
	 indem Sie

	 "hostname = richtiger.hostname"

	 in Ihre config-Datei einfgen. (s.a. man 8 leafnode)

	 (Anmerkung des bersetzers: Anscheinend bietet es sich manchem
	 Spavogel an, auf diese Weise  irgendwelche Fantasiedomains
	 in seiner Message-ID zu verwenden. Davon kann allerdings nur
	 abgeraten werden! Bei Fragen hierzu stehen die Experten in
	 de.admin.netabuse.news gerne zur Verfgung. :-)

Problem: fetchnews hat Probleme, neue Newsgruppen zu bekommen.
Lsung:	 Mglicherweise untersttzt Ihr Upstream-Server weder das
	 "XGTITLE news.group.name"- noch das
	 "LIST NEWSGROUPS news.group.name"-Kommando. Fgen Sie in diesem
	 Fall "nodesc" Ihrem Servereintrag dazu, wie es in man 8
	 leafnode und der config.example-Datei beschrieben ist.

Problem: texpire lscht keine Artikel
Lsung:	 Starten Sie texpire mit dem Parameter -f. So werden Artikel etwas
	 frher gelscht, da der Zeitpunkt des letzten Zugriffs
	 ignoriert wird.

	 Sollten Sie dringend Platz in Ihrem Spool-Verzeichnis
	 brauchen, reduzieren Sie in der config-Datei die Zeit, die Artikel
	 vorgehalten werden sollen und rufen Sie texpire -f erneut auf.

Problem: Wenn ich leafnode im "delaybody"-Modus betreibe, kann ich mit
	 Netscape/Outlook Express nur die Header der Artikel sehen.
Lsung:	 Dies ist ein Problem von Netscape und Outlook Express, nicht
	 von leafnode. Diese Newsreader speichern gelesene Artikel im
	 Cache und weigern sich aus irgendeinem seltsamen Grund,
	 einmal gelesene Artikel erneut zu laden.
	 Um Netscape dazu zu zwingen, leeren Sie den Cache und versuchen es
	 nochmal oder besorgen sich besser einen vernnftigen
	 Newsreader. (Falls jemand eine Lsung fr Outlook Express
	 findet, wre ich fr eine email dankbar.

Cornelius Krasel <krasel@wpxx02.toxi.uni-wuerzburg.de>
Matthias Andree <matthias.andree@gmx.de>

bersetzung: Alexander Reinwarth <a.reinwarth@gmx.de>
	     Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
