Unsolclic
De Guifi.net - Wiki Català
Contingut
Introducció i Definició
El UnsolClic és una eina per configurar els aparells que formen part de la xarxa http://guifi.net i un dels factors clau per al seu creixement i expansió. Pren la forma d'un fitxer de text que correspòn a una sequència d'ordres escrita en el llenguatge acceptat per el aparell que utilitzem per connectar a la xarxa lliure guifi.net.
Aquest document vol descriure, des de la vessant del desenvolupament del mòdul Drupal-Guifi, tots els processos involucrats en la confecció del UnsolClic
Fortaleses i Febleses
- Fortaleses
- Aïlla a l'usuari de la configuració del trasto
- Actua com a backup de la configuració
- Fa visibles les configuraciós dels trastos per a tots els usuaris
- Dona consistencia a la xarxa
- Febleses
- Ha de generar codi en diferents llenguatges per a diferents dispositius, per tant s'ha de conèixer mímimament aquests llenguatges
- La incorporació de dispositius nous requereix aquesta codificació i porta temps.
- És genera a l'instant i no fa cache ni manté control de versions
Exemples
- Nodes Client
- Linksys WRT54GL
- Nanostation 2
- Supernodes
- Linksys WRT54GL
- RouterBoard RB433
Procés de Generació
La recepta dels tres passos per connectar
Abans de generar el UnSolClic cal que completem a la web de guifi.net la recepta dels tres passos per connectar, que ens proporcionarà tota la informació imprescindible, bàsicament
- 1. Crear un node, defineix el nom del node, la zona de la que hereta configuracions, etc...
- 2. Crear un trasto, defineix totes les propietats del nostre aparelli el firmware que executa, així com dades identificatives del nostre trasto.
- 3. Crear un enllaç, defineix quines seran les connexions del nostre node, l'adreça IP assignada i quins protocols d'enrutament s'utilitzaran
Fitxers involucrats (per ordre d'execució)
├── guifi.module : Definició de rutes ├── guifi_unsolclic.inc.php : Execució Ruta UnSolclic, preparació de dependencies, generació Unsolclic ├── guifi_includes.inc.php : Funcions diverses de guifi. ├── guifi_node.inc.php : Càrrega de la informació del node ├── guifi_devices.inc.php : Càrrega de la informació del trasto ├── guifi_radios.inc.php : Càrrega de la informació de la radio ├── guifi_interfaces.inc.php : Càrrega de la informació de les interfaces ├── guifi_ipv4.inc.php : Càrrega de la informació de les adreces ip ├── guifi_links.inc.php : Càrrega de la informació dels enllaços
Entitats involucrades
- Zona, la més específica de les diferents zones de la xarxa guifi.net on volem connectar, és a dir, que no tingui altres subzones
- Node, la ubicació concreta des d'on volem connectar.
- Trasto (device), l'aparell que utilitzarem per realitzar la connexió ( un node pot tenir més de un trasto i de diferents tipus)
- Radio , el dispositiu inalàmbric que utilitza el nostre trasto per establir una connexió física ( per enllaçar es requereix almenys una radio)
- Interface , el nom mitjançant el qual interactuem amb la radio (n'hi pot haver vàries per cada radio)
- IPV4 , cadascuna de les adreces IP que reben les interfaces.
- Enllaços (links) , cadascuna de les connexions del nostre trasto amb altres trastos propers (poden ser wireless o per cable).
- Fabricant, la casa comercial que ven el trasto
- Model, la denominació pròpia del fabricant per a determinar el trasto
- Firmware, el programari intern que executa el trasto per realitzar totes les seves funcions (pot ser propietat del Fabricant, de tercers o de Programari Lliure)
Esquema de la Base de Dades
En la segutn imatge es pot veure l'esquema de les taules de les entitats involucreades en la generació del fitxer UnSolClic:
Families de Casos actuals
Kamikaze
AirOs
GuifiStation
Mikrotik
WRT-SveaSoft
Afegir suport per a nous aparells
Idea general
Diagrama de fluxe del procés
En el següent diagrama, partint de la situació inicial que veiem a la part superior esquerra, es mostra el procés a seguir per poder generar l'UnSolclic per a un aparell nou
