-- HOW TO --

 

1.0 Pengaol Version 0.4x

1.1 Introduction

1.2 Auteurs

 

2.0 Installation

2.0.1 Quelle version du noyau ?

2.0.2 Est-ce que Tun/tap ou Ethertap sont installés ?

2.0.3 Comment installer Tun/tap ?

2.1 Comment dézipper l'archive ?

2.2 Quel script exécuter pour lancer l'installation ?

 

3.0 Configuration

3.1 Pengconf : lancez la configuration ?

3.2 PengAOL.conf de A à z

 

4.0 Utiliser Pengaol

4.1 Comment lancer Pengaol ?

4.2 Comment stopper Pengaol ?

4.3 Un front-end pour Pengaol ?

 

5.0 Gestion des erreurs

 

 

1.0 Pengaol Version 0.4x

Ca y est la dernière version de Pengaol est sortie ! Le challenge est de taille, mais comme d'habitude notre petit birdy nous a préparé une version plus rapide, et encore plus transportable.

 

1.1 Introduction

Pengaol est un programme développé par Birdy57, distribuable sous la licence Gnu. Pengaol permet de se connecter à Internet via un Fai de type Aol, en fournissant une passerelle ip.

Ce programme a été réalisé en reverse engineering, et n'utilise pas d'interfaces graphiques.

Le script a été développé en c, et nécessite un compilateur Gcc. Celui-ci peut être exécuté à partir du shell, ou d'une console. Il n'est pas nécessaire de recomplier le noyau de linux. Le développement de PENGAOL tend à rendre l accès convivial, sans bug, et sans timer.

 

1.2 Auteurs

L'auteur du programme se nomme Birdy57 : birdy57@multimania.com

Lawine gère les configurations : lawine@ifrance.com

Manu.D, Code34 auteurs du HOW TO : athome1@caramail.com

Le Webmaster : PENGLINUX@AOL.COM

 

2.0 Installation

Nous allons maintenant vous décrire, toutes les étapes à suivre. Nous vous conseillons de rester attentif car certaines opérations nécessitent de la rigueur. Vous devrez accomplir toute l'installation en tant que Root.

 

2.0.1 Quelle version du noyau ?

Afin de réaliser l'installation vous devez connaître la version de notre noyau linux, cela n'est pas impératif mais vous permettra de gagner un peu de temps par la suite. Nous conseillons aux utilisateurs avertis de passer directement à la section 2.0.2

Tapez la commande : uname -a

Les noyaux 2.2.x utilise généralement le module Ethertap, tandis que les noyaux 2.4.x utilise le module Tun/tap.

 

2.0.2 Est-ce que Tun/tap ou Ethertap sont installés ?

Si vous souhaitez avoir réellement la certitude que l'un des deux modules est installé, tapez ces deux commandes selon la situation :

modprobe ethertap

modprobe tun

Si les deux commandes vous renvoient une erreur... pas de chance. Ca signifie que votre distribution n'a pas de base les modules Ethertap ou Tun/Tap installés. Il est possible que pengaol marche quand même (si vous avez beaucoup de chance, c'est à lire si Ethertap ou Tun/Tap est compilé en dur dans votre noyau), mais c'est peu probable. Il faudra alors recompiler le noyau de votre linux [cf. : 2.0.3 Compiler le noyau pour installer tun/tap].

Sinon, si seul "modprobe ethertap" fonctionne, rappelez-vous que vous devez alors utiliser le mode "Ethertap". Si seul "modprobe tun" fonctionne, rappelez-vous que vous devez alors utiliser le mode "Tun/Tap". Passez maintenant à la section 2.1

 

2.0.3 Comment installer Tun/tap ?

Cette section est réservée aux personnes n'ayant pas Tun/Tap de compiler dans leurs noyaux.

Si vous ne faites pas partis de ces personnes passez directement à la section 2.1.

Malheureusement pour vous les modules Ethertap, et Tun/tap ne sont pas installés. Il faut donc recompiler le noyau. Assurez-vous tout d'abord que vous avez à votre disposition les sources de votre noyau. Pour ce faire, rendez-vous dans le répertoire et affichez son contenu en tapant les commandes:

cd /usr/src/

ls

Vous devriez avoir un répertoire du type linux-2.x.x d'afficher entrez à l intérieur. Une fois à l'intérieur contrôlez que les sources de votre noyau sont bien la, en tapant à nouveau la commande ls. Il est possible que celle ci ne soit pas installée. Si c'est le cas, il vous faudra retrouver le package contenant les sources, et l'installer en se servant d'utilitaires tel que drakconf.

