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

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:

TaulesUnSolclic2.png

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

Diagrama fluxe2.png

Creació de Fabricants

  • Llistat

Manufacturer1.png

  • Formulari

Manufacturer2.png

Creació de Models

Llistat

  • Models1b.png

Formulari

  • Models2c.png

Creació de Firmwares

Llistat

  • Firmware1b.png

Formulari

  • Firmware2b.png

Creació de Plantilles UnsolClic

Llistat

  • Unsolclic1b.png

Formulari

  • Unsolclic2b.png


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