
                           News Leafsite mini-HOWTO

Florian Kuehnert, sutok@gmx.de

   v0.3, 4 January 1998
     _________________________________________________________________

   _Version franaise par Philippe Gaucher (gaucher@easynet.fr). Ce HOWTO
   vous aidera  mettre en place un petit site de news  l'aide du
   logiciel libre Leafnode. Pour toute question, suggestion ou tout
   commentaire, crire  Florian Kuehnert (sutok@gmx.de). Vous pouvez
   aussi me signaler tous les problmes que vous trouvez dans ce
   document. (C) 1998 by Florian Kuehnert. _
     _________________________________________________________________

1. Pourquoi utiliser Leafnode ?

   Si vous voulez lire les news hors connexion sur votre ordinateur
   local, vous avez gnralement  installer un logiciel de serveur de
   news comme INN ou CNews. Et vous avez galement besoin d'une connexion
   nntp ou uucp pour alimenter ce serveur. Du fait que ces logiciels
   contiennent bien plus de fonctionnalits que ncessaire, les choses
   iront mieux en installant Leafnode.

   Leafnode est vraiment plus simple  utiliser et est aussi trs petit,
   mais il a quelques inconvnients : Leafnode est lent et il perd des
   messages ds qu'un problme se prsente. C'est pourquoi vous ne
   devriez pas l'utiliser pour un gros serveur de news. Il est quand mme
   appropri pour des utilisateurs privs qui ne veulent pas passer trop
   de temps  configurer INN.

2. O trouver Leafnode ?

   Leanode est disponible  ftp://ftp.troll.no/pub/freebies/ et a t
   dvelopp par un employ de Troll Tech AS, Arnt Gulbrandsen. La
   version la plus rcente est 1.4 et dans certaines distributions (comme
   par exemple la Debian), Leafnode est inclus. Quoi qu'il en soit,
   vrifiez que vous avez au moins la version 1.4 car des bugs assez
   graves avaient t corrigs.

3. Comment l'installer ?

   Un fichier d'aide  l'installation est inclus dans le package. Mais
   faisons-la ensemble :-). Si une version suprieure ou gale  1.4 de
   Leafnode est fournie avec votre distribution, il serait plus sage
   d'utiliser les binaires prcompils et de sauter les tapes 1  4.

   1) Vrifiez qu'il n'y a pas d'autre serveur de news qui tourne sur
   votre machine. Quand vous tapez

$ telnet localhost nntp

   vous devez voir un message d'erreur. Si vous obtenez une connexion,
   retournez au prompt de votre shell, puis dsinstallez INN, CNews ou
   tout logiciel du mme type et commentez la ligne nntp dans
   /etc/inetd.conf.

   2) Vrifiez qu'il y a un utilisateur appel "news" :  regarder dans
   /etc/password. S'il n'existe pas, crez-en un ou bien tapez

$ adduser news

   ou bien utilisez tout outil fourni avec votre distribution.

   3) Dcompressez la source :

$ tar xfz leafnode-1.4.tar.gz

   et placez-vous dans le rpertoire source

$ cd leafnode-1.4

   4) Compilez le programme et installez-le :

$ make; make install

   5) ditez /usr/lib/leafnode/config (il peut tre  une autre place
   comme par exemple /etc/leafnode quand vous utilisez une version
   pr-compile fournie avec votre distribution Linux). La ligne
   "server=" doit indiquer le serveur de news de votre FAI.

   6) ditez /etc/nntpserver. Il doit contenir le nom d'hte local
   (localhost ou tout nom donn  votre ordinateur ; la commande hostname
   devrait vous aider pour cela). Si dans un des fichiers de dmarrage
   comme /etc/profile ou ~/.bash_profile, la variable d'environnement
   correspondante est dfinie, vous devriez l'ajuster galement au nom de
   votre ordinateur.

   7) ditez le fichier /etc/inetd.conf : soyez certain qu'il n'y a pas
   de ligne commenant par "nntp". S'il y avait une telle ligne,
   commentez-la en mettant un "#" au dbut. Puis ajoutez la ligne
   suivante :

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

   Quand quelqu'un (par exemple vous :-)) se connecte  votre ordinateur
   par le port NNTP, Leafnode est lanc comme processus serveur.

   8) Connectez-vous  votre FAI et lancez le programme "fetch" comme
   utilisateur root ou news. La premire fois que fetch est lanc, il
   tlchargera une liste des groupes de nouvelles disponibles chez votre
   FAI. Cela peut prendre un certain temps ; a dpend de la vitesse de
   votre connexion et du nombre de groupes de nouvelles que votre FAI a
   dans son fichier "active" [NdT : c'est le nom du fichier].

   9) Dmarrez votre lecteur de news prfr (slrn, (r)tin et knews ne
   sont pas de mauvais points de dpart) et inscrivez-vous  tous les
   groupes de nouvelles que vous lisez. Veillez  ne pas seulement vous
   inscrire  ces groupes de nouvelles, mais aussi  entrer dedans, mme
   s'ils sont vides.

   10) Relancez "fetch" encore une fois pour tlcharger tous les
   articles de tous les groupes de nouvelles qui vous intressent.