Dans notre cas, nous admettons que les sources existent et se trouvent bien dans ce répertoire.

 

!!!!!!!!! Attention vous allez recompiler le noyau !!!!!!!!!

 

tapez la commande : make config ou make menuconfig

- à la question "Prompt for developpement and/or incomplete code driver", répondre Y

- à la question "Netlink device emulation", répondre Y

- à la question "Universal TUN/TAP device driver suport", répondre Y ou M (*)

- à la question "Ethertap network tap (OBSOLETE)", répondre Y ou M (*)

(*) : répondre Y si vous voulez compiler le driver en dur dans le noyau, et M si vous voulez le compiler en module. Dans ce dernier cas, n'oubliez pas de répondre aux questions "Enable loadable module support", "Set version informations on all module symbols" et "Kernel module loader".

Ensuite, éditez le fichier "/etc/modules.conf" et ajouter (si elle n'existe pas) la ligne :

alias char-major-10-200 tun

Tapez les commandes dans le répertoire des sources:

make dep

make bzlilo (ou make bzdisk pour booter sur une disquette)

make modules

make modules_install

Remarque : attention au make bzlilo avec certaines distributions. En effet, j'ai une redhat 6.2, et le fichier "/etc/lilo.conf" était configuré pour toujours démarrer avec le noyau "/boot/vmlinuz-2.2.14-5.0".

Or, quand on recompile le noyau, ce dernier est placé dans "/vmlinuz".

Si vous ne savez pas configurer lilo, ou si vous avez un doute, mieux vaut faire un "make bzdisk" et booter sur disquette (mettre alors avant une disquette vierge et formatée dans le grille pain).

créer les fichiers devices qui vont bien :

cd /dev/net

rm -f tun

mknod tun c 10 200

cd /dev

rm -f tun[0-3]

mknod tun0 c 36 0

mknod tun1 c 36 1

mknod tun2 c 36 2

mknod tun3 c 36 3

rm -f tap[0-3]

mknod tap0 c 36 16

mknod tap1 c 36 17

mknod tap2 c 36 18

mknod tap3 c 36 19

Remarque : sous un noyau 2.2.x, si vous voulez utiliser tun/tap, ce sont les commandes suivantes qu'il faudra taper :

cd /dev

rm -f tun[0-3]

mknod tun0 c 90 0

mknod tun1 c 90 1

mknod tun2 c 90 2

mknod tun3 c 90 3

Redémarrez votre ordinateur (tapez reboot par exemple)

 

2.1 Comment dézipper l'archive ?

Copiez, et dézipper l'archive dans le répertoire root par exemple

cp /cheminrepertoireousetrouvelarchive/pengaol-0.x.tar.gz /root

tar -zxvf pengaol-0.x.tar.gz

L'archive est maintenant dézippée dans le répertoire root, TAR a crée un répertoire pengaol.

 

2.2 Quel script exécuter pour lancer l'installation ?

Entrez dans le répertoire pengaol, et exécutez le script install en tapant la commande ./install

Choisissez Ethertap ou Tun/tap en fonction du module chargé par votre noyau [cf.: ci dessus]

Et choisissez install si c est votre première installation. Lors de l'installation des erreurs d'écho subsiste. Il est possible qu'en choisissant le mode Ethertap, une erreur Tun soit déclarée. Ne vous inquiétez pas cela n'a aucune incidence sur l'installation. Pengaol est maintenant installé. Passez à la partie configuration. Si vous rencontrez des erreurs [cf. 5.0].

 

3.0 Configuration

Pengaol possède un script de configuration qui permet de détecter et choisir les éléments nécessaires à la connexion PPP. Cependant, certains type de configurations ne sont pas détectées. Il vous faut dans ce cas, éditer vous-même le fichier de configuration.

 

3.1 Pengconf : lancez la configuration ?

Afin de configurer votre connexion, vous devez exécuter le script se trouvant dans le répertoire /pengconf.

 

cd /root/pengaol/pengconf

./pengconf

 

Attention : les utilisateurs ayant une souris sur un des ports série ne doivent pas lancer le script sous serveur X !!!

Le script va tenter de localiser votre modem sur les ports séries de votre machine ou en utilisant le lien modem. Il est à noter que les utilisateurs de modem interne auront sans doute plus de problèmes.

Le menu de pengconf est assez simple, répondez aux diverses questions.

Vous avez terminé de configurer votre connexion, passez maintenant à l'étape 4.0

Si vous avez rencontré des problèmes lors de la configuration, nous vous conseillons d'éditer vous-même le fichier de configuration. Pour cela, rendez-vous à l'étape 3.2

 

3.2 PengAOL.conf de A à Z

PengAol.conf est le fichier de configuration de Pengaol.

Il doit se trouver ou être crée dans le répertoire /etc . N oubliez pas d'en faire une copie, qui vous évitera de le rééditer si vous recompilez le script install. Ce fichier se compose de huit lignes qu'il faut éditer de cette façon :

Décommentez ces lignes et insérez les dans le fichier de configuration PengAOL.conf.

#le chemin d accès de votre modem ex: /dev/ttyS0

#le numéro de téléphone de la connexion ex : 0860704444 pour les connections illimitées

#votre identifiant Aol

#votre mot de passe Aol

# r c est le nom du programme a exécuter au démarrage ( netscape)

# la chaîne d initialisation de votre modem

# ATM0L0 volume du haut-parleur du modem ou ATM1L1(moyen) - ATM2L2(fort) =# E pour ethertap ou T pour Tun/tap

NB: Afin de connaître le chemin d accès de votre modem, il faut savoir sur quel port série

il est installé. Voici les diverses variantes dans les chemins d accès :

/dev/modem

/dev/ttyS0

/dev/ttyS1

/dev/ttyS2

etc ...

Si vous ne connaissez pas le vôtre, essayé déjà ces quatre la.

exemple : Fichier PengAol.conf ethertap pour l'utilisateur toto.

/dev/ttyS1

0860704444

toto

motdepassdetoto

r

ATZ

ATM0L0

E

 

Attention Pengconf version 0.49 de PengAol utilise Tun/tap par défaut.

La ligne haut-parleur du modem celle ci doit être remplacée par une chaîne init dans le cadre d'une connexion adsl, rnis.

 

4.0 Utiliser Pengaol

Maintenant, que vous en êtes arrivé à cette étape vous avez fais de plus difficile. Il ne vous reste plus qu'à apprendre les différentes commandes qui vous permettront d'utiliser agréablement Pengaol.

 

4.1 Comment lancer Pengaol ?

Pour utiliser Pengaol, il vous suffit maintenant d'exécuter le programme à partir du shell en tapant la commande pengaol sans vous soucier de l'endroit ou vous vous trouvez dans l'arborescence.

Le programme binaire se trouve dans le répertoire /usr/bin.

Maintenant le programme affiche les différentes étapes de la connexion.

Il vous renvoie votre adresse ip, celle du serveur dns, ainsi que votre nom de domaine.

 

4.2 Comment stopper Pengaol ?

Vous pouvez stopper Pengaol a tout moment, en appuyant simultanément sur <ctrl>+<c> à partir de la console ou vous avez exécuté le programme.

 

4.3 Un front-end pour Pengaol ?

Je vois que vous utilisez un serveur X, et que vous souhaitez interfacer le programme Pengaol. Pengfront est un programme développé par Zeon qui répondra à vos attentes. Facile d'utilisation, il permet d'interfacer Pengaol à partir de la version 0.49.

Ce front-end est téléchargeable à partir du site

http://www.pengfront.fr.st

 

5.0 Gestion des erreurs

Voici les erreurs les plus fréquentes, avec quelques solutions. Cette partie ne traite pas toutes les erreurs, ni les cas spécifiques.

Erreurs à la recompilation du script install : il y a de nombreuses erreurs liées à make. Installez le script mais ne le recompilez pas.

Erreurs d'init : la chaîne d'initialisation du fichier PengAOL.conf est incorrecte. Contrôlez le contenu du fichier, tester votre modem sous serveur X afin de récupérer les chaînes d'init. Tentez de lancer Pengaol sous serveur X à partir d'une console.

Pengaol ne trouve pas le fichier de configuration : vérifiez l'existence du fichier /etc/PengAOL.conf, c est peut être simplement une erreur de dénomination . Sinon, créez le [cf. 3.2].

Penconf ne détecte pas votre modem : éditez vous-même le fichier PengAOL.conf

Dans le cas d'un modem interne, n'oubliez pas de lier votre modem à dev/modem

Vous ne trouvez pas les chaînes d'init: Il existe un fichier modem.txt dans le répertoire pengconf, qui répertorie de nombreux modems.

Vous vous déconnectez régulièrement : Pengaol est encore une version bêta, et non publique. La connexion reste instable. Les connections utilisant le module Tun/tap fonctionnent mieux, et son plus stable.

Nous sommes à l'écoute de vos réflexions, et des problèmes que vous rencontrez afin d'améliorer la qualité de pengaol.