
                               Token-Ring HOWTO

Mike Eckhoff (meckhoff@zaphod.wayne.esu1.k12.ne.us).
Version franaise et adaptation : Etienne BERNARD (eb@via.ecp.fr)
v1.0, 22 Octobre 1996

   Version 3, 5 Juillet 1995
     _________________________________________________________________

   _L'Ethernet-HOWTO fait rfrence au driver Token Ring qui est en cours
   d'criture. Ce Howto a t cr dans le but de vous aider  installer
   le patch pour le noyau et aussi essayer de mettre en vidence les
   points  surveiller. Je suggre que vous lisiez, au moins rapidement,
   ce document, avant d'essayer d'installer quelque partie que ce soit du
   driver Token Ring pour Linux._
     _________________________________________________________________

1. Introduction

1.1 Remerciements

   Remerciements  Mark Swanson, Peter De Schrijver, David Morris et
   toutes les autres personnes que j'aurais pu oublier qui ont rendu
   possible le support Token Ring pour Linux.

   Remerciements aussi  Larry Sanders (lsanders@iadfw.net) qui m'a aid
    corriger ce document.

1.2 Mise en garde

   Nous ne garantissons pas que ce Howto sera valable pour votre systme.
   De nombreuses personnes l'ont utilis avec de trs bons rsultats pour
   installer Linux sur un rseau Token Ring.

   VOUS UTILISEZ CE DOCUMENT A VOS PROPRES RISQUES ! ... Nous ne sommes
   responsables d'aucun des problmes pouvant vous arriver en utilisant
   ce Howto.

   Si vous avez un quelconque problme qui n'est pas signal dans ce
   document, envoyez moi un mail  meckhoff@zaphod.wayne.esu1.k12.ne.us.

   Ce document est copyright  1995 Michael Eckhoff. Vous pouvez faire
   des copies de ce document (en entier ou certaines portions du
   document), sur quelque support physique ou lectronique que ce soit,
   du moment que cette notice de copyright soit incluse dans chaque
   copie. Une redistribution commerciale est autorise et encourage ;
   cependant, veuillez me tenir au courant afin que je vrifie que vous
   avez la dernire version.

2. Exigences matrielles

   Vrifiez que vous avez une carte Token Ring qui est supporte par le
   driver. Jusqu' prsent, les seules cartes supportes sont celles qui
   utilisent le chipset Tropic.

   Les cartes qui sont rputes marcher sous Linux sont :

     * IBM Token Ring 16/4 Adapter ;
     * IBM Token Ring Adapter ;
     * IBM Token Ring Adapter II (4 Mgabit seulement) ;
     * Carte IBM 16/4 ISA Token Ring (16 bit) ;
     * Carte IBM 16/4 ISA Token Ring (8 bit) ;
     * 3Com TokenLink Adapter (mode IBM et 3Com) ;
     * HyperRing Classic 16/4.

   Veuillez noter qu'IBM fabrique une carte IBM Token-Ring Network 16/4
   Adapter II. Cette carte _n'est pas reconnue sous Linux_. Il ne faut
   pas la confondre avec la carte IBM Token Ring Adapter II (4mbit), qui
   elle est supporte.

   Si vous trouvez une autre carte qui fonctionne sous Linux, envoyez-moi
   un mail dcrivant la marque et le type de la carte afin que je puisse
   l'inclure dans la liste prcdente
   (meckhoff@zaphod.wayne.esu1.k12.ne.us).

3. Les logiciels requis

   Si vous utilisez une version du noyau Linux de la srie 1.3 ou
   suprieur, le support pour le Token Ring y est dj inclus.

   Sinon, je vous encourage vivement  mettre  jour votre noyau Linux
   vers un de ceux de la srie 2.0 ou suprieur.

4. Installation et configuration

   Installez la carte Token Ring dans l'ordinateur et configurez-la pour
   les rglages que vous voulez utiliser. Il est conseill de vrifier
   que la carte fonctionne sous Dos ou Windows avant d'essayer de
   l'utiliser sous Linux. Si elle marche sous Dos ou Windows, il y a de
   fortes chances pour que cela marche sous Linux.

   Configurez votre noyau Linux pour l'utilisation de la carte Token
   Ring.

cd /usr/src/linux
make config

   Rpondre ''y'' (yes)  la question :

Token Ring support (CONFIG_TR) [N/y/?]

   Ainsi qu' la question :

IBM Tropic chipset based adaptor support (CONFIG_IBMTR) [N/y/m/?] (NEW)

   Reconstruire le noyau avec les commandes :

