  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 logi
  ciel libre Leafnode.  Pour toute question, suggestion ou tout commen
  taire, 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1..  PPoouurrqquuooii uuttiilliisseerr LLeeaaffnnooddee ??

  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2..  OO ttrroouuvveerr LLeeaaffnnooddee ??

  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3..  CCoommmmeenntt ll''iinnssttaalllleerr ??

  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4..  CCoommmmeenntt mmaaiinntteenniirr lleeaaffnnooddee ??

  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5..  CCoommmmeenntt aa mmaarrcchhee ??

  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6..  QQuueell lleecctteeuurr ddee nneewwss ddeevvrraaiiss--jjee uuttiilliisseerr ??

  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7..  OO ttrroouuvveerr pplluuss dd''iinnffoorrmmaattiioonnss ??

  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8..  RReemmeerrcciieemmeennttss

  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.



















