Guifi.net - Wiki Català - Contribucions de l'usuari [ca]

Unsolclic

2014-06-27T14:18:57Z

Mperezfra: /* Afegir suport per a nous aparells */

{{wikificar}}
= Introducció i Definició =

L'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 [https://gitorious.org/guifi/drupal-guifi 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óns dels trastos per a tots els usuaris
** Dóna consistència a la xarxa
* Febleses
** Ha de generar codi en diferents llenguatges per a diferents [[dispositiu]]s, per tant s'han de conèixer mínimament aquests llenguatges
** La incorporació de dispositius nous requereix aquesta codificació i porta temps.
** En la seva implementació actual es genera a l'instant i no fa [[cache]] ni manté [[control de versions
]]

== Exemples ==
* Nodes Client
** 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 : [http://guifilocal/ca/guifi/device/26702/view/unsolclic AirOS 2.0] del node [http://guifilocal/ca/guifi/device/26702 TRSANord80Rd1]
* Supernodes
** Linksys WRT54GL
** 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ó =

== La recepta dels tres passos per connectar ==

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...

[[File:Addnode1.png]]

* 2. Crear un trasto, defineix totes les propietats del nostre aparelli el firmware que executa, així com dades identificatives del nostre trasto.

[[File:Addradio1b.png]]

* 3. Crear un enllaç, defineix quines seran les connexions del nostre node, l'adreça IP assignada i quins protocols d'enrutament s'utilitzaran

[[File:Addradio3b.png]]

== 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 ==
* 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 següent imatge es pot veure l'esquema de les taules de les entitats involucreades en la generació del fitxer UnSolClic:

[[File:TaulesUnSolclic2.png]]

== Families de Casos actuals ==
Les configuracions UnSolclic existents es basen en les següents famílies de [[firmware]]s :
* [[Kamikaze]]
* [[AirOs]]
* [[GuifiStation]]
* [[RouterOS]]
* [[WRT-SveaSoft]]

TODO : Faltaria afegir altres firmwares com el de [[qMp]], etc...

Actualment, tot el codi implicat dels unsolclics es troba dins de la carpeta [https://gitorious.org/guifi/drupal-guifi/trees/master/firmware firmware], on tenim un fitxer per cadascuna de les families esmentades.
<pre>
├── firmware
│   ├── [https://gitorious.org/guifi/drupal-guifi/blobs/master/firmware/airos.inc.php airos.inc.php
│   ├── firmware-todo.inc.php
│   ├── guifistationos.inc.php
│   ├── kamikaze
│   │   ├── ar71xx
│   │   │   └── kamikaze_ap.inc.php
│   │   ├── atheros
│   │   │   ├── kamikaze_ad-hoc.inc.php
│   │   │   ├── kamikaze_ap.inc.php
│   │   │   └── kamikaze_client.inc.php
│   │   ├── broadcom
│   │   │   ├── kamikaze_ad-hoc.inc.php
│   │   │   ├── kamikaze_ap.inc.php
│   │   │   └── kamikaze_client.inc.php
│   │   └── ixp4xx
│   │   └── kamikaze_ap.inc.php
│   ├── kamikaze.inc.php
│   ├── mikrotik-routeros.inc.php
│   └── wrt-sveasoft-dd.inc.php
</pre>

== Procés Original Detallat ==
* Es crida la URL de generació del UnSolclic.
* Es carrega la ruta definida a guifi.module
<pre>
$items['guifi/device/%guifi_device/view/unsolclic'] = array(
'title' => 'unsolclic',
'page callback' => 'guifi_unsolclic',
'page arguments' => array(2),
'access callback' => 'user_access',
'access arguments' => array('access content'),
'type' => MENU_LOCAL_TASK
);
</pre>
* S'executa la funció guifi_unsolclic() del fitxer guifi_unsolclic.inc.php que rep tota la informació del device del que volem l'unsolclic
<pre>
function guifi_unsolclic($dev, $format = 'html') {
</pre>
* Es comprova que el Device tingui assignat un firmware
* Es carreguen els fitxers de la familia de firmwares corresponent
* Es comprova el firmware del trasto per cridar la funció del fitxer per aquella família.
* Es mostra per pantalla el resultat de tot el procés.

== Procés Nou Detallat ==

Continua a partir del pas tres del Procés Original

= Afegir suport per a nous aparells =

Per a poder fer aquestes accions cal el rol «Developer».

== 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

[[File:Diagrama fluxe2.png]]

== Creació de Fabricants ==

* Llistat
[[File:Manufacturer1.png]]

* Formulari
[[File:Manufacturer2.png]]

== Creació de Models ==

Llistat
* [[File:models1b.png]]

Formulari
* [[File:models2c.png]]

== Creació de Paràmetres ==

Llistat
* [[File:Params1b.png]]

Formulari
* [[File:Params2c.png]]

== Creació de Firmwares ==

Llistat
* [[File:firmware1b.png]]

Formulari
* [[File:firmware2b.png]]

== Creació de Plantilles UnsolClic ==

Llistat
* [[File:unsolclic1b.png]]

Formulari
* [[File:unsolclic2b.png]]

=== Motor de plantilles Twig ===

En la majoria de les webs actuals trobem que, per facilitar el manteniment i l'optimització de codi, es busca la manera de separar la presentació del contingut, el patró de disseny del [http://es.wikipedia.org/wiki/ModeloVistaControlador Model-Vista-Controlador] és el més utilitzat en la majoria de frameworks actuals. Així per una banda tenim les nostres dades i per l'altre un fitxer plantilla de com volem mostrar-les.

Per implementar la capa de presentació és molt útil recórrer a un motor de plantilles estàndard que ens faciliti la feina. En el nostre sistema utilitzarem [http://twig.sensiolabs.org/ Twig] per la seva potència i simplicitat.Les seves característiques principals són les següents:
* Orígen : Symfony 2 Framework - Llicència : BSD
* Substitució de variables, filtres de text i crida de funcions natives.
* Estructures de control de flux
* Inclusió de fitxers i catxé per augment de rendiment
* Herència de plantilles
* Extensions, plugins i sandbox

=== Sintaxi de Twig ===

La sintaxi de Twig s'ha pensat per ser fàcil de fer servir i ràpida. Bàsicament, una plantilla és un fitxer de text en el que hi trobem variables o expressions i etiquetes que en controlen la lògica.

Per mostrar el contingut d'una variable o expressió utilitzem la següent sintaxi :
{{ variable }}

Per utilitzar etiquetes de control, utilitzarem
{% set buffer = 'un string amb quelcom' %}

En el següent exemple de plantilla podem veure diferents exemples de la sintaxi de Twig
<pre>
{# hello comment! #}
{{ foo.bar }} {% set foo = 'foo' %}
{{ name|striptags|title }}
{% if users|length > 0 %}
<ul>
{% for user in users %}
<li>{{ user.username|e }}</li>
{% endfor %}
</ul>
{% endif %}
</pre>
A la documentació oficial de Twig podem veure [http://twig.sensiolabs.org/doc/templates.html més casos]

=== Utilització de Twig ===

Des de la banda del codi, per utilitzar Twig cal incloure la llibreria, carregar l'objecte i definir mínimament el seu comportament. A la [http://twig.sensiolabs.org/doc/api.html documentació oficial] hi podem trobar el següent fragment de codi :

<pre>
require_once '/path/to/lib/Twig/Autoloader.php';
Twig_Autoloader::register();

$loader = new Twig_Loader_Filesystem('/path/to/templates');
$twig = new Twig_Environment($loader, array(
'cache' => '/path/to/compilation_cache',
));
<pre>

Per carregar una plantilla utilitzem el següent fragment:
<pre>
$template = $twig->loadTemplate('index.html');
</pre>

i finalment per establir els valors que prendran les variables a la nostra plantilla i visualitzar-la, el següent codi :
<pre>
echo $template->render(array('the' => 'variables', 'go' => 'here'));
</pre>

=== Convencions de Guifi.net disponibles a les plantilles ===

Com podem extreure de les entitats de guifi.net la informació necessària per fer una plantilla UnSolClic?

Abans de la confecció de l'UnSolclic s'inicialitzen unes variables que contenen tota la informació de les entitats necessàries per tal que la poguem referenciar a les nostres plantilles. Aquesta informació arriba estructurada de diferents formes i hi podem accedir de dos formes:

* Amb una convenció de noms

* Jeràrquicament

=== Edició de plantilles UnSolclic ===
=== Validació de plantilles UnSolclic ===

= Plantilles UnSolclic =
== Validades ==
* Mikrotik - OmniTIK Uxx-5HnD- RouterOSv5.x
== Pendents de Validar ==
* Ubiquiti - NanoStation2 - AirOsv30
* Mikrotik -Routerboard 433 - RouterOSv4.7+
* Linksys - WRT54GL - DD-guifi (MODE AP)

== Combinacions de Model - Firmware ==

A la pràctica, com que passem a tenir una plantilla UnSolClic per cada combinació de Model / Firmware, necessitem conèixer el total de combinacions que trobem a dins de la xarxa guifi.net, per saber quantes plantilles hauriem de confeccionar.

A continuació mostrem el llistat amb totes les combinacions existents a la BD real de guifi.net a data de 15/9/2012

{|
|-
! total
! name
! model
! nom

|-
| 3818
| Ubiquiti
| NanoStation2
| AirOsv30

|-
| 2237
| Ubiquiti
| NanoStation5
| AirOsv30

|-
| 2144
| Ubiquiti
| AirMaxM5 Rocket/Nano/Loco
| AirOsv52

|-
| 1785
| Linksys
| WRT54GL
| DD-guifi

|-
| 1428
| Ubiquiti
| NanoStation2
| Freifunk-OLSR

|-
| 1319
| Ubiquiti
| NanoStation Loco5
| AirOsv30

|-
| 1247
| Ubiquiti
| AirMaxM5 Bullet/PwBrg/AirGrd/NanoBr
| AirOsv52

|-
| 1225
| Buffalo
| WHR-HP-G54, WHR-G54S
| DD-guifi

|-
| 969
| Mikrotik
| Routerboard SXT 5HnD
| RouterOSv5.x

|-
| 892
| Ubiquiti
| NanoStation Loco2
| AirOsv30

|-
| 664
| Ubiquiti
| NanoStation Loco5
| AirOsv3.6+

|-
| 441
| Ubiquiti
| AirMaxM2 Rocket/Nano/Loco
| AirOsv52

|-
| 410
| Linksys
| WRT54GL
| DD-WRTv23

|-
| 362
| Ubiquiti
| NanoStation5
| AirOsv3.6+

|-
| 361
| Other
| Other
| n/a

|-
| 297
| Mikrotik
| Routerboard SXT 5HnD
| RouterOSv4.7+

|-
| 292
| Mikrotik
| Routerboard 433
| RouterOSv4.0+

|-
| 291
| Mikrotik
| Routerboard 133C
| RouterOSv2.9

|-
| 266
| Ubiquiti
| NanoStation2
| AirOsv3.6+

|-
| 243
| Buffalo
| WHR-HP-G54, WHR-G54S
| DD-WRTv23

|-
| 242
| Mikrotik
| Routerboard 433
| RouterOSv5.x

|-
| 230
| Mikrotik
| Routerboard 600
| RouterOSv5.x

|-
| 186
| Linksys
| WRT54Gv1-4
| Alchemy

|-
| 181
| Mikrotik
| Routerboard 750/G
| RouterOSv5.x

|-
| 177
| Ubiquiti
| NanoStation5
| Freifunk-OLSR

|-
| 175
| Mikrotik
| Routerboard 433
| RouterOSv3.x

|-
| 172
| Mikrotik
| Routerboard 600
| RouterOSv3.x

|-
| 169
| Linksys
| WRT54Gv1-4
| DD-WRTv23

|-
| 162
| Ubiquiti
| AirMaxM2 Bullet/PwBrg/AirGrd/NanoBr
| AirOsv52

|-
| 160
| Mikrotik
| Routerboard 433
| RouterOSv4.7+

|-
| 124
| Ubiquiti
| NanoStation Loco2
| AirOsv3.6+

|-
| 119
| Mikrotik
| Routerboard 600
| RouterOSv4.7+

|-
| 117
| Mikrotik
| Routerboard 411
| RouterOSv5.x

|-
| 114
| Mikrotik
| Routerboard 411
| RouterOSv3.x

|-
| 112
| Mikrotik
| Routerboard 411
| RouterOSv4.7+

|-
| 112
| Mikrotik
| Routerboard 532
| RouterOSv2.9

|-
| 89
| Linksys
| WRT54Gv1-4
| DD-guifi

|-
| 79
| Mikrotik
| Routerboard 750/G
| RouterOSv4.7+

|-
| 66
| Ubiquiti
| NanoStation2
| kamikaze

|-
| 66
| Mikrotik
| Supertrasto guifiBUS guifi.net
| RouterOSv5.x

|-
| 59
| Ubiquiti
| Bullet2
| AirOsv30

|-
| 53
| Mikrotik
| Routerboard 532
| RouterOSv5.x

|-
| 46
| Mikrotik
| Routerboard 800
| RouterOSv5.x

|-
| 43
| Mikrotik
| Routerboard 133
| RouterOSv2.9

|-
| 42
| Mikrotik
| Routerboard 532
| RouterOSv4.7+

|-
| 39
| Linksys
| WRT54Gv1-4
| n/a

|-
| 39
| Ubiquiti
| NanoStation Loco2
| Freifunk-OLSR

|-
| 36
| Mikrotik
| Routerboard 493/G
| RouterOSv5.x

|-
| 32
| Ubiquiti
| RouterStation
| gsffirm

|-
| 32
| Mikrotik
| Routerboard 532
| RouterOSv3.x

|-
| 31
| Mikrotik
| Routerboard 800
| RouterOSv4.7+

|-
| 30
| Ubiquiti
| NanoStation5
| AirOsv221

|-
| 30
| Pcengines
| Alix2
| kamikaze

|-
| 29
| Mikrotik
| Routerboard 133
| RouterOSv3.x

|-
| 29
| Linksys
| WRT54GL
| whiterussian

|-
| 27
| Linksys
| WRT54GSv4
| DD-guifi

|-
| 22
| Mikrotik
| Supertrasto guifiBUS guifi.net
| RouterOSv4.7+

|-
| 21
| Linksys
| WRT54GSv4
| DD-WRTv23

|-
| 21
| Ubiquiti
| LiteStation2
| AirOsv30

|-
| 21
| Ubiquiti
| NanoStation2
| DD-WRTv23

|-
| 20
| Mikrotik
| Routerboard 133C
| RouterOSv3.x

|-
| 20
| Pcengines
| Alix2
| gsffirm

|-
| 20
| Ubiquiti
| LiteStation5
| AirOsv30

|-
| 19
| Ubiquiti
| NanoStation2
| AirOsv221

|-
| 19
| Linksys
| WRT54GL
| Freifunk-OLSR

|-
| 17
| Ubiquiti
| Bullet2
| AirOsv3.6+

|-
| 17
| Mikrotik
| OmniTIK Uxx-5HnD
| RouterOSv5.x

|-
| 17
| Ubiquiti
| NanoStation5
| DD-WRTv23

|-
| 16
| Ubiquiti
| RouterStation
| kamikaze

|-
| 15
| Linksys
| WRT54GSv1-2
| DD-guifi

|-
| 15
| Ubiquiti
| NanoStation Loco2
| kamikaze

|-
| 15
| Mikrotik
| Routerboard 333
| RouterOSv3.x

|-
| 15
| Asus
| Asus WL-500xx
| DD-WRTv23

|-
| 14
| Linksys
| WRT54GL
| kamikaze

|-
| 13
| Ubiquiti
| Bullet5
| AirOsv30

|-
| 13
| Ubiquiti
| NanoStation Loco5
| AirOsv221

|-
| 11
| Meraki
| Meraki/Fonera
| kamikaze

|-
| 11
| Mikrotik
| Routerboard 153
| RouterOSv2.9

|-
| 11
| Ubiquiti
| LiteStation2
| Freifunk-OLSR

|-
| 10
| Linksys
| WRT54Gv1-4
| kamikaze

|-
| 10
| Linksys
| WRT54GL
| DD-WRTv24preSP2

|-
| 9
| Mikrotik
| Routerboard 133
| RouterOSv4.7+

|-
| 8
| Mikrotik
| Routerboard 133C
| RouterOSv5.x

|-
| 8
| Pcengines
| Alix3
| kamikaze

|-
| 7
| Other
| Other
| DD-guifi

|-
| 7
| Mikrotik
| Routerboard 133
| RouterOSv5.x

|-
| 7
| D-Link
| DIR-600 B1/B2
| DD-WRTv24preSP2

|-
| 7
| Ubiquiti
| NanoStation Loco5
| AirOsv52

|-
| 7
| Ubiquiti
| Bullet5
| AirOsv3.6+

|-
| 7
| Ubiquiti
| AirMaxM5 Rocket/Nano/Loco
| AirOsv3.6+

|-
| 7
| Mikrotik
| Routerboard 112
| RouterOSv2.9

|-
| 7
| Mikrotik
| Routerboard 1100
| RouterOSv5.x

|-
| 6
| Setup Informatica
| GuifiStation2
| GuifiStationOS1.0

|-
| 6
| Linksys
| WRT54GL
| Talisman

|-
| 6
| Meraki
| Meraki/Fonera
| DD-WRTv24preSP2

|-
| 6
| Setup Informatica
| GuifiStation5
| GuifiStationOS1.0

|-
| 5
| Ubiquiti
| RouterStationPro
| kamikaze

|-
| 5
| Ubiquiti
| NanoStation Loco5
| kamikaze

|-
| 5
| Mikrotik
| Routerboard 800
| RouterOSv4.0+

|-
| 5
| Ubiquiti
| NanoStation Loco5
| DD-WRTv23

|-
| 5
| Ubiquiti
| NanoStation5
| kamikaze

|-
| 5
| Mikrotik
| Supertrasto guifiBUS guifi.net
| RouterOSv2.9

|-
| 4
| Linksys
| WRT54GL
| n/a

|-
| 4
| Mikrotik
| Routerboard 2011
| RouterOSv5.x

|-
| 4
| Ubiquiti
| RouterStation
| DD-WRTv23

|-
| 4
| Ubiquiti
| RouterStationPro
| gsffirm

|-
| 4
| Mikrotik
| Supertrasto guifiBUS guifi.net
| RouterOSv3.x

|-
| 4
| Linksys
| WRT54Gv1-4
| DD-WRTv24preSP2

|-
| 4
| Mikrotik
| Routerboard 133C
| RouterOSv4.7+

|-
| 4
| Other
| Other
| AirOsv30

|-
| 4
| Ubiquiti
| NanoStation2
| AirOsv52

|-
| 4
| Mikrotik
| Routerboard 532
| kamikaze

|-
| 4
| Ubiquiti
| NanoStation Loco5
| Freifunk-OLSR

|-
| 4
| Mikrotik
| Routerboard 493/G
| RouterOSv4.7+

|-
| 3
| Ubiquiti
| NanoStation5
| gsffirm

|-
| 3
| Ubiquiti
| NanoStation5
| AirOsv52

|-
| 3
| Ubiquiti
| NanoStation Loco2
| AirOsv221

|-
| 3
| Mikrotik
| Routerboard 333
| RouterOSv4.7+

|-
| 3
| Mikrotik
| Routerboard 600
| RouterOSv2.9

|-
| 3
| Ubiquiti
| AirMaxM5 Rocket/Nano/Loco
| AirOsv30

|-
| 3
| Mikrotik
| Routerboard 333
| RouterOSv5.x

|-
| 3
| Other
| Other
| Alchemy

|-
| 3
| Linksys
| WRT54GSv4
| kamikaze

|-
| 3
| Asus
| Asus WL-500xx
| kamikaze

|-
| 2
| Gateworks
| Avila GW2348-4
| kamikaze

|-
| 2
| Ubiquiti
| NanoStation Loco5
| gsffirm

|-
| 2
| Linksys
| WRT54Gv1-4
| Talisman

|-
| 2
| Asus
| Asus WL-500xx
| AirOsv52

|-
| 2
| Mikrotik
| Routerboard 750/G
| DD-guifi

|-
| 2
| Mikrotik
| Routerboard 532
| RouterOSv4.0+

|-
| 2
| Buffalo
| WHR-HP-G54, WHR-G54S
| n/a

|-
| 2
| Linksys
| WRT54GSv1-2
| kamikaze

|-
| 2
| Mikrotik
| Routerboard 1100
| RouterOSv4.7+

|-
| 2
| Ubiquiti
| RouterStationPro
| DD-WRTv23

|-
| 2
| Asus
| Asus WL-500xx
| DD-WRTv24preSP2

|-
| 2
| Linksys
| WRT54GSv1-2
| DD-WRTv23

|-
| 2
| Mikrotik
| Supertrasto guifiBUS guifi.net
| RouterOSv4.0+

|-
| 2
| Mikrotik
| Routerboard 153
| RouterOSv5.x

|-
| 2
| Other
| Other
| DD-WRTv23

|-
| 2
| Ubiquiti
| Bullet2
| Freifunk-OLSR

|-
| 2
| Linksys
| WRT54Gv1-4
| Freifunk-OLSR

|-
| 2
| Linksys
| WRT54Gv1-4
| whiterussian

|-
| 2
| Mikrotik
| Supertrasto guifiBUS guifi.net
| kamikaze

|-
| 2
| Ubiquiti
| AirMaxM5 Bullet/PwBrg/AirGrd/NanoBr
| AirOsv3.6+

|-
| 1
| Other
| Other
| DD-WRTv24preSP2

|-
| 1
| Ubiquiti
| AirMaxM2 Rocket/Nano/Loco
| AirOsv221

|-
| 1
| Asus
| Asus WL-500xx
| AirOsv221

|-
| 1
| Pcengines
| Alix1
| kamikaze

|-
| 1
| Ubiquiti
| AirMaxM2 Rocket/Nano/Loco
| RouterOSv5.x

|-
| 1
| Mikrotik
| Routerboard 153
| RouterOSv3.x

|-
| 1
| Ubiquiti
| AirMaxM5 Bullet/PwBrg/AirGrd/NanoBr
| AirOsv30

|-
| 1
| Mikrotik
| Routerboard 133C
| n/a

|-
| 1
| Ubiquiti
| NanoStation5
| RouterOSv4.0+

|-
| 1
| Ubiquiti
| LiteStation5
| Freifunk-OLSR

|-
| 1
| Mikrotik
| Routerboard 112
| RouterOSv4.7+

|-
| 1
| Ubiquiti
| NanoStation2
| RouterOSv5.x

|-
| 1
| Ubiquiti
| AirMaxM5 Bullet/PwBrg/AirGrd/NanoBr
| Freifunk-OLSR

|-
| 1
| Ubiquiti
| Bullet2
| AirOsv221

|-
| 1
| Ubiquiti
| LiteStation5
| DD-WRTv23

|-
| 1
| Tp-Link
| TL-WA7510N
| n/a

|-
| 1
| Mikrotik
| Routerboard 600
| RouterOSv4.0+

|-
| 1
| Meraki
| Meraki/Fonera
| gsffirm

|-
| 1
| Linksys
| WRT54GSv4
| DD-WRTv24preSP2

|-
| 1
| Linksys
| WRT54GL
| RouterOSv5.x

|-
| 1
| Mikrotik
| Routerboard 750/G
| AirOsv30

|-
| 1
| Linksys
| WRT54Gv1-4
| Freifunk-BATMAN

|-
| 1
| Ubiquiti
| AirMaxM2 Rocket/Nano/Loco
| DD-WRTv24preSP2

|-
| 1
| Ubiquiti
| Bullet2
| DD-WRTv23

|-
| 1
| Linksys
| WRT54GSv1-2
| DD-WRTv24preSP2

|-
| 1
| Mikrotik
| Routerboard 153
| RouterOSv4.7+

|-
| 1
| Linksys
| WRT54GSv1-2
| Alchemy

|-
| 1
| Asus
| Asus WL-500xx
| AirOsv3.6+

|-
| 1
| Mikrotik
| Routerboard 112
| RouterOSv5.x

|-
| 1
| Ubiquiti
| AirMaxM2 Bullet/PwBrg/AirGrd/NanoBr
| DD-WRTv23

|-
| 1
| Ubiquiti
| AirMaxM5 Rocket/Nano/Loco
| RouterOSv2.9

|-
| 1
| Linksys
| WRT54GSv1-2
| gsffirm

|-
| 1
| Mikrotik
| Routerboard 153
| n/a

|-
| 1
| Pcengines
| Alix3
| gsffirm

|-
| 1
| Linksys
| WRT54GL
| gsffirm

|-
| 1
| Buffalo
| WHR-HP-G54, WHR-G54S
| DD-WRTv24preSP2

|-
| 1
| Ubiquiti
| AirMaxM5 Bullet/PwBrg/AirGrd/NanoBr
| DD-WRTv24preSP2

|-
| 1
| Ubiquiti
| Bullet2
| DD-WRTv24preSP2

|-
| 1
| Ubiquiti
| AirMaxM5 Rocket/Nano/Loco
| RouterOSv5.x

|-
| 1
| Ubiquiti
| Bullet5
| DD-WRTv23

|-
| 1
| Ubiquiti
| AirMaxM5 Rocket/Nano/Loco
| DD-WRTv24preSP2

|-
| 1
| Pcengines
| Alix2
| DD-WRTv24preSP2

|-
| 1
| Ubiquiti
| NanoStation Loco2
| DD-WRTv23

|-
| 1
| Mikrotik
| Routerboard 133C
| AirOsv52

|-
| 1
| Ubiquiti
| NanoStation2
| gsffirm

|-
| 1
| Linksys
| WRT54GSv4
| Talisman

|-
| 1
| Linksys
| WRT54Gv1-4
| gsffirm

|-
| 1
| Ubiquiti
| NanoStation2
| DD-WRTv24preSP2

|}

== Total d'aparells per fabricant ==

Finalment com a curiositat un llistat del total de aparells agrupats per fabricant a data de 15/9/2012:

{|
|-
! total
! name

|-
| 15788
| Ubiquiti

|-
| 4223
| Mikrotik

|-
| 2859
| Linksys

|-
| 1471
| Buffalo

|-
| 378
| Other

|-
| 61
| Pcengines

|-
| 24
| Asus

|-
| 18
| Meraki

|-
| 12
| Setup Informatica

|-
| 7
| D-Link

|-
| 2
| Gateworks

|-
| 1
| Tp-Link

|}

Annex:subxarxes mesh

2014-06-23T13:49:47Z

Mperezfra:

{| class="wikitable sortable"
|- style="background:#ececec;"
! Abreviació de la comunitat <ref>Segons les [[convencions de noms]] s'hauria de fer servir la minúscula, en aquesta taula surten reflexades dues en alguns casos per reflexar que per motius històrics es poden trobar nodes encara amb la convenció de noms en majúscula (NOTA: S'ha d'acordar bé encara això)</ref>
! Nom de la xarxa - comunitat
! Ubicació
! [[ESSID]] comunitari
! [[firmware]]
! [[canal]]
! [[vlan]]
! IP
! Comentari
|-
| GSF - '''gsf'''
| [[Gràcia Sense Fils]]
| Vila de Gràcia al municipi de Barcelona
|
| [[gsffirm]] i [[qMp]]
| 140-
|
| 10.1.0.0/21
|
|-
| GS - '''gs'''
| [[GuifiSants]]
| Sants - Les Corts al municipi de Barcelona
|
| [[qMp]]
| 108+, 124+ i 140-
|
| 10.1.8.0/21
|
|-
| RAV - '''rav'''
| [[Mesh al Raval]]
| Barri del raval al municipi de Barcelona
| Cada node te el seu, la URL al node de guifi.net, exemple guifi.net/bcnsalvadors24
| [[qMp]]
| 136-
|
| 10.1.16.0/21
|
|-
| UPC - '''upc'''
| [[Mesh a la UPC]]
| Campus Nord de la Universitat Politècnica de Catalunya a Barcelona
|
| [[qMp]]
| 140-
|
| 10.1.24.0/21
|
|-
| HW
| [[Hospitalet Wireless]]
| Núvol de Bellvitge a la ciutat de l'Hospitalet del Llobregat
|
| [[qMp]]
| 124-
|
| 10.1.32.0/21
|
|-
| SJD - '''sjd'''
| [[Mesh a Sant Joan Despí]]
| Municipi de Sant Joan Despí a la comarca del Baix Llobregat
|
| [[qMp]]
| 140-
|
| 10.1.40.0/21
|
|-
| vllc
| [[Mesh a Vallcarca]]
| Barri de Vallcarca i els Penitents al municipi de Barcelona
|
| [[qMp]]
| 108+ i 140-
|
| 10.1.48.0/21
|
|-
| SAND - '''sand'''
| [[Mesh a Sant Andreu]]
| Barri de Sant Andreu al municipi de Barcelona
|
| [[qMp]]
| 140-
|
| 10.1.56.0/21
|
|-
| P9SF - '''p9sf'''
| [[Poblenou Sense Fils]]
| Poblenou al municipi de Barcelona
|
| [[qMp]]
| 140-
|
| 10.1.64.0/21
|
|-
| HRT
| [[Horta-Carmel]]
| Part nord del districte Horta-Guinardó al municipi de Barcelona
|
| [[qMp]]
| 140-
|
| 10.1.72.0/21
|
|-
| SCC
| [[ Mesh a Santa Coloma de Cervelló]]
| Municipi de Santa Coloma de Cervelló a la comarca del Baix Llobregat
|
| [[qMp]]
| 140-
|
| 10.1.80.0/21
|
|-
| ?
| [[Mesh al Prat]]
| Municipi de El Prat de Llobregat a la comarca de Baix Llobregat
| ?
| [[qMp]]
| ?
|
| 10.1.88.0/21
|
|-
| gll
| [[Garraf Lliure]]
| Comarca del Garraf a Barcelona
| garraflliure.guifi.net
| [[libre-mesh]]
| 11 i 36
|
| 10.1.96.0/21
|
|-
| mtj
| [[Montjuïc - Jardí Botànic]]
| Cara alta nord de Montjuïc al districte de Sants - Montjuïc a Barcelona
| jardibotanic.guifi.net
| [[libre-mesh]]
| 48
|
| 10.1.104.0/21
|
|-
| ?
| [[Mesh a Cornellà]]
| Municipi de Cornellà a la comarca de Baix Llobregat
| ?
| [[qMp]]
| ?
|
| 10.1.112.0/21
|
|-
| afrd
| Aiguafreda
|
|
| [[qMp]]
| 140-
|
| 10.1.120.0/21
|
|-
| Wales
| Mesh a Gal·les
| Nodes desplegats a Merthyr Tydfil (més info: Routek.net)
|
| [[qMp]]
| 140-
|
| 10.1.128.0/17
|
|-
| CIU
| [[Mesh a Ciutadella]]
| Ciutadella a l'illa de Menorca.
|
| [[qMp]]
| 140- i més ...?
|
| 10.2.0.0/21
|
|-
| IRU
| [[Mesh a Iruña]]
| Núvol Mesh a Iruña a Navarra
|
| [[qMp]]
| 140-
|
|style="background-color: orange;"| 10.3.0.0/21 <ref name="conflict"> '''IMPORTANT: encara hi han nodes amb IPs del rang antic que entra en conflicte amb el rang de Wales.'''</ref>
|
|-
| ?
| [[Xarxa híbrida de Castelldefels]]
| Municipi de Castelldefels a la comarca de Baix Llobregat
| ?
| [[qMp]] i [[RouterOS]]
| ?
|
| 10.10.8.0/22
| Al mateix rang s'estan fent servir modes en [[infraestructura]] amb RouterOS i nodes [[mesh]] amb qMp. La IP inicial que s'està fent servir és la [https://guifi.net/ca/node/61866 10.10.10.1/22].
|-
| Castelló de la plana
| Mesh de Castelló
| Nodes desplegats a Castelló
|
| [[qMp]]
| -
|
| 10.4.0.0/21
|-
| Benicassim
| Mesh de benicassim
| Nodes desplegats a Benicassim
|
| [[qMp]]
| -
|
| 10.4.8.0/21
|}

<references />

[[categoria:MANET]]

Annex:subxarxes mesh

2014-06-10T23:33:51Z

Mperezfra:

{| class="wikitable sortable"
|- style="background:#ececec;"
! Abreviació de la comunitat <ref>Segons les [[convencions de noms]] s'hauria de fer servir la minúscula, en aquesta taula surten reflexades dues en alguns casos per reflexar que per motius històrics es poden trobar nodes encara amb la convenció de noms en majúscula (NOTA: S'ha d'acordar bé encara això)</ref>
! Nom de la xarxa - comunitat
! Ubicació
! [[ESSID]] comunitari
! [[firmware]]
! [[canal]]
! [[vlan]]
! IP
! Comentari
|-
| GSF - '''gsf'''
| [[Gràcia Sense Fils]]
| Vila de Gràcia al municipi de Barcelona
|
| [[gsffirm]] i [[qMp]]
| 140-
|
| 10.1.0.0/21
|
|-
| GS - '''gs'''
| [[GuifiSants]]
| Sants - Les Corts al municipi de Barcelona
|
| [[qMp]]
| 108+, 124+ i 140-
|
| 10.1.8.0/21
|
|-
| RAV - '''rav'''
| [[Mesh al Raval]]
| Barri del raval al municipi de Barcelona
| Cada node te el seu, la URL al node de guifi.net, exemple guifi.net/bcnsalvadors24
| [[qMp]]
| 136-
|
| 10.1.16.0/21
|
|-
| UPC - '''upc'''
| [[Mesh a la UPC]]
| Campus Nord de la Universitat Politècnica de Catalunya a Barcelona
|
| [[qMp]]
| 140-
|
| 10.1.24.0/21
|
|-
| HW
| [[Hospitalet Wireless]]
| Núvol de Bellvitge a la ciutat de l'Hospitalet del Llobregat
|
| [[qMp]]
| 124-
|
| 10.1.32.0/21
|
|-
| SJD - '''sjd'''
| [[Mesh a Sant Joan Despí]]
| Municipi de Sant Joan Despí a la comarca del Baix Llobregat
|
| [[qMp]]
| 140-
|
| 10.1.40.0/21
|
|-
| vllc
| [[Mesh a Vallcarca]]
| Barri de Vallcarca i els Penitents al municipi de Barcelona
|
| [[qMp]]
| 108+ i 140-
|
| 10.1.48.0/21
|
|-
| SAND - '''sand'''
| [[Mesh a Sant Andreu]]
| Barri de Sant Andreu al municipi de Barcelona
|
| [[qMp]]
| 140-
|
| 10.1.56.0/21
|
|-
| P9SF - '''p9sf'''
| [[Poblenou Sense Fils]]
| Poblenou al municipi de Barcelona
|
| [[qMp]]
| 140-
|
| 10.1.64.0/21
|
|-
| HRT
| [[Horta-Carmel]]
| Part nord del districte Horta-Guinardó al municipi de Barcelona
|
| [[qMp]]
| 140-
|
| 10.1.72.0/21
|
|-
| SCC
| [[ Mesh a Santa Coloma de Cervelló]]
| Municipi de Santa Coloma de Cervelló a la comarca del Baix Llobregat
|
| [[qMp]]
| 140-
|
| 10.1.80.0/21
|
|-
| ?
| [[Mesh al Prat]]
| Municipi de El Prat de Llobregat a la comarca de Baix Llobregat
| ?
| [[qMp]]
| ?
|
| 10.1.88.0/21
|
|-
| gll
| [[Garraf Lliure]]
| Comarca del Garraf a Barcelona
| garraflliure.guifi.net
| [[libre-mesh]]
| 11 i 36
|
| 10.1.96.0/21
|
|-
| mtj
| [[Montjuïc - Jardí Botànic]]
| Cara alta nord de Montjuïc al districte de Sants - Montjuïc a Barcelona
| jardibotanic.guifi.net
| [[libre-mesh]]
| 48
|
| 10.1.104.0/21
|
|-
| ?
| [[Mesh a Cornellà]]
| Municipi de Cornellà a la comarca de Baix Llobregat
| ?
| [[qMp]]
| ?
|
| 10.1.112.0/21
|
|-
| afrd
| Aiguafreda
|
|
| [[qMp]]
| 140-
|
| 10.1.120.0/21
|
|-
| Wales
| Mesh a Gal·les
| Nodes desplegats a Merthyr Tydfil (més info: Routek.net)
|
| [[qMp]]
| 140-
|
| 10.1.128.0/17
|
|-
| CIU
| [[Mesh a Ciutadella]]
| Ciutadella a l'illa de Menorca.
|
| [[qMp]]
| 140- i més ...?
|
| 10.2.0.0/21
|
|-
| IRU
| [[Mesh a Iruña]]
| Núvol Mesh a Iruña a Navarra
|
| [[qMp]]
| 140-
|
|style="background-color: orange;"| 10.3.0.0/21 <ref name="conflict"> '''IMPORTANT: encara hi han nodes amb IPs del rang antic que entra en conflicte amb el rang de Wales.'''</ref>
|
|-
| ?
| [[Xarxa híbrida de Castelldefels]]
| Municipi de Castelldefels a la comarca de Baix Llobregat
| ?
| [[qMp]] i [[RouterOS]]
| ?
|
| 10.10.8.0/22
| Al mateix rang s'estan fent servir modes en [[infraestructura]] amb RouterOS i nodes [[mesh]] amb qMp. La IP inicial que s'està fent servir és la [https://guifi.net/ca/node/61866 10.10.10.1/22].
|-
| UJI - Castelló
| Mesh de la UJI
| Nodes desplegats a la Universitat Jaume I
|
| [[qMp]]
| -
|
| 10.91.164.0/22
|}

<references />

[[categoria:MANET]]

Servidor Proxy/ca

2012-11-06T11:58:03Z

Mperezfra:

{{Fusió|Squid}}
{{Fusió|Sortida a Internet}}

''nota: Aquest manual, basat en Debian, inclou instal·lar servidor web, webmin, sarg i webalizer''
= Proxy Manual Curt =
== Que és Guifi-proxy3? ==
Guifi-proxy3 és l'ampliació del paquet guifi-proxy, creat per en Carles Guadall, més un conjunt de configuracions per tal d'aconseguir un proxy federat-cache en el moment de finalitzar el assistent de configuració.

= Creació del servei a la web de guifi =
Prèviament haurem d'haver afegit un dispositiu tipus '''servidor''' en el nostre supernode i assigar-li una IP de guifi (dispositiu del supernode > editar > secció de connexions per cable > Rang de IPs destinat als server (es crea si no existeix) > endoll > Enllaça dispositiu > crea > Guardar y modificar.

# Crea continguts
# guifi.net service
## '''Service name:''' Servidor Proxy de XXXXXX
## '''Nom curt:''' NOMCurtSupernode-PROXY
## '''Contacte:''' mail de contacte de l'administrador
## '''Dispositiu:''' comencem a escriure el nom del nostre servidor i sortiran els noms dels servidors que comencen així
## '''Servei:''' Accés a Internet a través d'un Proxy
## '''Estat:''' Estat del servei
# Desa

Un cop desat, tornem a modificar i canviem alguns valors:

# '''Proxy Configuració:'''
## '''Descàrrega:''' Ample de banda de baixada
## '''Carregueu:''' Ample de banda de pujada
# '''Federació del proxy:'''
## '''IN''' Els usuaris d'altres proxis poden fer-lo servir
## '''OUT''' Els usuaris del proxy poden fer-ne servir d'altres
# '''Nom:''' IP o ressolució interna del proxy
# '''Port:''' Port del proxy (normalment 3128)
# '''Tipus:''' Normalment HTTP
# Desa

== Com instal·la? ==
Entrem per ssh a la màquina i afegim els repositoris d'apt de guifi:

* [[Configurar_Repositori_apt_guifi|Configurar el repositori d'apt de guifi]]

# apt-get install guifi-proxy3

'''Nota''': en el repositori ''guifi'' instal·la la versió antiga del paquet (''guifi-proxy3_0.0.1-2_all.deb''), per a intal·lar la versió nova (''guifi-proxy3_1.1.11_all.deb'') que utilitza ldap cal posar el repositori ''guifi-testing''

== Configuració del guifi-proxy3 ==
Durant el procés d'instal·lació us demanarà els següents paràmetres:
* nº del node del servidor proxy (el numero de node del servei)
* nom del servidor proxy ( display que els surt als clients que utilitzin el vostre proxy en començar a navegar )
* e-mail de contacte. És l'email que apareix a les pàgines d'error que mostra el squid
* idioma de les pàgines d'error del squid. Doncs això, depenent de l'idioma que definiu les pàgines d'error del squid surtiràn en un idioma o en un altre.
* espai del disc per emmagatzamar cache. (/var/spool/squid3)
* quantiat de memoria RAM dedicada a la cache.

En acabar aquest assistent ( hi ha valors per defecte, per si hi ha dubtes) ja tindreu un servidor proxy-cache federat a punt per ser utilitzat, si no es vol no s'ha d'afegir cap altre configuració [veure més avall].

== Com queda organitzada la configuració del squid? ==
En finalitzar l'assistent tindrem els següents fitxers:
* /etc/squid3/squid.conf [NO TOCAR/EDITAR] --> configuració estàndard
* /etc/squid3/guifi.conf [NO TOCAR/EDITAR] --> configuració generada durant el procés d'instalació del guifi-proxy3
* /etc/squid3/custom.conf --> fitxer reservat per les configuracions dels administradors dels server proxy. ( per exemple les acl que tallen megaupload i demés)

= Configuracions avançades =
== Permetre connexions serveis de missatgeria ==
# Allow AIM protocols
acl AIM_ports port 5190 9898 6667
acl AIM_domains dstdomain .oscar.aol.com .blue.aol.com .freenode.net
acl AIM_domains dstdomain .messaging.aol.com .aim.com
acl AIM_hosts dstdomain login.oscar.aol.com login.glogin.messaging.aol.com toc.oscar.aol.com irc.freenode.net
acl AIM_nets dst 64.12.0.0/255.255.0.0
acl AIM_methods method CONNECT
http_access allow AIM_methods AIM_ports AIM_nets
http_access allow AIM_methods AIM_ports AIM_hosts
http_access allow AIM_methods AIM_ports AIM_domains

# Allow Yahoo Messenger
acl YIM_ports port 5050
acl YIM_domains dstdomain .yahoo.com .yahoo.co.jp
acl YIM_hosts dstdomain scs.msg.yahoo.com cs.yahoo.co.jp
acl YIM_methods method CONNECT
http_access allow YIM_methods YIM_ports YIM_hosts
http_access allow YIM_methods YIM_ports YIM_domains

# Allow GTalk
acl GTALK_ports port 5222 5050
acl GTALK_domains dstdomain .google.com
acl GTALK_hosts dstdomain talk.google.com
acl GTALK_methods method CONNECT
http_access allow GTALK_methods GTALK_ports GTALK_hosts
http_access allow GTALK_methods GTALK_ports GTALK_domains

# Allow jabber.org
acl jabber_ports port 5222 5050
acl jabber_domains dstdomain .jabber.org .marsupi.org .guifi.net
acl jabber_hosts dstdomain hermes.jabber.org
acl jabber_methods method CONNECT
http_access allow jabber_methods jabber_ports jabber_hosts
http_access allow jabber_methods jabber_ports jabber_domains

# Allow MSN
acl MSN_ports port 1863 443 1503
acl MSN_domains dstdomain .microsoft.com .hotmail.com .live.com .msft.net .msn.com .passport.com
acl MSN_hosts dstdomain messenger.hotmail.com
acl MSN_nets dst 207.46.111.0/255.255.255.0
acl MSN_methods method CONNECT
http_access allow MSN_methods MSN_ports MSN_hosts
http_access allow MSN_methods MSN_ports MSN_domains
http_access allow MSN_methods MSN_ports MSN_nets

# Permit IRC
acl IRC_ports port 6667
acl IRC_domains dstdomain .freenode.net .guifi.net
acl IRC_hosts dstdomain irc.freenode.net
acl IRC_methods method CONNECT
http_access allow IRC_methods IRC_ports IRC_hosts
http_access allow IRC_methods IRC_ports IRC_domains

== Delay Pools Pool Relay ==
Per a dosificar les connexions al squid

[http://guifi.net/ca/node/27265 enllaç al blog d'en Josep Mercader, a la web de guifi.net]

== Proxy per a vídeos ==

http://perufw.wordpress.com/2012/04/07/instalando-haarpcache-v1-0/

== Instal·lació + webmin + sarge (Antic) ==
->Tots els paquets estan disponibles a Debian, menys el webmin. L'instal·larem des del seu repositori. Afegim la direcció del seu repositori:

echo "deb http://download.webmin.com/download/repository sarge contrib" >> /etc/apt/sources.list

->Instal·lem la clau GPG del repositori:

cd /root
wget http://www.webmin.com/jcameron-key.asc
apt-key add jcameron-key.asc

->Actual·lizem:

apt-get update

'''Instal·lem els paquets:'''

apt-get install squid sarg webmin apache2 webalizer

=== Apache: ===

->Generem un certificat:

openssl req $@ -new -x509 -days 365 -nodes -out /etc/apache2/apache.pem -keyout /etc/apache2/apache.pem

...resultat:
<pre>
Generating a 1024 bit RSA private key
.......................++++++
..++++++
writing new private key to '/etc/apache2/apache.pem'

You are about to be asked to enter information that will be incorporated
into your certificate request.
What you are about to enter is what is called a Distinguished Name or a DN.
There are quite a few fields but you can leave some blank
For some fields there will be a default value,
If you enter '.', the field will be left blank.

Country Name (2 letter code) [AU]:SP
State or Province Name (full name) [Some-State]:Regió
Locality Name (eg, city) []:Ciutat
Organization Name (eg, company) [Internet Widgits Pty Ltd]:guifi.net
Organizational Unit Name (eg, section) []:
Common Name (eg, YOUR name) []:admin
Email Address []:blabla(arroba)mail(punt)com
Srv:~#
</pre>
->Cargarem el mòdul SSL de l'Apache:

a2enmod ssl

->El reiniciarem perquè ens carregui el mòdul:

/etc/init.d/apache2 force-reload

=== Webmin: ===

->un cop tinguem instal·lat el paquet, podem accedir a la seva configuració des del navegador:

https://''ip-del-servidor'':10000/

->Accedirem amb l'usuari que tinguem al servidor. En el menú de l'esquerra anem a "Webmin - Change Language and Theme" per posar-lo a català.

=== Squid: ===

->Primer crearem un directori que ens caldrà més endavant:

mkdir /usr/etc/
touch /usr/etc/passwd

'''Programes d'autentificació:'''

->A continuació accedirem a "Servidors - Squid - Servidor Proxy - Programes de autentificació". Allà afagirem a "Programa d'autenticació bàsica", ''/usr/lib/squid/ncsa_auth /usr/etc/passwd'' i els següents valors marcats a la imatge[[http://asociacionjuvenilelcueto.info/files/user2/autenticacion_squid.png]]

Programa d'autentificació bàsica: -> /usr/lib/squid/ncsa_auth /usr/etc/passwd
Nº de programes d'autentificació: -> 5
Temps de cache d'autentificació: -> 2 hores
Pòcima d'autentificació: -> Squid proxy-caching web server

->Cliquem a "Aplicar els canvis", adalt a la dreta, per guardar.

'''Control d'accés:'''

->A "Servidors - Squid - Servidor Proxy - Control d'accés", cliquem al botó de "Crear nova ACL", amb el menú desplegable marcat amb "Autentificació Externa" i li donem el nom usuaris_autentificats.

->Ara a "Servidors - Squid - Servidor Proxy - Control d'accés", anem a la pestanya "Restriccions del proxy" i afagim una nova que permetrà els usuaris autentificats.

->Sel·leccionar "Permetre" i sel·leccionar "Usuaris Autentificats"

->És important l'ordre en què aparèixin llistades les restriccions, pel que haurem de pujar-la, amb la fletxa, per sobre de la que ho denega tot.

->Per últim, cliquem a "Aplicar canvis", a dalt a la dreta.

'''Llistar els Guifaires loguejats al proxy federat'''

->Obrir un cron amb la ordre següent:

crontab -e

3,8,13,17,28,24,28,33,39,44,49,53,57 * * * * tail -1000 /var/log/squid/access.log | awk '{print$8,"\t"}' | grep -v "-" | sort | uniq > /var/www/guifaires.txt

..ara podem llistar l'arxiu escollit: /var/www/guifaires.txt

=== Sarg: ===

->Des del webmin, podrem accedir a "Servidors - Generador d'Informes d'Anàlisis de Squid" i generar un informe per visualizar les estadístiques.

=== Federació del proxy: ===

->Per que altres usuaris de proxys federats puguin conectar-se al nostre, necessitem tenir una llista actualizada dels mateixos amb les seves contrasenyes. Per això crearem un script que ho descargui periòdicament de guifi.net mitjançant el cron. El còdig de l'script és el següent:

<pre>
#!/bin/sh
wget http://www.guifi.net/node/00000/view/federated -qO /tmp/passwd
touch /usr/etc/passwd
NEW=`diff /usr/etc/passwd /tmp/passwd|wc -l`
OK=`grep Federated /tmp/passwd|wc -l`
if [ $OK != "0" ]; then
if [ $NEW != "0" ]; then
cp /tmp/passwd /usr/etc/
/etc/init.d/squid reload
echo "Nou /usr/etc/passwd copiat"
fi;
fi
</pre>

->Hem de sustituir el "00000" pel número de nodo corresponent al nostre proxy. Ho guardem com proxypasswd.sh, li donem permisos d'execució i el copiem a una ruta dins del PATH.

chmod 755 proxypasswd.sh
mv proxypasswd.sh /usr/bin/proxypasswd.sh

->Ens queda automatizar el procés de recuperació d'usuaris, usant el cron.

crontab -e

->Ens obre un arxiu de texto on es troben les entrades dels processos periòdics del sistema. Afagim la següent línea:

54 * * * * sh /usr/bin/proxypasswd.sh

->Reiniciem el cron per que tingui en compte els canvis:

/etc/init.d/cron restart

=== Webalizer: ===

->Crearem els directoris necessaris:

mkdir /var/www/webalizer/apache
mkdir /var/www/webalizer/squid

->Configurem mitjançant webmin:

https://''ip-del-servidor'':10000/

->A "Servidors - Webalizer - Anàlisis d'Històrics (Logs)" hem d'editar dos logs clicant sobre ells:

* /var/log/apache2/access.log
Escriure informe en el directori: /var/www/webalizer/apache
Generació d'informe planificada: Habilitat, a les hores escollides a sota ..
* /var/log/squid/access.log
Escriure informe en el directori: /var/www/webalizer/squid
Generació d'informe planificada: Habilitat, a les hores escollides a sota ..

----
== referències ==
...partint d'altres experiencies i manuals com:
*[http://www.guifi.net/proxy-debian manual debian de guifi.net]
*[http://asociacionjuvenilelcueto.info/node/156 manual de l'associació Juvenil el Cueto (Rioja)]

[[es:Servidor_Proxy]]