Cette page recense les modifications et compléments apportés au firmware Freifunk standard, telles qu'ils sont implémentées dans le réseau de "VaourNet - Le-plateau-cordais.net". Elles se réfèrent actuellement à la version 1.6.28.

Sommaire:

---

Mode d'emploi

Installation manuelle:

1. Munissez-vous d'un client SCP tel que WinSCP ou similaire
2. Connectez-vous en SCP sur l'appareil à modifier et allez dans le répertoire des fichiers à modifier sur l'appareil distant
3. Uploadez les fichiers patchés, en remplaçant les fichiers d'origine s'ils existent
4. Ajustez les permissions pour rendre les nouveaux fichiers exécutables si besoin, selon les indications fournies ci-dessous en regard des fichiers (ex: -rwxr-xr-x)
5. Redémarrez l'appareil une fois que toutes les modifications ont été faites

Installation automatisée:

1. Connectez-vous en SSH sur l'appareil à modifier
2. Tapez "~#wget http://www.vaour.net/wiki/uploads/Freifunk/patch-vaournet.sh" pour télécharger le script d'installation des patches
3. Tapez "~#sh patch-vaournet.sh" pour exécuter le script et attendez que ça se termine
4. Redémarrez l'appareil

NB: le script détermine automatiquement ce qu'il doit faire en fonction du contexte:

1. n'applique la personnalisation de l'interface que si le SSID est "vaournet" ou "le-plateau-cordais.net"
2. n'applique les patches que pour les éléments qui sont effectivement installés sur le système

---

Personnalisation de l'interface

Concerne: tous les noeuds.

L'interface a été discrètement personnalisée sans y consacrer trop de temps. Quelques libellés ont été francisés et des commentaires expliquant comment interpréter les informations de qualité des liens ont été ajoutés en bas de la page d'état.

Version modifiée:

• /www/20-cgi-bin-map (-rw-r--r--)
• /www/cgi-bin-index.html (-rwxr-xr-x)
• /www/cgi-bin-pre.sh (-rwxr-xr-x)
• /www/cgi-bin-status.html (-rwxr-xr-x)
• /www/cgi-bin/cgi-bin-pre.sh (-rwxr-xr-x) (NB: enlever le préfixe "cgi-bin.")

Spécifique VaourNet:

• /www/images/net-logo.gif (-rwr--r--) (NB: enlever le suffixe ".vn")

Spécifique Le-Plateau-Cordais.net:

• /www/images/net-logo.gif (-rwr--r--) (NB: enlever le suffixe ".pc")

NB:

• le téléchargement depuis /dev/zero a été enlevé de l'interface dans la mesure où Netperf permet de tester la bande passante de manière plus économique, d'autant que certains utilisateurs risquent d'oublier d'arrêter le téléchargement.

Ajout de lignes optionnelles dans crontab

Concerne: tous les noeuds.

Le script s51crond d'origine n'est pas conçu pour intégrer des lignes optionnelles dans crontabs/root. Il a été légèrement modifié pour intégrer automatiquement les fichiers /etc/local.crond-*, qui peuvent ainsi rajouter les lignes dans le crontab.

Version modifiée:

• /etc/init.d/S51crond (-rwxr-xr-x)

Mise à l'heure du système

Concerne: tous les noeuds.

La fonction rdate présente quelques défauts:

1. le système n'est jamais mis à l'heure si l'accès à l'internet n'est pas opérationnel lors du démarrage, ce qui peut arriver
2. l'exactitude de l'heure dérive au fil du temps à cause de l'imperfection de l'horloge système

Pour remédier à cela, le script a été modifié:

1. laisse passer deux minutes avant de tenter de joindre les serveurs
2. ressaie toutes les 15 minutes tant que la date n'est pas établie
3. réajuste l'heure chaque jour une fois qu'une date a été obtenue

Version modifiée:

• /etc/local.cron-rdate (-rwxr-xr-x)
• /etc/init.d/S60rdate (-rwxr-xr-x)

NB: le package ntpclient présente des défauts similaires, qui devraient être corrigés de la même manière.

Redémarrage d'olsrd

Concerne: tous les noeuds.

Le script cron.minutely d'origine dispose d'une fonction qui fait redémarrer olsrd approximativement une fois par jour à un moment aléatoire, par mesure de prudence. Le fait que ça se produise à n'importe quel moment en affectant temporairement tous les paquets qui transitent par ce noeud n'est toutefois pas idéal. Pour conserver le principe en occasionnant le minimum de gêne, la fonction a été transposée dans cron.restartolsrd, afin de s'exécuter entre 00h00 et 06h00.

Le passage de cron.minutely consistant à implémenter de manière détournée des fonctions local.cron* en utilisant "trap" a été remplacé par le script S51crond modifié ci-dessus.

Version modifiée:

• /etc/local.cron-restartolsrd (-rwxr-xr-x)
• /usr/sbin/cron.minutely (-rwxr-xr-x)
• /usr/sbin/cron.restartolsrd (-rwxr-xr-x)

olsr-prio

Concerne: tous les noeuds.

Le traffic shaping a été légèrement modifié pour optimiser chaque file d'attente en fonction de ses spécificités. La bande 1 a été mise en pfifo_fast et le quantum de la bande 2 a été ajusté à la taille maxi de ses paquets (256 octets).

Version modifiée:

• /etc/init.d/S90olsr-prio (-rwxr-xr-x)

Statistiques persistantes

Concerne: tous les noeuds.

Le paquetage freifunk-statistics-fr stocke les fichiers RRD dans /tmp, ce qui fait disparaître les statistiques antérieures à chaque redémarrage de l'appareil. Pour préserver les statistiques sur une longue période, les fichiers RRD ont été déplacés dans un répertoire /rrd, dont le contenu n'est pas effacé lorsque le système est redémarré.

Version modifiée:

• /etc/rrd.conf (-rw-r--r--)
• /etc/rrdcollect.conf (-rw-r--r--)
• /etc/init.d/S98rrdcollect (-rwxr-xr-x)

NB: les statistiques peuvent éventuellement être préservées après un upgrade du firmware en transférant au préalable le contenu du répertoire /rrd sur un poste et en le reimplantant après le flashage.

wan-prio

Concerne: noeuds servant de passerelle d'accès à l'internet.

Un traffic shaping similaire à olsr-prio est implémenté sur le port WAN pour prioritiser les ACKs, les requêtes DNS et les petits paquets, et agir comme un mitigeur sur l'upload de la connexion ADSL, tout en étant beaucoup plus léger qu'une solution de type qos-scripts.

Fichier ajouté:

• /etc/init.d/S90wan-prio (-rwxr-xr-x)

freifunk-gateway-fr

Concerne: noeuds servant de passerelle d'accès à l'internet.

Correction de libellés omis dans la francisation.

Version modifiée:

• /www/60-cgi-bin-pmacct (-rw-r--r--)
• /www/cgi-bin-pmacct.html (-rwxr-xr-x)

NB: le données de comptage peuvent éventuellement être préservées après un upgrade du firmware en transférant au préalable le contenu du répertoire /backup sur un poste et en le reimplantant après le flashage.