Unsolclic: Diferència entre les revisions
De Guifi.net - Wiki Català
(Es crea la pàgina amb «= 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 cre...».) |
|||
Línia 1: | Línia 1: | ||
= Introducció i Definició = | = 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 | + | 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 | Aquest document vol descriure, des de la vessant del desenvolupament del mòdul Drupal-Guifi, tots els processos involucrats en la confecció del UnsolClic | ||
Línia 25: | Línia 25: | ||
= Procés de Generació = | = Procés de Generació = | ||
− | == Fitxers involucrats | + | |
+ | |||
+ | == 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ó) == | ||
+ | <pre> | ||
+ | ├── 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 | ||
+ | </pre> | ||
+ | |||
== Entitats involucrades == | == 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 == | == Esquema de la Base de Dades == | ||
== Families de Casos actuals == | == Families de Casos actuals == |
Revisió de 18:57, 28 set 2012
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)