Unsolclic: Diferència entre les revisions
De Guifi.net - Wiki Català
| 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 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 [https://gitorious.org/guifi/drupal-guifi Drupal-Guifi], tots els processos involucrats en la confecció del UnsolClic |
== Fortaleses i Febleses == | == Fortaleses i Febleses == | ||
| − | * Fortaleses | + | * Fortaleses |
** Aïlla a l'usuari de la configuració del trasto | ** Aïlla a l'usuari de la configuració del trasto | ||
** Actua com a backup de la configuració | ** Actua com a backup de la configuració | ||
| Línia 19: | Línia 19: | ||
* Nodes Client | * Nodes Client | ||
** Linksys WRT54GL | ** Linksys WRT54GL | ||
| + | [[http://guifi.net/ca/guifi/device/315/view/unsolclic UnSolclic DD-Guifi] del node [http://guifi.net/ca/node/1589 Gurb Castell] | ||
** Nanostation 2 | ** Nanostation 2 | ||
| + | [http://guifilocal/ca/guifi/device/26702/view/unsolclic AirOS 2.0] del node [http://guifilocal/ca/guifi/device/26702 TRSANord80Rd1] | ||
* Supernodes | * Supernodes | ||
** Linksys WRT54GL | ** Linksys WRT54GL | ||
** RouterBoard RB433 | ** RouterBoard RB433 | ||
| + | [http://guifilocal/ca/guifi/device/30084/view/unsolclic RouterOS 4.0+] del node [http://guifilocal/ca/guifi/device/30084 TRSASocietatNord] | ||
= Procés de Generació = | = Procés de Generació = | ||
| Línia 29: | Línia 32: | ||
== La recepta dels tres passos per connectar == | == 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 | + | Abans de generar el UnSolClic cal que completem a la web de guifi.net la recepta dels [https://guifi.net/ca/connectar_a_guifi 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... | * 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. | * 2. Crear un trasto, defineix totes les propietats del nostre aparelli el firmware que executa, així com dades identificatives del nostre trasto. | ||
| Línia 75: | Línia 78: | ||
== Idea general == | == Idea general == | ||
| + | |||
| + | L'objectiu és millorar el procés d'incorporació de nous dispositius a l'aplicació actual. Mitjançant una nova gestió web i un sistema de plantilles estándard, els usuaris avançats podràn crear els configuradors 'UnSolClic' per als nous dispositius del mercat i mantenir els existents amb més facilitat i eficiència. | ||
| + | |||
== Diagrama de fluxe del procés == | == Diagrama de fluxe del procés == | ||
| Línia 82: | Línia 88: | ||
== Creació de Fabricants == | == Creació de Fabricants == | ||
| + | |||
| + | |||
| + | * Llistat | ||
| + | [[File:Manufacturer1.png]] | ||
| + | |||
| + | * Formulari | ||
| + | [[File:Manufacturer2.png]] | ||
| + | |||
== Creació de Models == | == Creació de Models == | ||
| + | |||
| + | Llistat | ||
| + | * [[File:models1b.png]] | ||
| + | |||
| + | Formulari | ||
| + | * [[File:models2c.png]] | ||
| + | |||
== Creació de Firmwares == | == Creació de Firmwares == | ||
| + | |||
| + | Llistat | ||
| + | * [[File:firmware1b.png]] | ||
| + | |||
| + | Formulari | ||
| + | * [[File:firmware2b.png]] | ||
| + | |||
== Creació de Plantilles UnsolClic == | == Creació de Plantilles UnsolClic == | ||
| + | |||
| + | Llistat | ||
| + | * [[File:unsolclic1b.png]] | ||
| + | |||
| + | Formulari | ||
| + | * [[File:unsolclic2b.png]] | ||
| + | |||
| + | |||
=== Motor de plantilles Twig === | === Motor de plantilles Twig === | ||
=== Orígens de dades === | === Orígens de dades === | ||
Revisió de 19:36, 28 set 2012
Contingut
Introducció i Definició
El UnsolClic és una eina per configurar els aparells que formen part de la xarxa 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
[UnSolclic DD-Guifi del node Gurb Castell
- Nanostation 2
AirOS 2.0 del node TRSANord80Rd1
- Supernodes
- Linksys WRT54GL
- RouterBoard RB433
RouterOS 4.0+ del node TRSASocietatNord
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
L'objectiu és millorar el procés d'incorporació de nous dispositius a l'aplicació actual. Mitjançant una nova gestió web i un sistema de plantilles estándard, els usuaris avançats podràn crear els configuradors 'UnSolClic' per als nous dispositius del mercat i mantenir els existents amb més facilitat i eficiència.
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
Creació de Fabricants
- Llistat
- Formulari
Creació de Models
Llistat
Formulari
Creació de Firmwares
Llistat
Formulari
Creació de Plantilles UnsolClic
Llistat
Formulari