make dep
make clean
make zImage

   Il faut ensuite reconfigurer lilo pour dmarrer sur ce nouveau noyau.
   Pour cela, il faut d'abord renommer votre noyau /vmlinuz en
   /vmlinuz.old et copier le nouveau en /vmlinuz. Sur mon systme, cela
   revient  copier /usr/src/linux/arch/i386/boot/zImage en /vmlinuz et 
   diter /etc/lilo.conf pour dmarrer sur ce noyau. N'oubliez pas de
   lancer lilo (avec la commande lilo) afin que les changements de noyau
   soient pris en compte.

   Si ce n'est pas dj fait, lancez le programme ``netconfig'' sur votre
   systme. Configurez votre machine comme si celle-ci se trouvait sur un
   rseau Ethernet.

   Editez votre fichier /etc/rc.d/rc.inet1 (ou un fichier dans
   /etc/init.d pour certaines distributions) et changez toutes les
   rfrences  eth0 en tr0. Vous devriez avoir une ligne ressemblant 

/sbin/ifconfig eth0 ${IPADDR} broadcast ${BROADCAST} netmask ${NETMASK}

   qu'il faut changer en

/sbin/ifconfig tr0 ${IPADDR} broadcast ${BROADCAST} netmask ${NETMASK}

   Vous devriez maintenant pouvoir rebooter votre systme et utiliser la
   carte Token Ring avec votre ordinateur.

5. Problmes connus

   J'ai personnellement eu quelques petits problmes avec ce driver.
   Selon Peter De Schrijver, un des problmes principaux avec ce driver
   est le routage.

From: Peter de Schrijver <Peter.DeSchrijver@linux.cc.kuleuven.ac.be>

La cause principale du problme est le routage. Si vous ne pouvez pas
atteindre un noeud du rseau situ derrire un pont,
vous avez un problme
de routage. Contactez-moi si vous rencontrez ce problme, et j'essaierai
de faire ce que je peux. Je n'ai pas moi-mme accs  un
anneau comportant
un pont, il devrait donc tre difficile de rsoudre le
problme.

Peter.

   Notre rseau, ici,  la Wayne Community Schools est constitu de deux
   anneaux et d'un rseau Ethernet dont le pont est ralis par des IBM
   8229. Je n'ai eu aucun problme de routage avec ces ponts.

   J'ai aussi test le driver sur un rseau constitu de 7 ponts, relis
   par une combinaison d'IBM 8229 et d'IBM PC utilisant le logiciel IBM.
   Aucun problme l non plus.

6. Questions

   Voici quelques questions que j'ai reues par mail  propos du Token
   Ring sous Linux.

     * Au dmarrage, j'ai le message

tr0: Can't assign device to adapter

       Lorsque c'est le seul message produit au dmarrage, cela signifie
       que la requte PIO d'information sur l'adaptateur est tellement en
       dehors de l'intervalle qu'il n'y a pas de carte  cette adresse
       d'entre-sortie (voir segment = inb(PIOaddr) dans ibmtr.c).
     * Ma carte est une Olicom 16/4 Adapter. J'ai le message suivant dans
       /var/log/messages :

May  2 10:03:14 linux kernel: tr0: Unable to assign adapter to device.
May  2 10:03:14 linux kernel: tr1: Unable to assign adapter to device.

       Cette carte ne doit pas utiliser le chipset Tropic. Essayez
       d'utiliser une des cartes de la liste du dbut du document.
     * J'ai une carte Token Ring IBM, mais j'ai les messages suivants au
       dmarrage :

May  2 16:23:07 linux kernel: tr0: PIOaddr:  a20 seg/intr: b8 mmio base:
000dc000 intr: 0
May  2 16:23:07 linux kernel: tr0: Channel ID string not found for PIOaddr:  a2
0
May  2 16:23:07 linux kernel: tr0: Expected for ISA: 5049434f3631313039393020
May  2 16:23:07 linux kernel: tr0:            found: 000902003021111000182000
May  2 16:23:07 linux kernel: tr0: Expected for MCA: 4d4152533633583435313820
May  2 16:23:07 linux kernel: tr0: Unable to assign adapter to device.
May  2 16:23:07 linux kernel: tr1: Unable to assign adapter to device.

       Ce message indique soit un conflit mmoire soit une carte Token
       Ring qui n'est pas reconnue (la signature de cette carte n'est en
       tout cas pas connue).
     * Je trouve dans mon fichier /var/log/messages des dizaines de
       lignes de ce type :

May  3 15:11:47 linux kernel: tr0: Arrg. Transmitter busy for more than 50
msec. Donald resets adapter, but resetting
May  3 15:11:47 linux kernel:  the IBM tokenring adapter takes a long time.
It might not even help when the
May  3 15:11:47 linux kernel:  ring is very busy, so we just wait a little
longer and hope for the best.

       Ces messages apparaissent lorsque j'essaye un telnet, un rlogin ou
       un ftp sur une machine distante. La connexion est alors bloque
       pendant longtemps. Certaines personnes travaillent  la correction
       de ce problme. Je mettrai  jour cette rponse lorsqu'une
       solution sera trouve.
