News Leafsite mini-HOWTO Florian Kuehnert, sutok@gmx.de v0.3, 4 January 1998 _________________________________________________________________ _Version française 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 problèmes 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 généralement à 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 fonctionnalités que nécessaire, les choses iront mieux en installant Leafnode. Leafnode est vraiment plus simple à utiliser et est aussi très petit, mais il a quelques inconvénients : Leafnode est lent et il perd des messages dès qu'un problème se présente. C'est pourquoi vous ne devriez pas l'utiliser pour un gros serveur de news. Il est quand même approprié pour des utilisateurs privés 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é développé par un employé de Troll Tech AS, Arnt Gulbrandsen. La version la plus récente est 1.4 et dans certaines distributions (comme par exemple la Debian), Leafnode est inclus. Quoi qu'il en soit, vérifiez que vous avez au moins la version 1.4 car des bugs assez graves avaient été corrigés. 3. Comment l'installer ? Un fichier d'aide à l'installation est inclus dans le package. Mais faisons-la ensemble :-). Si une version supérieure ou égale à 1.4 de Leafnode est fournie avec votre distribution, il serait plus sage d'utiliser les binaires précompilés et de sauter les étapes 1 à 4. 1) Vérifiez 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 désinstallez INN, CNews ou tout logiciel du même type et commentez la ligne nntp dans /etc/inetd.conf. 2) Vérifiez qu'il y a un utilisateur appelé "news" : à regarder dans /etc/password. S'il n'existe pas, créez-en un ou bien tapez $ adduser news ou bien utilisez tout outil fourni avec votre distribution. 3) Décompressez la source : $ tar xfz leafnode-1.4.tar.gz et placez-vous dans le répertoire 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é-compilée 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'hôte local (localhost ou tout nom donné à votre ordinateur ; la commande hostname devrait vous aider pour cela). Si dans un des fichiers de démarrage comme /etc/profile ou ~/.bash_profile, la variable d'environnement correspondante est définie, 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 commençant par "nntp". S'il y avait une telle ligne, commentez-la en mettant un "#" au début. 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 première fois que fetch est lancé, il téléchargera une liste des groupes de nouvelles disponibles chez votre FAI. Cela peut prendre un certain temps ; ça dépend 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) Démarrez votre lecteur de news préféré (slrn, (r)tin et knews ne sont pas de mauvais points de départ) 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, même s'ils sont vides. 10) Relancez "fetch" encore une fois pour télécharger tous les articles de tous les groupes de nouvelles qui vous intéressent. 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 effacés. Le temps standard de 20 jours est bien souvent trop long si vous lisez des groupes avec un trafic conséquent ; 4 jours ou une semaine sont dans la plupart des cas un bon réglage pour votre système. 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 régler le délai d'expiration du groupe foo.bar à n jours. Ce réglage seul ne fera pas supprimer les messages par Leafnode. Un programme séparé 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 conséquence que le daemon cron déclenchera texpire chaque jour à 19:00. Reportez-vous à la page man de crontab pour d'autres réglages. Si votre ordinateur n'est pas constamment allumé, vous avez la possibilité de démarrer 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 réseau 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 crée 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 téléchargés. Si un groupe n'a pas été lu depuis un certain temps, Leafnode arrêtera de le télécharger 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 à télécharger 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 définir une tâche 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 recréera la fois suivante et téléchargera à 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 dédié à Linux, de la même façon qu'il n'y a pas "un" éditeur. Mon lecteur de news préféré 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 crée des problèmes dans les news. Cela dit, c'est à vous de décider. N'importe comment, knews n'est pas une mauvaise idée pour une première expérience car il est très agréable à 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 très intéressantes). 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 système de news, demandez dans un groupe de nouvelles approprié (regardez dans la hiérarchie news.software.ALL). [NdT : en France, essayez le forum modéré fr.usenet.logiciels]. ## fr.* n'est en aucun cas une ## hiérarchie *_française_*, ni ## localisée sur le territoire ## français. 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 problèmes de langage et Cornelius Krasel (krasel@wpxx02.toxi.uni-wuerzburg.de) pour ses remarques finales.