2. Installation

2.1. Les binaires RPM

Si vous ne souhaitez pas extraire et compiler les sources vous-même, les utilitaires ATM existent également sous forme de paquet RPM installable comme suit :

rpm -ivh linux-atm-x.x.x-x.rpm

2.2. L'arborescence des sources

Commencez par décompacter le paquet ATM pour Linux :

tar xzvf linux-atm-x.x.x.tar.gz

Ceci crée une arborescence de racine linux-atm-x.x.x/. On notera les répertoires suivants :

2.3. Configuration du noyau

Si vous n'avez pas l'habitude de compiler et d'installer un nouveau noyau, reportez-vous au guide pratique du noyau Linux (Linux Kernel HOWTO).

Après avoir décompacté le paquet du noyau, exécutez la commande habituelle au sommet de l'arborescence des sources du noyau : make config, make menuconfig ou make xconfig. Activez ensuite :

Prompt for development and/or incomplete code/drivers
 (CONFIG_EXPERIMENTAL)

Les options suivantes doivent apparaitre :

Asynchronous Transfer Mode (ATM, EXPERIMENTAL) (CONFIG_ATM)
 Use "new" skb structure (CONFIG_ATM_SKB)
 Classical IP over ATM (CONFIG_ATM_CLIP)
 Do NOT send ICMP if no neighbour (CONFIG_ATM_CLIP_NO_ICMP)
 LAN Emulation (LANE) support (CONFIG_ATM_LANE)
 Multi-Protocol Over ATM (MPOA) support (CONFIG_ATM_MPOA)
ATM over TCP (CONFIG_ATM_TCP)
Efficient Networks ENI155P (CONFIG_ATM_ENI)
 Enable extended debugging (CONFIG_ATM_ENI_DEBUG)
 Fine-tune burst settings (CONFIG_ATM_ENI_TUNE_BURST)
 Enable 16W TX bursts (discouraged) (CONFIG_ATM_ENI_BURST_TX_16W)
 Enable 8W TX bursts (recommended) (CONFIG_ATM_ENI_BURST_TX_8W)
 Enable 4W TX bursts (optional) (CONFIG_ATM_ENI_BURST_TX_4W)
 Enable 2W TX bursts (optional) (CONFIG_ATM_ENI_BURST_TX_2W)
 Enable 16W RX bursts (discouraged) (CONFIG_ATM_ENI_BURST_RX_16W)
 Enable 8W RX bursts (discouraged) (CONFIG_ATM_ENI_BURST_RX_8W)
 Enable 4W RX bursts (recommended) (CONFIG_ATM_ENI_BURST_RX_4W)
 Enable 2W RX bursts (optional) (CONFIG_ATM_ENI_BURST_RX_2W)
ZeitNet ZN1221/ZN1225 (CONFIG_ATM_ZATM)
 Enable extended debugging (CONFIG_ATM_ZATM_DEBUG)
 Enable usec resolution timestamps (CONFIG_ATM_ZATM_EXACT_TS)
IDT 77201 (NICStAR) (CONFIG_ATM_NICSTAR)
 Use suni PHY driver (155Mbps) (CONFIG_ATM_NICSTAR_USE_SUNI)
 Use IDT77015 PHY driver (25Mbps) (CONFIG_ATM_NICSTAR_USE_IDT77105)
Madge Ambassador (Collage PCI 155 Server) (CONFIG_ATM_AMBASSADOR)
 Enable debugging messages (CONFIG_ATM_AMBASSADOR_DEBUG)
Madge Horizon [Ultra] (Collage PCI 25 and Collage PCI 155 Client)
 Enable debugging messages (CONFIG_ATM_HORIZON_DEBUG)
Interphase ATM PCI x575/x525/x531 (CONFIG_ATM_IA)
 Enable debugging messages (CONFIG_ATM_IA_DEBUG)

Les paramètres « burst » du gestionnaire ENI sont ajustables. Les modifier peut s'avérer nécessaire si le positionnement par défaut provoque des épuisements de tampons mémoire lors des transferts PCI. On se reportera à la documentation en ligne relative à « CONFIG_ATM_ENI_TUNE_BURST » pour une explication détaillée de l'impact de ce paramètre.

