Leafnode mini COM <author> Carles Sadurní Anguita <tt>sadurni@jazzfree.com</tt> <date> v1.0.2, 23 de juliol de 2000  <toc>  <sect> Qüestions prèvies Aquest miniCOM és la primera contribució de l'autor per a CALIU (grup d'usuaris de Linux en català). Podeu trobar-lo en la pàgina de CALIU <url url="http2//caliu.ct">. <sect1> Numeració de les versions Donem tot seguit el significat dels tres dígits m.p.q (tots tres nombres enters no negatius) amb què designem cada versió (a partir de la 1.0.0): <itemize> <item> m és el número de la versió (només canvia quan hi ha una reestructuració important del text). <item> El canvi de p denota canvis importants en leafnode (instal·lació, funcionament, interfície, etc.). <item> Les modificacions "menors" en el document (les correccions estilístiques, sintàctiques, ortogràfiques, etc. o l'aparició de noves versions del programa) s'indiquen amb el canvi de q. </itemize> <sect1> Llicència Aquest document es distribueix sota la GNU Free Documentation License. En podeu obtenir una còpia a <url url="http://www.gnu.org/copyleft/fdl.html">. <sect1> Garantia El document es distribueix sense cap mena de garantia. L'autor no és responsable dels problemes que, directament o indirectament, es puguen produir pel fet d'haver seguit aquestes instruccions. Ara bé, si hi trobeu cap error us agrairé molt que m'ho feu saber. <sect1> Referències Per a redactar el miniCOM, a part d'aprofitar els comentaris de les persones que participen en <tt>es.comp.os.linux</tt> (que durant l'estiu de 1999 va ser dividit en <tt>es.comp.os.linux.misc</tt>, <tt>es.comp.os.linux.instalacion</tt>, <tt>es.comp.os.linux.redes</tt> i <tt>es.comp.os.linux.programacion</tt>), m'he basat en els següents textos: <itemize> <item> INSTALL, README i pàgines del manual de les diverses versions de leafnode. <item> Monkiki. Configurando el sistema: las news. <url url="http://www.arrakis.es/~eb5ccf/monkiki/home.html">. <item> Santiago Romero Iglesias. ``Conexión y configuración de internet desde linux: news off-line con leafnode''. NetOnline núm. 15. Prensa Técnica, Madrid, novembre 1998. <url url="http://www.ctv.es/USERS/sromero">. <item> Florian Kuehnert. News Leafsite mini-HOWTO, v0.3, gener de 1998. </itemize> <sect1> Història <itemize> <item> Versió 0.1.0. 6 d'abril de 1999. Primera versió del document distribuïda a través de la llista de CALIU. Pendent de reescriure la introducció. <item> Versió 0.2.0. 14 d'abril de 1999. Per petició de Carles Pina, inclusió d'una breu referència al funcionament de texpire. Correcció d'algunes qüestions menors i modificació de la taula de continguts. Pendent de reescriure la introducció. <item> Versió 0.2.1. 15 d'abril de 1999. Corregits estilísticament alguns fragments. No distribuïda. <item> Versió 0.2.2. 21 d'abril de 1999. Conversió a SGML per indicació dels companys de CALIU. No distribuïda. <item> Versió 0.3.0. 24 d'abril de 1999. Indicacions per a la versió 1.9.2. Pendent de reescriure la introducció. <item> Versió 0.3.1. 11 de maig de 1999. Correccions d'estil. No distribuïda. <item> Versió 0.4.0. 19 de juliol de 1999. Modificacions per l'aparició de la versió 1.9.3. Pendent de reescriure la introducció. <item> Versió 0.4.1. 20 de juliol de 1999. Modificacions mínimes per la decisió de Cornelius Krasel, mantenidor de leafnode, de llançar la versió 1.9.4 per a resoldre el problema que presentava la 1.9.3 en la instal·lació. Lleugers retocs estilístics. <item> Versió 0.5.0. 1 d'agost de 1999. Correcció d'algunes errades lingüístiques i ampliació d'alguns punts per indicació de Joan Moratinos. Lleugers retocs estilístics. <item> Versió 0.5.1. 6 de desembre de 1999. Breus referències al pedaç per a la versió 1.9.4 (a causa de l'efecte 2000) i a l'aparició de la versió 1.9.5. Petites correccions. <item> Versió 0.5.2. 7 de desembre de 1999. De nou assistim al llançament precipitat d'una nova versió del miniCOM per la rapidíssima aparició de leafnode-1.9.6, el qual corregeix un error relativament important de l'anterior (vegeu l'arxiu CHANGES). <item> Versió 0.9.9. 29 de desembre de 1999. Llançament de l'última --tant de bo!-- versió beta del miniCOM. Ha aparegut la versió 1.9.7 de leafnode. Inclusió d'un annex sobre CALIU. <item> Versió 1.0.0. 5 de gener de 2000. Ràpid llançament de la versió 1.9.9 per a resoldre els problemes de compilació (en certs sistemes) de la 1.9.8. Canvi en el sistema de numeració de les versions del miniCOM. Supressió de "1.9.x" del títol. <item> Versió 1.0.1. 15 de febrer de 2000. Aparició de la versió 1.9.10. Retocs estilístics. <item> Versió 1.0.2. 23 de juliol de 2000. Les noves versions de leafnode s'instal·len exactament igual que les anteriors, d'ací que no hi haja hagut modificacions en el miniCOM des de fa cinc mesos. Canvi de llicència: ara el present document es distribueix sota la GNU Free Documentation Licence. <item> Versió 1.0.3. 4 de desembre de 2000. Aparició de la versió 1.9.18. Aparició de les versions "beta" de la sèrie 2.x.x de leafnode. </itemize> <sect> Introducció Leafnode converteix l'ordinador en un servidor de notícies. Quan us connecteu al servidor de notícies que us assigna el proveïdor d'accés (<tt>news.bcn.ttd.net</tt>, posem per cas), leafnode copia al disc dur tots els missatges dels grups especificats (per exemple <tt>soc.culture.catalan</tt> i <tt>es.comp.os.linux.misc</tt>); després, amb un programa client (slrn, netscape...) qualsevol usuari (per exemple la vostra germana) pot llegir les notícies i enviar-hi articles off-line. També permet aplicar filtres per evitar el tristament famós spam. Leafnode consumeix pocs recursos i pràcticament no calen tasques de manteniment. Ara bé, no ha estat concebut per a servir a 30 usuaris simultàniament, ni per a treballar amb 3000 grups de notícies. <sect> Aconseguir leafnode Leafnode forma part d'algunes distribucions de Linux; sempre, però, podeu trobar-ne l'última versió en <url url="http://www.leafnode.org">. <sect> Procés d'instal·lació Primer que tot, mireu si en el sistema hi ha un usuari anomenat news. En cas contrari, creeu-lo (si no sabeu com, escriviu <tt>man adduser</tt>). Si disposeu d'un paquet rpm o deb, instal·leu-lo de la forma habitual i passeu a l'apartat següent. Si teniu l'arxiu <tt>leafnode-1.9.x.tar.gz</tt>, descomprimiu-lo dins <tt>/tmp</tt> i seguiu les instruccions de l'arxiu INSTALL (les quals traduïm ací, amb algun comentari addicional). <sect1> Descompressió Canvieu al directori <tt>/tmp</tt> (<tt>cd tmp</tt>) i escriviu <tscreen><verb> tar -zxvf leafnode-1.9.x.tar.gz </verb></tscreen> (òbviament, caldrà especificar la ruta on es troba l'arxiu). Després d'executar tar, dins el directori <tt>/tmp</tt> trobareu un subdirectori anomenat <tt>leafnode-1.9.x</tt> amb els fitxers font i la documentació: entreu-hi (<tt>cd leafnode-1.9.x</tt>). <sect1> Nota sobre l'efecte 2000 Les versions posteriors a la 1.9.4 no pateixen l'efecte 2000. La versió 1.9.4, per contra, a partir de l'1 de gener de 2000, considerarà que tots els grups són nous; Cornelius Krasel ha posat en la pàgina de leafnode un pedaç que resol aquest problema. L'autor d'aquest document s'ha instal·lat ja la versió 1.9.14; però si decidiu continuar usant la 1.9.4, apedaceu-la: <tscreen><verb> gunzip ln.y2k.gz </verb></tscreen> col·loqueu-vos dins el directori <tt>leafnode-1.9.4</tt> (<tt>cd leafnode-1.9.4</tt>) i executeu <tscreen><verb> patch < /ruta/ln.y2k </verb></tscreen> després compileu normalment. <sect1> Compilació No patiu, el procés de compilació és molt senzill. Primer cal crear un arxiu <tt>Makefile</tt>, el qual conté la informació del sistema que cal per a compilar el programa: quin compilador teniu, on es troben determinades biblioteques, etc. Sortosament la creació del dit fitxer es realitza automàticament si executeu <tscreen><verb> ./configure </verb></tscreen> Si tot ha anat bé veureu un munt de missatges del tipus <tscreen><verb> checking <alguna cosa> </verb></tscreen> i un altre que diu <tscreen><verb> creating Makefile </verb></tscreen> Si teniu cap problema obtindreu un avís (no troba tal arxiu, el compilador és massa antic, etc.). Genereu els executables amb <tscreen><verb> make </verb></tscreen> Ja teniu els programes compilats. Si teniu la versió 1.9.8 i no podeu compilar per culpa de <tt>libpcre</tt>, feu <tt>make clean</tt>, després <tt>make dist</tt>, apedaceu-la amb l'arxiu que trobareu en <url url="http://www.leafnode.org"> i compileu normalment. També podeu instal·lar directament la 1.9.9. <sect1> Instal·lació Si instal·leu la versió 1.9.3, mireu dins el directori <tt>leafnode-1.9.3</tt>; hi ha un arxiu anomenat <tt>pcre.7</tt>, moveu-lo al subdirectori <tt>pcre</tt> i seguïu la instal·lació normalment (aquesta és la causa principal de la ràpida aparició de la versió 1.9.4). Escriviu <tscreen><verb> make install </verb></tscreen> perquè cada fitxer siga copiat en el lloc adient. En aquest cas, els executables (<tt>fetchnews</tt>, <tt>texpire</tt>, <tt>leafnode</tt>, <tt>checkgroups</tt> i <tt>applyfilter</tt>) són copiats en <tt>/usr/local/sbin</tt>; l'arxiu de configuració en <tt>/etc/leafnode/</tt> (<tt>/usr/lib/leafnode</tt> en la versió 1.9); i les pàgines del manual en <tt>/usr/local/man</tt>. No cal dir que podeu canviar la ubicació dels arxius indicant els directoris que vulgueu en el fitxer Makefile. NOTA: Fins a la versió 1.9.2 <tt>fetchnews</tt> s'anomenava <tt>fetch</tt>. Si instal·leu la versió 1.9.3 o una de superior i en teníeu qualsevol de les anteriors a la 1.9.3b5 (beta), feu <tscreen><verb> make update </verb></tscreen> <sect> Configuració mínima <sect1> Servidor Dins el directori <tt>/etc/leafnode</tt> trobareu un arxiu anomenat <tt>config.example</tt>. Copieu-lo canviant-li el nom per <tt>config</tt> (<tt>cp config.example config</tt>). Editeu <tt>config</tt>, busqueu la línia que comença amb <tscreen><verb> server= </verb></tscreen> i poseu-hi el nom del vostre servidor de notícies (per exemple <tt>news.ctv.es</tt>). Comproveu que en l'arxiu <tt>/etc/inetd.conf</tt> hi ha una línia com aquesta <verb> nntp stream tcp nowait news /usr/sbin/tcpd /usr/local/sbin/leafnode </verb> Cal fer tres observacions: <enum> <item> Entre cada parella de paràmetres heu d'inserir un tabulador (mai espais). <item> La ruta per als arxius <tt>tcpd</tt> i <tt>leafnode</tt> pot variar (els paquets rpm, per exemple, col·loquen leafnode en <tt>/usr/sbin/</tt>). <item> Encara que és possible usar leafnode sense tcpd (en aquest cas en la línia esmentada no hauria d'aparéixer <tt>/usr/sbin/tcpd</tt>), el mantenidor del programa ho desaconsella explícitament ja que pot comprometre la seguretat del sistema. </enum> Executeu <tscreen><verb> kill -HUP `cat /var/run/inetd.pid` </verb></tscreen> Aquesta ordre obliga a rellegir l'arxiu que hem modificat: el servidor de notícies ja funciona. Per tal d'evitar accessos no desitjats al vostre ordinador, afegiu a l'arxiu <tt>/etc/hosts.deny</tt> la línia següent: <tscreen><verb> leafnode: ALL EXCEPT LOCAL </verb></tscreen> Açò evita que leafnode siga accessible des d'un ordinador alié; si voleu accedir-hi des d'una altra màquina haureu d'indicar-ne la IP en <tt>/etc/hosts.allow</tt>. <sect1> Client Per tal que els lectors/clients de notícies es connecten a l'ordinador local (i no a <tt>news.mad.ttd.net</tt>, per exemple), creeu l'arxiu <tt>/etc/nntpserver</tt> i escriviu-hi <tscreen><verb> localhost </verb></tscreen> També podeu assignar el valor localhost a la variable NNTPSERVER; si utilitzeu bash és prou que afegiu aquestes dues línies en <tt>/etc/profile</tt> <tscreen><verb> NNTPSERVER = localhost export NNTPSERVER </verb></tscreen> Si voleu utilitzar Netscape com a client heu de posar <tt>localhost</tt> en <tt>Edit -> Preferences -> Mail & groups -> Groups server</tt>. Nota: Algunes versions de Netscape han donat problemes com a clients de leafnode (els quals semblen resolts en les versions més recents). <sect> Funcionament <sect1> La primera vegada Connecteu a Internet de la forma habitual i executeu <tt>fetchnews -vvv</tt> (l'opció -v indica al programa que informe de les accions que realitza; com més vv més informació dóna). La primera vegada, leafnode descarrega el nom i la descripció de cadascun dels grups que ofereix el proveïdor; per tant, en funció del nombre de grups, del mòdem i del trànsit, el procés pot durar fins una hora. Arranqueu el client (slrn, netscape...) i subscriviu-vos-hi als grups que us interessen. Si ara mireu dins el directori <tt>/var/spool/news/interesting.groups</tt> trobareu una sèrie d'arxius amb zero bytes el nom dels quals correspon al dels grups a què us heu subscrit. Si n'hi apareix cap que no heu seleccionat esborreu-lo tranquil·lament (és producte del comportament una mica especial d'alguns lectors). Torneu a executar fetchnews. El programa baixarà tots els articles dels grups a què us heu subscrit. Si tot ha anat bé, ja podeu esborrar el directori <tt>/tmp/leafnode-1.9.x</tt> (si heu instal·lat leafnode des d'un paquet .tar.gz, és clar). Simplement feu <tscreen><verb> rm -fr /tmp/leafnode-1.9.x </verb></tscreen> Ara bé, és convenient conservar l'arxiu <tt>leafnode-1.9.x.tar.gz</tt>. <sect1> Funcionament habitual A partir d'aquest moment, és prou d'executar <tt>fetchnews -v</tt> per recollir els articles nous. Cal dir, però, que leafnode només copia els missatges nous dels grups que han estat llegits en els últims dos dies; la data que utilitza per a saber-ho és la dels arxius de <tt>/var/spool/news/interesting.groups</tt>. Per tant, si heu estat uns dies sense llegir les notícies, feu (com a administrador) <tscreen><verb> touch /var/spool/news/interesting.groups/* </verb></tscreen> abans de executar fetchnews. Després de recollir els articles, el programa actualitza els arxius <tt>.overview</tt>. En les versions més antigues, en acabar, semblava que no tornava el prompt. La solució era, simplement, prémer RETURN. A partir de la versió 1.9.4 aquest detall ja està resolt. Evidentment, si no esborreu de tant en tant part dels articles omplireu el disc dur en poques setmanes (penseu que en la jerarquia <tt>es.comp.os.linux.*</tt> trobem ara per ara més de dos cents missatges nous al dia). El programa texpire s'encarrega d'esborrar els missatges que pertanyen als fils (threads) que ningú no ha llegit en els n dies anteriors. Podeu canviar el valor del paràmetre n editant l'arxiu <tt>/usr/lib/leafnode/config</tt>. Modifiqueu el valor de <tscreen><verb> expire = n </verb></tscreen> n ha de ser un nombre enter major o igual que 1. L'autor del programa recomana usar texpire en combinació amb cron. L'autor d'aquest document ho fa manualment (també amb bons resultats). <sect> Annex: el CALIU El CALIU (CAtalan LInux Users, `Grup d'usuaris de Linux en català') s'encarrega, entre altres tasques, de la traducció dels documents del LDP (Linux Documentation Project, 'Projecte de documentació de Linux'). Per a més informació, visiteu <url url="http2//caliu.ct"> o <url url="http://caliu.upc.es">. </article>