4. Comment maintenir leafnode ?

   Maintenant vous avez obtenu un serveur de news fonctionnel et qui
   tourne mais vous avez encore quelques petites choses  faire. Vous
   pouvez diter le fichier /usr/lib/leafnode/config pour configurer les
   dates d'expiration de vos groupes de nouvelles. Ce nombre indique
   quand les vieux messages doivent tre effacs. Le temps standard de 20
   jours est bien souvent trop long si vous lisez des groupes avec un
   trafic consquent ; 4 jours ou une semaine sont dans la plupart des
   cas un bon rglage pour votre systme. Vous pouvez changer la valeur
   pour tous les groupes ("expire=n" pour mettre tous les groupes  n
   jours), et vous pouvez dire  Leafnode de changer la date pour un
   groupe particulier en crivant groupexpire foo.bar n pour rgler le
   dlai d'expiration du groupe foo.bar  n jours.

   Ce rglage seul ne fera pas supprimer les messages par Leafnode. Un
   programme spar s'en charge : texpire. Il peut tre lanc par cron ou
   en ligne de commande. Si votre ordinateur est allum en permanence,
   vous avez la possibilit d'ajouter la ligne suivante au fichier
   crontab de news (pour l'diter, en tant qu'utilisateur news tapez
   "crontab -e", ou bien tapez sous root "crontab -u news -e") :

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

   Cette ligne a pour consquence que le daemon cron dclenchera texpire
   chaque jour  19:00. Reportez-vous  la page man de crontab pour
   d'autres rglages. Si votre ordinateur n'est pas constamment allum,
   vous avez la possibilit de dmarrer texpire de temps en temps
   manuellement, quand vous remarquez que fetch devient plus lent. Cela
   fonctionne aussi bien que le lancement par cron.

5. Comment a marche ?

   Leafnode est un "vrai" serveur NNTP, ce qui signifie que vous pouvez
   galement vous y connecter  partir d'un autre ordinateur (via
   Internet ou un rseau local, etc.).  chaque fois que vous entrez dans
   un groupe de nouvelles avec votre lecteur de news, votre lecteur
   envoie l'information  Leafnode et lui demande. Si le groupe n'existe
   pas, Leafnode cre un fichier vide nomm comme le groupe dans
   /var/spool/news/interesting.groups. Quand vous actionnez fetch la fois
   suivante, les messages du groupe sont tlchargs. Si un groupe n'a
   pas t lu depuis un certain temps, Leafnode arrtera de le
   tlcharger et supprimera son nom dans
   /var/spool/news/interesting.groups. Si vous vous abonnez  un groupe 
   fort trafic par accident, vous avez aussi la possibilit de supprimer
   ce fichier manuellement pour que vous n'ayez pas  tlcharger tous
   ses articles pour toute la semaine suivante.

   Une semaine n'est pas assez pour vous ? Vous voulez partir en vacances
   et continuer  recevoir les news ? Malheureusement il n'y a pas
   d'options dans Leafnode pour changer cela. Mais vous pouvez diter le
   fichier leafnode.h et tout recompiler. Les constantes #defined sont
   TIMEOUT_LONG et TIMEOUT_SHORT : augmentez juste le temps d'une
   seconde. Une autre solution, plus simple, est de dfinir une tche
   cron chaque nuit qui fait "touch
   /var/spool/news/interesting.groups/*".

   Si vous voulez obtenir une liste de tous les groupes de nouvelles
   disponibles sur le serveur de news qui vous alimente (par exemple
   quand vous voulez lire un nouveau groupe), il suffit de supprimer le
   fichier /var/spool/news/active.read. La commande fetch le recrera la
   fois suivante et tlchargera  nouveau la liste des groupes. Fetch
   relira galement la liste des groupes de temps en temps donc a priori
   vous n'avez pas  le faire manuellement.

6. Quel lecteur de news devrais-je utiliser ?

   Il n'y a pas "un" lecteur de news ddi  Linux, de la mme faon
   qu'il n'y a pas "un" diteur. Mon lecteur de news prfr est emacs en
   mode gnus qui est le lecteur le plus configurable de Linux. Beaucoup
   de gens utilisent slrn et tin en terminal, beaucoup de gens utilisent
   knews sous X. Il y a aussi trn, nn et encore beaucoup d'autres, si
   bien que vous pouvez essayer celui que vous voulez. Le seul lecteur
   que vous ne devriez pas utiliser est Netscape : il est gros, sans
   fonctionnalit, et de temps en temps, il cre des problmes dans les
   news. Cela dit, c'est  vous de dcider.

   N'importe comment, knews n'est pas une mauvaise ide pour une premire
   exprience car il est trs agrable  utiliser et facile  comprendre.

7. O trouver plus d'informations ?

   De la documentation est fournie dans le package Leafnode (lisez les
   fichiers INSTALL et README, les sources sont galement trs
   intressantes). Si vous voulez en savoir plus sur les "gros" serveurs
   de news plus "professionnels", lisez la FAQ de INN (elle est fournie
   dans le package INN). Pour avoir plus d'informations sur votre lecteur
   de nouvelles, tapez "man le_nom_de_votre_lecteur" ou regardez ce que
   vous pouvez trouver dans /usr/doc.

   Si vous avez des questions concernant le systme de news, demandez
   dans un groupe de nouvelles appropri (regardez dans la hirarchie
   news.software.ALL). [NdT : en France, essayez le forum modr
   fr.usenet.logiciels]. ## fr.* n'est en aucun cas une ## hirarchie
   *_franaise_*, ni ## localise sur le territoire ## franais.

   Pour toute question, correction ou tout commentaire concernant ce
   HOWTO, crivez-moi (sutok@gmx.de).

8. Remerciements

   J'aimerais remercier Michael Schulz (michaels@home.on-luebeck.de) pour
   son aide concernant les problmes de langage et Cornelius Krasel
   (krasel@wpxx02.toxi.uni-wuerzburg.de) pour ses remarques finales.