Le fichier drivers/atm/nicstar.h contient les variables sur lesquelles on peut jouer pour le pilote IDT 77201.

Les gestionnaires peuvent être employés avec certaines cartes compatibles. La référence la plus à jour pour ces dernières se trouve sur la page d'information relative à ATM on Linux.

Recompilez ensuite le noyau et redémarrez.

2.4. Messages des gestionnaires de périphériques

Si vous avez activé le pilote ENI155p-MF, deux lignes semblables aux suivantes devraient apparaître (512kB pour la version -C, 2048kB pour la version -S) :

eni(itf 0): rev.0,base=0xff400000,irq=10,mem=512kB (00-20-EA-00-07-56)
eni(itf 0): FPGA,MMF

Si vous avez activé le pilote ZN1221 / ZN1225, il apparaît des messages du genre :

zatm(itf 0): rev.3,base=0xf800,irq=11,mem=128kB,MMF (00-20-D4-10-2A-80)
zatm(itf 0): uPD98401 0.5 at 30.024 MHz
zatm(itf 0): 16 shapers, 32 pools, 2048 RX, 3958 VCs

Notez qu'une carte de révision 3 ou plus est nécessaire pour une carte-mère équipée d'un jeu de composants Triton.

Si vous n'avez activé que le pilote ATM au-dessus de TCP, aucun message n'apparaît au démarrage parce que les périphériques correspondants ne sont créés qu'au moment de l'invocation de la commande atmtcp.

2.5. Débogage mémoire

Si on désire analyser d'éventuels problèmes relatifs aux allocations mémoire, il est nécessaire d'installer MPR avant de compiler les outils ATM.

Si vous récupérez un paquet RPM binaire, MPR s'installe comme suit :

rpm -ivh mpr-x.x-x.rpm

Si vous partez des sources, décompactez mpr-x.x.tar.gz ainsi :

tar xzvf mpr-x.x.tar.gz

Puis exécutez les commandes suivantes :

cd mpr-x.x
./configure x86-linux
make
make install

Une détection automatique de certains usages erronés des fonctions malloc et free aura alors lieu automatiquement si les utilitaires ont été compilés après installation de MPR. Le suivi des allocations est activé en positionnant MPRPC et MPRFI. Reportez-vous aux fichiers doc/mpr.html et doc/mpr.ps dans le paquet MPR pour davantage de détails.

Bien que le débogage des allocations n'implique qu'un léger surcoût à l'exécution, ces variables d'environnement ne sont pas positionnées par défaut.

2.6. Utilitaires ATM

Pour finir, configurez et compilez les outils ATM. La configuration n'est requise que si votre commutateur utilise UNI 3.1 ou 4.0 ou s'il présente certains dysfonctionnements. Les options de configuration sont activées par passage au script ./configure du paquet linux-atm.

Exécutez ./configure --help à partir de la racine de l'arborescence linux-atm pour visualiser toutes les options disponibles.

Les commandes suivantes compilent les utilitaires ATM :

cd linux-atm-x.x.x
./configure
make
make install

Sauf spécification particulière lors de l'invocation de la commande ./configure, make install installera les exécutables dans les répertoires /usr/local/bin et /usr/local/sbin. À l'exception du fichier hosts.atm (qui est installé dans le répertoire /etc), les fichiers de configuration se situeront en /usr/local/etc. Les bibliothèques et les fichiers d'en-tête sont respectivement copiés dans /usr/local/lib et /usr/local/include. Les pages de manuel se retrouvent dans /usr/local/man.

2.7. Paquets supplémentaires

Certains programmes reposent sur des paquets de grande taille qui ne sont pas contrôlés par linux-atm. Pour d'autres, des patches sont fournis dans le paquet ATM-Linux. Ils se trouvent dans le répertoire src/extra de la distribution ATM-Linux.

Les paquets suivants sont disponibles :

Notez que text2atm emploie automatiquement ANS s'il est disponible, et que celui-ci ne doit dès lors être installé que sur les systèmes qui fournissent le service de résolution de noms ou lorsque des outils de maintenance au fait d'ATM sont requis (nslookup, …).

Le script hosts2ans.pl dans le répertoire src/extra/ANS/ convertit un fichier /etc/hosts.atm en un fichier de zone ANS. Son utilisation est décrite en tête de fichier.