MANUEL UTILISATEUR FIRMWARE AUTONOME REALISE PAR LES ETUDIANTS DE POLYTECH NANTES Réalisé par Florian DUPONT & Benoît FARRE
Préambule Le Firmware développé par le binôme Florian DUPONT et Benoît FARRE de l école Polytechnique de l Université de Nantes (Polytech Nantes) est placé sous licence GPL. Ce Firmware peut donc être utilisé par toute personne intéressée par celui-ci. Il est laissé le libre choix de modifier, d enrichir et de réutiliser ce Firmware. Ce manuel explique le fonctionnement et l utilisation du Firmware réalisé. Il est peut être utilisé pour plusieurs étapes comme par exemple : le flashage, le débogage, maintenance du Firmware
Sommaire Préambule... 2 Sommaire... 3 Les étapes... 4 Le matériel utilisé... 4 Les images du Firmware... 5 Flashage d un routeur avec le Firmware... 5 Pré requis... 5 Procédure... 5 Les différents cas d utilisation... 7 Configuration manuelle... 8 Configuration automatique... 8 Fichiers de Log... 8 Suppression du Firmware... 9 Contacts... 9
Les étapes L utilisation du Firmware se fait en plusieurs étapes. Elles sont énumérées ci-dessous dans l ordre chronologique : Les images du Firmware Flashage d un routeur avec le Firmware Les différents cas d utilisation (Internet ou non, des voisins ou non, ) Configuration manuelle Configuration automatique Comment voir les étapes réalisées par le Firmware (Fichier de Log) Suppression du Firmware Ces étapes sont détaillées dans les différentes parties de ce manuel. Le matériel utilisé Le routeur Wifi que nous utilisons tout au long de nos explications est le modèle WRT54GL v1.1 de chez Linksys. La figure suivante représente les ports situés au dos de l appareil. Figure 1: Image d'un routeur Linksys WRT54GL
Les images du Firmware Le Firmware est utilisable sur différents types de périphériques. La liste des routeurs compatibles est la même que celle du Firmware OpenWrt (http://openwrt.org/) car notre solution est basée sur le Firmware Kamikaze 7.09 d OpenWrt (dernière version à ce jour). Lors de la compilation du Firmware, les images suivantes sont générées : Figure 2: Listes des différentes images du Firmware Elles correspondent aux différents types de matériels que nous utilisons. Il est nécessaire de repérer quel est le modèle du point d accès avant de commencer l opération de Flashage avec une image du Firmware. Flashage d un routeur avec le Firmware Le Flashage d un routeur avec ce Firmware se fait de la même manière que le Flashage avec un Firmware OpenWrt (Kamikaze) classique. Pré requis Un PC avec un système d exploitation Linux ou MAC Avoir installé la commande TFTP sur sa machine Disposer d un câble réseau (Liaison PC-Routeur) Avoir ou non une connexion Internet (à brancher sur le port WAN) Une image du Firmware adaptée au routeur que l on veut administrer On considère à l origine le PC et le routeur éteints Procédure Relier le PC (carte réseau) au routeur Wifi (port 1 à 4 des routeurs Linksys) à l aide du câble Ethernet Allumer sa machine et se placer dans le répertoire où est située l image du Firmware Configurer un accès Internet à l aide de la commande : ifconfig eth0 192.168.1.2 netmask 255.255.255.0 Relier la connexion Internet au port Internet si vous possédez un accès. Lancer la ligne de commande suivante :
echo e binary\rexmt 1\ntimeout 60\ntrace\nput openwrtwrt54g-2.4-squashfs.bin tftp 192.168.1.1 L intitulé gras correspond à l image du Firmware prévu pour les routeurs Linksys WRT54G. Il faut utiliser une autre image du Firmware pour un routeur de modèle différent (cf. Les images du Firmware). Voici deux images représentants le début et la fin de l opération de Flashage d un point d accès. Figure 3: Lancement du transfert du Firmware Figure 4: Fin de transfert TFTP (réussi) A la fin de cette procédure, le routeur a reçu le Firmware et se configure automatiquement s il le peut. Plusieurs cas peuvent apparaître, ils sont traités dans la partie suivante.
Les différents cas d utilisation Lorsque le routeur est flashé avec le nouveau Firmware, il existe plusieurs cas possibles : Un accès Internet est disponible directement sur le routeur : Lorsque le routeur possède un accès Internet, il est autonome. Une attente de quelques minutes suffit pour que la LED Power ne clignote plus et que le routeur soit près à l emploi. (Connexion en mode Client du Wifi au réseau «Nantes-Wireless.org») Des routeurs voisins Nantes-Wireless.org possédant une connexion Internet : Le routeur sera client d un des voisins le temps de la configuration automatique du routeur. Après quelques minutes, il sera utilisable par les clients Wifi. Aucun accès Internet n est disponible pour le routeur Le routeur ne sera pas capable de communiquer avec le serveur d authentification accessible sur Internet. Il restera avec la configuration par défaut : 192.168.1.1/24. La configuration en mode manuel est détaillée dans la partie suivante. Si le routeur a redémarré et utilise le Firmware : Il dispose d un accès Internet: Le routeur va vérifier la configuration qui était faite avant le redémarrage. Cette dernière peut être : o Définitive : Le routeur vérifie qu il est enregistré sur le serveur Wifidog. Si ce n est pas le cas, il déclare la configuration comme temporaire et redémarre. Sinon il garde les configurations actuelles. o Temporaire : Le routeur tente de s enregistrer pour rendre sa configuration définitive. Si l enregistrement est effectué, le fichier de configuration (/etc/script/configuration-state) est modifié pour déclarer la configuration définitive. o Indéterminée : Le routeur est dans un état indéterminé. Le fichier /etc/config/system va être modifié pour donner un nom non conforme au réseau de l association au routeur. Le routeur est redémarré, il sera alors entièrement reconfiguré. Il ne dispose pas d un accès Internet: Le point d accès garde la configuration actuelle car il n est pas capable de vérifier la validité des informations sur le serveur Wifidog.
Configuration manuelle Le mode de configuration manuelle permet à un administrateur du point d accès de choisir le numéro qu il souhaite attribuer à son périphérique. Cette saisie s effectue via une interface Web. Il est nécessaire pour cela de démarrer un navigateur Web et d entrer l URL : http://192.168.1.1 Une page s ouvre alors et demande une authentification de l utilisateur. Pour l effectuer, il est nécessaire de connaître le mot de passe de l utilisateur «ROOT». Figure 4: Navigateur WEB - Configuration manuelle Le champ situé en dessous du titre permet à l utilisateur de saisir le numéro avec lequel le routeur sera configuré. Ce numéro doit être compris entre 0 et 255. Pour une plus grande rigueur, il est préférable que l administrateur choisisse un numéro qui n est pas actuellement utilisé sur le réseau de l association. Ainsi lorsque le routeur disposera d un accès Internet, il cherchera à s enregistrer afin de rendre sa configuration définitive. Configuration automatique Ce mode de configuration est une nouveauté par rapport au Firmware OpenWrt. Il propose la configuration autonome du routeur sans nécessité l intervention d un administrateur. Lorsqu Internet est présent, la configuration autonome est réalisée. Ce mode utilise une série de scripts qui sont dépendants les uns des autres et situés dans le répertoire /etc/script du point d accès. Fichiers de Log Les fichiers de Log sont disponibles dans le répertoire «/etc/script/log». Après le démarrage du routeur, 2 fichiers sont créés dans ce dossier.
Analyse : ce fichier permet de voir les opérations et les tests effectués par les différents scripts permettant de réaliser la configuration du routeur. Vu-scan : ce fichier permet de voir le résultat des scans du réseau effectués périodiquement dans le but de trouver des voisins et d établir des liaisons WDS avec eux. Ces deux fichiers sont réinitialisés régulièrement pour ne pas saturer l espace disque limité du routeur. Suppression du Firmware La suppression du Firmware est possible. Il suffit de flasher (cf : Flashage d un routeur) avec un autre Firmware. Aucune étape particulière pré-flashage n est requise. Contacts Pour plus d informations, vous pouvez contacter l association Nantes-Wireless via : Site Web : http://www.nantes-wireless.org Courriel : contact@nantes-wireless.org Adresse postale : Association Nantes-Wireless 66 rue Appert 44100 Nantes Le forum : http://www.nantes-wireless.org/forum Vous pouvez aussi contacter le binôme du projet par mail : Benoit.farre@etu.univ-nantes.fr Florian.dupont@etu.univ-nantes.fr