  News Leafsite mini-HOWTO
  Florian Khnert (sutok@gmx.de) und Uwe Hermann
  (uh1763@bingo.baynet.de)
  v0.3-2, 13. September 1998

  Dieses HOWTO wird Dir helfen, mit dem freien Softwarepaket Leafnode
  einen kleinen lokalen News-Server fr Usenet News zu konfigurieren.


  1.  Wieso Leafnode?

  Wenn man an seinem lokalen Computer News offline lesen will, mu man
  normalerweise eine News-Server-Software wie etwa INN oder CNews
  installieren. Auerdem braucht man eine NNTP- oder UUCP-Verbindung zu
  seinem Newsfeed. Da aber solche Pakete mehr Funktionen/Features
  enthalten, als man normalerweise bentigt, ist man besser dran wenn
  man Leafnode installiert.


  Leafnode ist viel einfacher zu bedienen und sehr klein, hat aber
  einige Nachteile: Leafnode ist langsam und verliert in nahezu jeder
  Fehler-Situation News. Deshalb sollte man es nicht fr einen groen
  News-Server benutzen, nichtsdestotrotz ist es aber fr private
  Anwender, die nicht viel Zeit fr die Konfiguration von INN aufwenden
  wollen, ausreichend.



  2.  Woher bekomme ich Leafnode?

  Leafnode steht unter

       ftp.troll.no:/pub/freebies/


  zum herunterladen bereit und wurde von Arnt Gulbrandsen, einem
  Angestellten von Troll Tech AS, entwickelt. The neueste Version ist
  1.4 und wird in manchen Distributionen(wie z.B. Debian) schon mit
  geliefert. Man sollte auf jeden Fall sichergehen, da man mindestens
  Version 1.4 benutzt, da mehrere kritische Bugs ausgebessert worden
  sind.
  3.  Wie installiere ich Leafnode?

  Eine kleine Installationshilfe gibt es in dem Packet, aber lass es uns
  doch lieber zusammen installieren :-).  Wenn Leafnode >=1.4 mit Deiner
  Distribution mitgeliefert wurde, ist es am klgsten, die
  vorkompilierte Version zu verwenden, und Schritt 1 bis 4 auszulassen.



  1. Stelle sicher, da kein anderer News-Server auf Deinem Computer
     luft. Wenn du


       $ telnet localhost nntp




  eintippst, solltest Du eine Fehlermeldung bekommen. Wenn Du eine
  Verbindung bekommst, geh zurck zum Prompt Deiner Shell und De-instal
  liere INN, Cnews oder welchen News-Server Du auch immer jetzt am
  Laufen hast, und kommentiere die nntp-Zeile in deiner /etc/inetd.conf
  aus.



  2. Stelle sicher, da es einen User news auf deinem System gibt,
     durchsuche /etc/passwd nach dem Namen. Wenn keiner existiert, dann
     erzeuge einen, wobei Du entweder


       $ adduser news




  oder ein Tool benutzt, das mit Deiner Distribution mitgeliefert wurde.



  3. Entpacke den Quellcode:


       $ tar xfz leafnode-1.4.tar.gz




  und wechsle in das Verzeichnis, in dem sich der Quellcode befindet:.


       $ cd leafnode-1.4






  4. Kompiliere und installiere das Programm.


       $ make; make install




  5. Editiere /usr/lib/leafnode/config (kann sich auch woanders
     befinden, wie etwa /etc/leafnode, wenn du eine vorkompilierte
     Version von deiner Linux-Distribution verwendest. Die Zeile Server
     = sollte den Namen des News-Server Deines Providers enthalten.



  6. Bearbeite /etc/nntpserver. Diese Datei sollte den Namen des eigenen
     Rechners enthalten (localhost oder wie auch immer der Name des
     Rechners lautet; um das herauszufinden, benutze das Kommando
     hostname). Wenn in irgendeiner Konfigurations-Datei, wie etwa
     /etc/profile oder ~/.bash_profile die Umgebungsvariable definiert
     ist, solltest Du sie auch dort auf den Namen Deines Rechners
     ndern.



  7. Bearbeite die /etc/inetd.conf: stelle sicher, da es keine Zeile
     gibt, die mit nntp anfngt. Wenn so eine Zeile existiert, stelle
     ein # davor, um sie auszukommentieren. Dann fge die folgende
     Zeile hinzu:


       nntp stream tcp nowait news /usr/sbin/tcpd /usr/local/sbin/leafnode





  Wenn nun jemand (z.B. Du :-)) sich an Deinem Computer am nntp-port
  anmeldet, wird Leafnode als Server-Prozess gestartet.



  8. Stelle eine Verbindung zum Internet her und fhre das Programm
     fetch als root oder news aus. Das erste Mal, wenn fetch
     gestartet wird, wird es eine Liste der Newsgroups, die Dein
     Provider Dir zur Verfgung stellt, herunterladen. Dies kann eine
     Zeit lang dauern, je nach Geschwindigkeit Deiner Verbindung und je
     nach Anzahl der Newsgroups, die Dein Provider in seinem active-file
     hat.



  9. Starte einen Newsreader (slrn, (r)tin und knews sind kein
     schlechter Anfang) und abonniere alle Gruppen, die Du lesen
     mchtest. Achte darauf, diese Gruppen nicht nur zu abonnieren,
     sondern sie auch zu ffnen, auch wenn sie leer sind.



  10.
     Starte fetch erneut, um nun alle News herunterzuladen, die Du lesen
     mchtest.



  4.  Wie konfiguriere ich Leafnode?

  Nun hast du ein funktionierendes News-System am Laufen, aber es gibt
  immer noch ein paar Dinge zu tun. Du knnstest die Datei
  /usr/lib/leafnode/config editieren und die expire dates der
  Newsgroups zu setzen. Diese Zahl sagt aus, nach wieviel Tagen alte
  Nachrichten gelscht werden sollen. Die Standard-Einstellung von 20
  Tagen ist oft zu lange, wenn du einige Gruppen mit viel Traffic
  liest, vier Tage oder eine Woche sind in den meisten Fllen
  ausreichend. Du kannst den Wert fr alle Gruppen setzen (expire = n
  um alle News n Tage zu behalten) und zustzlich Leafnode sagen, es
  soll diesen Wert fr bestimmte Gruppen ndern, indem du


       groupexpire foo.bar n




  in der config eintrgst, das die expire time fr die Gruppe foo.bar
  auf n Tage setzt, d.h. alte Artikel werden nach n Tagen gelscht.


  Diese Einstellungen alleine werden Leafnode nicht veranlassen, etwas
  zu lschen, dafr gibt es ein extra Programm, nmlich texpire. Es kann
  als ein cron-Job oder von der Kommandozeile aus gestartet werden.
  Wenn Dein Rechner die ganze Zeit eingeschaltet ist, kannst Du folgende
  Zeile zur crontab-Datei von news hinzufgen (um die crontab zu
  editieren, log dich als news ein und fhre


       $ crontab -e




  oder als root


       $crontab -u news -e




  aus).


       0 19 * * * /usr/local/sbin/texpire




  Diese Zeile bewirkt, da der cron-Daemon jeden Tag um 19.00 Uhr
  texpire startet. Lies dir die crontab-manpage durch, um weitere
  Informationen zu erhalten. Wenn Dein Computer nicht regelmig
  eingeschaltet ist, kannst du texpire einfach von Zeit zu Zeit
  aufrufen, wenn du bemerkst, da fetch langsamer wird. Die cron-
  Methode funktioniert aber auch ziemlich gut.



  5.  Wie funktioniert Leafnode?

  Leafnode ist ein echter NNTP-Server, da heit, man kann sich auch
  von einem anderen Rechner aus einloggen (via Internet, vom lokalen
  Netzwerk aus usw.). Jedes Mal, wenn man in seinem News-Reader eine
  Gruppe ffnet, fordert der Reader diese bentigten News von Leafnode
  an. Wenn die Gruppe nicht existiert, erzeugt Leafnode eine leere Datei
  in dem Verzeichnis /var/spool/news/interesting.groups/, die den
  gleichen Namen trgt wie die Gruppe. Wenn Du das nchste Mal fetch
  aufrufst, wird es die News dieser Gruppe holen. Wenn du eine Gruppe
  eine gewisse Zeit lang nicht gelesen hast, wird Leafnode aufhren, die
  Nachrichten dieser Gruppe vom Server zu holen, und die entsprechende
  Datei aus /var/spool/news/interesting.groups/ lschen.  Wenn du also
  z.B. gerade aus Versehen eine high-traffic Newsgroup abonniert hast,
  kannst du die entsprechende Datei aus
  /var/spool/news/interesting.groups/ von der Kommandozeile aus lschen,
  und mut nicht eine Woche lang alle News herunterladen, bis Leafnode
  von alleine aufhrt die News dieser Gruppe zu holen.


  Eine Woche ist dir zu wenig? Du willst drei Wochen in Urlaub fahren
  und immer noch die News bekommen? Leider gibt es dafr keine Option in
  Leafnode. Du kannst aber die Datei leafnode.h editieren und das Paket
  neu kompilieren.  Die definierten Konstanten sind TIMEOUT_LONG und
  TIMEOUT_SHORT, stelle einfach die Zeit in Sekunden ein. Eine
  einfachere Lsung besteht darin, einen cron-Job festzulegen, der


       touch /var/spool/news/interesting.groups/*




  jede Nacht durchfhrt.


  Wenn Du eine Liste aller verfgbarer Gruppen haben mchtest schau Dir
  die Datei /usr/lib/leafnode/groupinfo an, wo Du zu jeder Gruppe auch
  eine kurze Beschreibung erhalten wirst.


  Wenn Du die Liste der Gruppen nochmal vom deinem Newsfeed anfordern
  willst (z.B. wenn du eine neu dazugekommene Gruppe abonnieren willst),
  lsche einfach die Datei /var/spool/news/active.read.  Fetch wird beim
  nchsten Aufruf die Liste erneut holen und die Datei
  /var/spool/news/active.read erneut erstellen. Fetch wird auch ab und
  zu automatisch die Liste wieder anfordern, soda man das nicht manuell
  machen mu.



  6.  Welchen News-Reader sollte ich verwenden?

  Der News-Reader fr Linux existiert nicht, genausowenig wie der
  Editor.  Mein persnlicher Favorit ist emacs im Gnu-Modus, da er sehr
  flexibel zu konfigurieren ist. Viele Menschen benutzen slrn und tin an
  einem Terminal, viele auch knews unter X. Es gibt auch trn, nn und
  viele weitere Reader, also probier einfach, aus welcher Dir am besten
  gefllt. Der einzige Reader, den man nicht benutzen sollte ist
  Netscape; er ist gro, hat wenige Features, ist instabil, und legt
  fters ungewnschtes Fehlverhalten an den Tag.  Wie auch immmer...
  letztendlich ist es Deine persnliche Entscheidung.


  Knews ist wohl aber keine schlechte Idee fr den Anfang, da er sehr
  benutzerfreundlich und einfach zu verstehen ist.



  7.  Wo bekomme ich mehr Informationen?

  Etwas Dokumentation wird mit dem Leafnode-Paket mitgeliefert (lies Dir
  die Dateien INSTALL und README durch, die Quellcodes sind aber auch
  interessant). Wenn du etwas ber professionelle und groe News-
  Server wissen willst, lies Dir die INN FAQ durch (wird mit dem INN-
  Paket mitgeliefert). Um Informationen ber Deinen News-Reader zu
  bekommen, benutze das Kommando



  $ man NameDesNewsReaders




  an der Kommandozeile, und schau dir die Dateien in /usr/doc mal an.


  Wenn du irgendwelche Fragen das News-System betreffend hast, frag
  einfach in einer entsprechenden Gruppe nach, etwa in der
  news.software.ALL-Hierarchie.


  Wenn du irgendeine Frage, einen Kommentar oder Verbesserungvorschlge
  dieses HOWTO betreffend hast, schreib mir einfach eine E-Mail unter
  sutok@gmx.de.



  8.  Danksagung

  Ich mchte mich bei Michael Schulz (michaels@home.on-luebeck.de) fr
  seine Hilfe bei sprachlichen Problemen, und Cornelius Krasel
  (krasel@wpxx02.toxi.uni-wuerzburg.de) fr seinen touch *-Trick
  bedanken.


  9.  Copyright

  Dieses Dokument ist urheberrechtlich geschtzt. Das Copyright fr die
  englische News Leafsite mini-HOWTO, auf der dieses Dokument basiert,
  liegt bei Florian Khnert. Das Copyright fr die deutsche Version
  liegt bei Uwe Hermann.

  Das Dokument darf gem der GNU General Public License verbreitet
  werden. Insbesondere bedeutet dieses, da der Text sowohl ber
  elektronische wie auch physikalische Medien ohne die Zahlung von
  Lizenzgebhren verbreitet werden darf, solange dieser Copyright
  Hinweis nicht entfernt wird. Eine kommerzielle Verbreitung ist erlaubt
  und ausdrcklich erwnscht. Bei einer Publikation in Papierform ist
  das Deutsche Linux HOWTO Projekt hierber zu informieren.

























