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

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

Families de Casos actuals

Kamikaze

AirOs

GuifiStation

Mikrotik

WRT-SveaSoft

Afegir suport per a nous aparells

Idea general

Diagrama de fluxe del procés

Creació de Fabricants

Creació de Models

Creació de Firmwares

Creació de Plantilles UnsolClic

Motor de plantilles Twig

Orígens de dades

Convencions per a les plantilles

Edició de plantilles UnSolclic

Validació de plantilles UnSolclic

Eines de l'usuari