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

Annex:subxarxes mesh

2018-02-07T14:52:16Z

Rogerpueyo:

{| 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]]
! [[binari concret]]
! [[canal]] <ref name="canals">'''IMPORTANT++: els canals WiFi de 40 MHz han de seguir l'estàndar, pel que el 140- no és vàlid i S'HA DE CANVIAR a totes les zones'''</ref> <ref>Missatge a les llistes sobre els canals incorrectes: https://llistes.guifi.net/sympa/arc/guifi-mesh/2015-01/msg00000.html</ref>
! [[BSSID (adhoc)]]
! [[Mesh id (802.11s)]]
! [[vlan]]
! IPv4
! IPv6
! [[BMX6]] versió
! URL del Mapa o llistat dels nodes
! Comentari
|-
| GSF - '''BCNgsf'''
| [[Gràcia Sense Fils]]
| Vila de Gràcia al municipi de Barcelona
|
| [[gsffirm]] i [[qMp]]
|
| 140- old 149+
| 02:CA:FF:EE:BA:BE
|
|
| 10.1.0.0/21
|
|
|
|
|-
| GS - gs - '''BCNsants''' <ref name="Sants">Es suggereix fer servir <code>BCNsants</code> en comptes de <code>gs</code> perquè <code>gs</code> és també el començament de l'abreviació de Gràcia SenseFils, així, quan un nom de carrer d'un node de Gràcia SenseFils comença per "f" resulta confús al mirar-los al mateix llistat de survey o similar.</ref>
| [[GuifiSants]]
| Sants - Les Corts al municipi de Barcelona
|
| [[qMp]]
|
| 48+, 52+, 60+, 100+, 108+, i 140
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.8.0/21 i 10.2.8.0/21
|
|
|
|
|-
| RAV - '''BCNrav'''
| [[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-
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.16.0/21
|
|
|
|
|-
| UPC - '''BCNupc'''
| [[Mesh a la UPC]]
| Campus Nord de la Universitat Politècnica de Catalunya a Barcelona
|
| [[qMp]]
|
| 136-
| 02:CA:FF:EE:BA:BE
|
|
| 10.1.24.0/21
|
|
|
|
|-
| HW
| [[Hospitalet Wireless]]
| Núvol de Bellvitge a la ciutat de l'Hospitalet del Llobregat
|
| [[qMp]]
|
| 108+
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.32.0/21
|
|
|
|
|-
| SJD - '''BCNsjd'''
| [http://www.guifibaix.coop Mesh a Sant Joan Despí]
| Municipi de Sant Joan Despí a la comarca del Baix Llobregat
|
| [[qMp]]
|
| 136-
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.40.0/21
|
| BMX6-0.1-alpha comPatibility=16 revision=8f26909e8808ed7fab0359afc15a3e44563fbd40 (revision=4d3819b255540915408b827ae03fd92cbd7b4bdd old nodes)
| http://map.guifibaix.coop
|
|-
| vllc - BCNvkk
| [[Mesh a Vallcarca]]
| Barri de Vallcarca i els Penitents al municipi de Barcelona
|
| [[qMp]]
|
| 108+ i 140-
| 02:CA:FF:EE:BA:BE
|
|
| 10.1.48.0/21
|
|
|
|
|-
| SAND - '''BCNsand'''
| [[Mesh a Sant Andreu]]
| Barri de Sant Andreu al municipi de Barcelona
|
| [[qMp]]
|
| 132+ i 120-
| 02:CA:FF:EE:BA:BE
|
|
| 10.1.56.0/21
|
|
|
|
|-
| P9SF - '''BCNp9sf'''
| [[Poblenou Sense Fils]]
| Poblenou al municipi de Barcelona
|
| [[qMp]]
|
| 140- old 132+ base 124+ alt
| 02:CA:FF:EE:BA:BE
|
|
| 10.1.64.0/21
|
|
|
|
|-
| BCNhctm
| [[Horta-Carmel-Montbau-Teixonera]]
| Part nord del districte Horta-Guinardó al municipi de Barcelona
|
| [[qMp]]
|
| 149+
| 02:CA:FF:EE:BA:BE
|
|
| 10.1.72.0/21
|
|
|
|
|-
| SCC
| [http://www.guifibaix.coop Mesh a Santa Coloma de Cervelló]
| Municipi de Santa Coloma de Cervelló a la comarca del Baix Llobregat
|
| [[qMp]]
|
| 140-
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.80.0/21
|
| BMX6-0.1-alpha comPatibility=16 revision=4d3819b255540915408b827ae03fd92cbd7b4bdd
| http://map.guifibaix.coop
|
|-
| SCLL
| [http://www.guifibaix.coop Mesh a Sant Climent de Llobregat]
| Municipi de Sant Climent de Llobregat a la comarca de Baix Llobregat
|
| [[qMp]]
|
| 140-
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.144.0/21
|
| BMX6-0.1-alpha comPatibility=16 revision=4d3819b255540915408b827ae03fd92cbd7b4bdd
| http://map.guifibaix.coop
|
|-
| PRLL
| [http://www.guifibaix.coop Mesh al Prat]
| Municipi de El Prat de Llobregat a la comarca de Baix Llobregat
|
| [[qMp]]
|
| 136-
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.88.0/21
|
| BMX6-0.1-alpha comPatibility=16 revision=8f26909e8808ed7fab0359afc15a3e44563fbd40
| http://map.guifibaix.coop
|
|-
| gll
| [[Garraf Lliure]]
| Comarca del Garraf a Barcelona
| garraflliure.integral.guifi.net
| [[libre-mesh]]
|
| 11 i 48
| CA:FE:00:C0:FF:EE
|
| 245
| 10.1.96.0/21
|
|
|
|
|-
| BCNmtj
| [[Montjuïc]]
| Cara alta nord de Montjuïc al districte de Sants - Montjuïc a Barcelona
| jardibotanic.integral.guifi.net
| [[libre-mesh]]
|
| 48
|
|
| 11
| 10.1.104.0/21
| 2a00:1508:1:f000 o 2a00:1508:1:fe4c::/64
|
|
|
|-
| CRNLL
| [http://www.guifibaix.coop Mesh a Cornellà]
| Municipi de Cornellà a la comarca de Baix Llobregat
|
| [[qMp]]
|
| 136-
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.112.0/21
|
| BMX6-0.1-alpha comPatibility=16 revision=8f26909e8808ed7fab0359afc15a3e44563fbd40
| http://map.guifibaix.coop
|
|-
| afrd
| Aiguafreda
|
|
| [[qMp]]
|
| 140-
| 02:CA:FF:EE:BA:BE
|
|
| 10.1.120.0/21
|
|
|
|
|-
| Wales
| [http://www.digitalmerthyr.org.uk Digital Merthyr]
| Nodes desplegats a Merthyr Tydfil (més info: Routek.net)
|
| [[qMp]]
|
| 140-
| 02:CA:FF:EE:BA:BE
|
|
| 10.1.128.0/20, 10.1.224.0/21, 10.92.2.0/24
|
|
|
|
|-
| CIU
| [[Mesh a Ciutadella]]
| Ciutadella a l'illa de Menorca.
|
| [[qMp]]
|
| 140- i més ...?
| 02:CA:FF:EE:BA:BE
|
|
| 10.2.0.0/21
|
|
|
|
|-
| IRU
| [[Mesh a Iruña]]
| Iruña a Navarra
|
| [[qMp]]
|
| 140-
| 02:CA:FF:EE:BA:BE
|
|
|style="background-color: orange;"| 10.3.0.0/21 <ref name="conflict"> '''IMPORTANT: encara hi ha 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]]
|
| ?
| 02:CA:FF:EE:BA:BE
|
|
| 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].
|-
| ?
| [[Mesh de Castelló]]
| Ciutat de Castelló al País Valencià
|
| [[qMp]]
|
| -
| 02:CA:FF:EE:BA:BE
|
|
| 10.4.0.0/21
|
|
|
|
|-
| ?
| [[Mesh de Benicàssim]]
| Ciutat de Benicàssim a la província de Castelló, País Valencià
|
| [[qMp]]
|
| -
| 02:CA:FF:EE:BA:BE
|
|
| 10.4.8.0/21
|
|
|
|
|-
| ?
| [[Xarxa Veïnal dels barris valencians]]
| Barri del Cabanyal i altres a la ciutat de Valencia
|
| [[libre-mesh]]
|
| -
|
|
|
| 10.5.0.0/21
|
|
|
|
|-
| sn
| [[Sierra Libre]]
| Región de la Sierra Norte, en el Estado de Oaxaca, México
| sierralibre.guifi.net
| [[libre-mesh]]
|
|
|
|
|
| 10.72.8.0/21
|
|
|
|
|-
| SFCM
| Mesh a Sant Feliu de Codines
| Sant Feliu de Codines, Valles Oriental, BCN
|
| [[qMp]]
|
|
| 02:CA:FF:EE:BA:BE
|
|
| 10.91.176.0/22
|
|
|
|
|-
| BCNeixD
| [[Eixample Dret]]
| Barri de l'Eixample Dret a Barcelona
|
| [[libre-mesh]]
|
| 9 i 140
|
|
| 11
| 10.1.152.0/21
| 2a00:1508:1:f017::/64 2a00:1508:1:f018::/64 2a00:1508:1:f019::/64
|
|
|
|-
| VLDC
| [http://www.guifibaix.coop Mesh a Viladecans]
| Municipi de Viladecans de Baix Llobregat
|
| [[qMp]]
|
| 136-
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.168.0/21
|
| BMX6-0.1-alpha comPatibility=16 revision=8b0585e84ca8a0110bd4587e19192beda1ba3238
| http://map.guifibaix.coop
|
|-
| SBLL
| [http://www.guifibaix.coop Mesh a Sant Boi de Llobregat]
| Municipi de Sant Boi de Llobregat a la comarca de Baix Llobregat
|
| [[qMp]]
|
| 136-
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.176.0/21
|
| BMX6-0.1-alpha comPatibility=16 revision=8f26909e8808ed7fab0359afc15a3e44563fbd40
| http://map.guifibaix.coop
|
|-
| MSOL-VDX
| [[Mira-sol i Valldoreix]]
| Barri de Mira-sol i entitat municipal descentralitzada de Valldoreix al municipi de Sant Cugat del Vallès
|
| [[libre-mesh]]
| [https://chef.altermundi.net/ls/msol-vdxguifinet/r44952/1509/ar71xx/ 15.09]
|
|
|
|
| 10.1.200.0/21
|
|
|
|
|-
| Rio
| [[Rio de Janeiro]]
| Estat de Rio de Janeiro al Brasil (es fa servir de manera estable a la subzona [https://guifi.net/Fuma%C3%A7a Fumaça - Porto Real])
|
| [[libre-mesh]]
|
|
|
|
|
| [https://guifi.net/es/node/80001/view/ipv4 10.7.0.0/16]
|
|
|
|
|}
<references />

[[categoria:MANET]]

Annex:subxarxes mesh

2017-10-10T09:36:39Z

Rogerpueyo:

{| 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]]
! [[binari concret]]
! [[canal]] <ref name="canals">'''IMPORTANT++: els canals WiFi de 40 MHz han de seguir l'estàndar, pel que el 140- no és vàlid i S'HA DE CANVIAR a totes les zones'''</ref> <ref>Missatge a les llistes sobre els canals incorrectes: https://llistes.guifi.net/sympa/arc/guifi-mesh/2015-01/msg00000.html</ref>
! [[BSSID (adhoc)]]
! [[Mesh id (802.11s)]]
! [[vlan]]
! IPv4
! IPv6
! [[BMX6]] versió
! URL del Mapa o llistat dels nodes
! Comentari
|-
| GSF - '''BCNgsf'''
| [[Gràcia Sense Fils]]
| Vila de Gràcia al municipi de Barcelona
|
| [[gsffirm]] i [[qMp]]
|
| 140- old 149+
| 02:CA:FF:EE:BA:BE
|
|
| 10.1.0.0/21
|
|
|
|
|-
| GS - gs - '''BCNsants''' <ref name="Sants">Es suggereix fer servir <code>BCNsants</code> en comptes de <code>gs</code> perquè <code>gs</code> és també el començament de l'abreviació de Gràcia SenseFils, així, quan un nom de carrer d'un node de Gràcia SenseFils comença per "f" resulta confús al mirar-los al mateix llistat de survey o similar.</ref>
| [[GuifiSants]]
| Sants - Les Corts al municipi de Barcelona
|
| [[qMp]]
|
| 48+, 52+, 60+, 100+, 108+, i 140
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.8.0/21
|
|
|
|
|-
| RAV - '''BCNrav'''
| [[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-
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.16.0/21
|
|
|
|
|-
| UPC - '''BCNupc'''
| [[Mesh a la UPC]]
| Campus Nord de la Universitat Politècnica de Catalunya a Barcelona
|
| [[qMp]]
|
| 136-
| 02:CA:FF:EE:BA:BE
|
|
| 10.1.24.0/21
|
|
|
|
|-
| HW
| [[Hospitalet Wireless]]
| Núvol de Bellvitge a la ciutat de l'Hospitalet del Llobregat
|
| [[qMp]]
|
| 108+
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.32.0/21
|
|
|
|
|-
| SJD - '''BCNsjd'''
| [http://www.guifibaix.coop Mesh a Sant Joan Despí]
| Municipi de Sant Joan Despí a la comarca del Baix Llobregat
|
| [[qMp]]
|
| 136-
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.40.0/21
|
| BMX6-0.1-alpha comPatibility=16 revision=8f26909e8808ed7fab0359afc15a3e44563fbd40 (revision=4d3819b255540915408b827ae03fd92cbd7b4bdd old nodes)
| http://map.guifibaix.coop
|
|-
| vllc - BCNvkk
| [[Mesh a Vallcarca]]
| Barri de Vallcarca i els Penitents al municipi de Barcelona
|
| [[qMp]]
|
| 108+ i 140-
| 02:CA:FF:EE:BA:BE
|
|
| 10.1.48.0/21
|
|
|
|
|-
| SAND - '''BCNsand'''
| [[Mesh a Sant Andreu]]
| Barri de Sant Andreu al municipi de Barcelona
|
| [[qMp]]
|
| 132+ i 120-
| 02:CA:FF:EE:BA:BE
|
|
| 10.1.56.0/21
|
|
|
|
|-
| P9SF - '''BCNp9sf'''
| [[Poblenou Sense Fils]]
| Poblenou al municipi de Barcelona
|
| [[qMp]]
|
| 140- old 132+ base 124+ alt
| 02:CA:FF:EE:BA:BE
|
|
| 10.1.64.0/21
|
|
|
|
|-
| BCNhctm
| [[Horta-Carmel-Montbau-Teixonera]]
| Part nord del districte Horta-Guinardó al municipi de Barcelona
|
| [[qMp]]
|
| 149+
| 02:CA:FF:EE:BA:BE
|
|
| 10.1.72.0/21
|
|
|
|
|-
| SCC
| [http://www.guifibaix.coop Mesh a Santa Coloma de Cervelló]
| Municipi de Santa Coloma de Cervelló a la comarca del Baix Llobregat
|
| [[qMp]]
|
| 140-
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.80.0/21
|
| BMX6-0.1-alpha comPatibility=16 revision=4d3819b255540915408b827ae03fd92cbd7b4bdd
| http://map.guifibaix.coop
|
|-
| SCLL
| [http://www.guifibaix.coop Mesh a Sant Climent de Llobregat]
| Municipi de Sant Climent de Llobregat a la comarca de Baix Llobregat
|
| [[qMp]]
|
| 140-
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.144.0/21
|
| BMX6-0.1-alpha comPatibility=16 revision=4d3819b255540915408b827ae03fd92cbd7b4bdd
| http://map.guifibaix.coop
|
|-
| PRLL
| [http://www.guifibaix.coop Mesh al Prat]
| Municipi de El Prat de Llobregat a la comarca de Baix Llobregat
|
| [[qMp]]
|
| 136-
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.88.0/21
|
| BMX6-0.1-alpha comPatibility=16 revision=8f26909e8808ed7fab0359afc15a3e44563fbd40
| http://map.guifibaix.coop
|
|-
| gll
| [[Garraf Lliure]]
| Comarca del Garraf a Barcelona
| garraflliure.integral.guifi.net
| [[libre-mesh]]
|
| 11 i 48
| CA:FE:00:C0:FF:EE
|
| 245
| 10.1.96.0/21
|
|
|
|
|-
| BCNmtj
| [[Montjuïc]]
| Cara alta nord de Montjuïc al districte de Sants - Montjuïc a Barcelona
| jardibotanic.integral.guifi.net
| [[libre-mesh]]
|
| 48
|
|
| 11
| 10.1.104.0/21
| 2a00:1508:1:f000 o 2a00:1508:1:fe4c::/64
|
|
|
|-
| CRNLL
| [http://www.guifibaix.coop Mesh a Cornellà]
| Municipi de Cornellà a la comarca de Baix Llobregat
|
| [[qMp]]
|
| 136-
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.112.0/21
|
| BMX6-0.1-alpha comPatibility=16 revision=8f26909e8808ed7fab0359afc15a3e44563fbd40
| http://map.guifibaix.coop
|
|-
| afrd
| Aiguafreda
|
|
| [[qMp]]
|
| 140-
| 02:CA:FF:EE:BA:BE
|
|
| 10.1.120.0/21
|
|
|
|
|-
| Wales
| [http://www.digitalmerthyr.org.uk Digital Merthyr]
| Nodes desplegats a Merthyr Tydfil (més info: Routek.net)
|
| [[qMp]]
|
| 140-
| 02:CA:FF:EE:BA:BE
|
|
| 10.1.128.0/20, 10.1.224.0/21, 10.92.2.0/24
|
|
|
|
|-
| CIU
| [[Mesh a Ciutadella]]
| Ciutadella a l'illa de Menorca.
|
| [[qMp]]
|
| 140- i més ...?
| 02:CA:FF:EE:BA:BE
|
|
| 10.2.0.0/21
|
|
|
|
|-
| IRU
| [[Mesh a Iruña]]
| Iruña a Navarra
|
| [[qMp]]
|
| 140-
| 02:CA:FF:EE:BA:BE
|
|
|style="background-color: orange;"| 10.3.0.0/21 <ref name="conflict"> '''IMPORTANT: encara hi ha 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]]
|
| ?
| 02:CA:FF:EE:BA:BE
|
|
| 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].
|-
| ?
| [[Mesh de Castelló]]
| Ciutat de Castelló al País Valencià
|
| [[qMp]]
|
| -
| 02:CA:FF:EE:BA:BE
|
|
| 10.4.0.0/21
|
|
|
|
|-
| ?
| [[Mesh de Benicàssim]]
| Ciutat de Benicàssim a la província de Castelló, País Valencià
|
| [[qMp]]
|
| -
| 02:CA:FF:EE:BA:BE
|
|
| 10.4.8.0/21
|
|
|
|
|-
| ?
| [[Xarxa Veïnal dels barris valencians]]
| Barri del Cabanyal i altres a la ciutat de Valencia
|
| [[libre-mesh]]
|
| -
|
|
|
| 10.5.0.0/21
|
|
|
|
|-
| sn
| [[Sierra Libre]]
| Región de la Sierra Norte, en el Estado de Oaxaca, México
| sierralibre.guifi.net
| [[libre-mesh]]
|
|
|
|
|
| 10.72.8.0/21
|
|
|
|
|-
| SFCM
| Mesh a Sant Feliu de Codines
| Sant Feliu de Codines, Valles Oriental, BCN
|
| [[qMp]]
|
|
| 02:CA:FF:EE:BA:BE
|
|
| 10.91.176.0/22
|
|
|
|
|-
| BCNeixD
| [[Eixample Dret]]
| Barri de l'Eixample Dret a Barcelona
|
| [[libre-mesh]]
|
| 9 i 140
|
|
| 11
| 10.1.152.0/21
| 2a00:1508:1:f017::/64 2a00:1508:1:f018::/64 2a00:1508:1:f019::/64
|
|
|
|-
| VLDC
| [http://www.guifibaix.coop Mesh a Viladecans]
| Municipi de Viladecans de Baix Llobregat
|
| [[qMp]]
|
| 136-
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.168.0/21
|
| BMX6-0.1-alpha comPatibility=16 revision=8b0585e84ca8a0110bd4587e19192beda1ba3238
| http://map.guifibaix.coop
|
|-
| SBLL
| [http://www.guifibaix.coop Mesh a Sant Boi de Llobregat]
| Municipi de Sant Boi de Llobregat a la comarca de Baix Llobregat
|
| [[qMp]]
|
| 136-
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.176.0/21
|
| BMX6-0.1-alpha comPatibility=16 revision=8f26909e8808ed7fab0359afc15a3e44563fbd40
| http://map.guifibaix.coop
|
|-
| MSOL-VDX
| [[Mira-sol i Valldoreix]]
| Barri de Mira-sol i entitat municipal descentralitzada de Valldoreix al municipi de Sant Cugat del Vallès
|
| [[libre-mesh]]
| [https://chef.altermundi.net/ls/msol-vdxguifinet/r44952/1509/ar71xx/ 15.09]
|
|
|
|
| 10.1.200.0/21
|
|
|
|
|-
| Rio
| [[Rio de Janeiro]]
| Estat de Rio de Janeiro al Brasil (es fa servir de manera estable a la subzona [https://guifi.net/Fuma%C3%A7a Fumaça - Porto Real])
|
| [[libre-mesh]]
|
|
|
|
|
| [https://guifi.net/es/node/80001/view/ipv4 10.7.0.0/16]
|
|
|
|
|}
<references />

[[categoria:MANET]]

Guia bones pràctiques supernodes híbrids

2016-12-16T19:45:56Z

Rogerpueyo:

Aquesta guia explica les diferents maneres de configurar un supernode híbrid que consta dels següents elements:
* '''Un router principal''' (sense wifi) que gestiona l'encaminament, l'adreçament, etc.
* '''Dos routers wifi amb antenes sectorials''' en mode ''bridge AP'', que donen cobertura a nodes clients
* Altres dispositius, com un enllaç PTP (punt a punt)

Per anar desenvolupant la guia amb un cas pràctic com a fil conductor, el supernode dóna cobertura i adreçament a diversos nodes clients repartits entre les dues antenes sectorials (per exemple, vint nodes cadascuna).

= Configuració simple (I): un sol prefix d'adreçament públic i sense VLANs =
Aquesta configuració és la més simple de totes, ja que només es fa servir un únic prefix d'adreçament públic i no es fan servir VLANs.

== Pros i contres ==
* '''+''' Màxima facilitat de configuració
* '''-''' Tots els dispositius són a la mateixa LAN o ''collision domain''

Guia bones pràctiques supernodes híbrids

2016-12-16T18:54:25Z

Rogerpueyo: Introducció

Preparant l'entorn de desenvolupament

2016-12-13T12:35:38Z

Rogerpueyo: Actualització versió Drupal 6.38

Aquest document documenta com preparar un entorn de desenvolupament per col·laborar en el desenvolupament de la web de guifi.net.

Ens centrarem al mòdul "'''drupal-guifi'''", que és el fonamental de tota la gestió a la [[web de guifi.net]], però l'entorn muntat pot fer-se servir per desenvolupar altres mòduls o temes, com per exemple "'''budgets'''" i "'''theme_guifinet2011'''".

= Instalació i configuracó de la base =
Per fer funcionar [[Drupal]] a la màquina de desenvolupament cal posar en marxa un [[servidor web]], el mòdul [[PHP]] pel servidor web i un servidor de base de dades, recomanat [[MySQL]].

En funció del nostre sistema operatiu i les nostres preferències, la instalació d'aquests serveis es realitzarà d'una manera o d'una altra. A continuació es detalla pels entorns '''Debian/Ubuntu''' amb '''Apache+PHP+Mysql''' i '''Archlinux''' amb '''Nginx+PHP+Mysql'''. Totes dues instalacions són simples.

* Debian/Ubuntu:
$ sudo apt-get install mysql-server libapache2-mod-php5 php5-gd php5-mysql

* Archlinux:
$ pacman -S nginx mysql php-fpm php-gd

Documentació per a Archlinux: [https://wiki.archlinux.org/index.php/Apache,_PHP,_and_MySQL Apache, PHP and MySQL], [https://wiki.archlinux.org/index.php/Nginx Nginx]

La configuració del servidor web (Apache/lighttpd/nginx) per a fer que funcioni el mòdul de PHP a l'arrel del nostre directori web depèn del nostre sistema.

== Configuració de l'arxiu php.ini ==
Cal tenir activats els següents mòduls a l'arxiu php.ini:

extension=mysql.so
extension=iconv.so
extension=gd.so

Cal testejar si el sistema interpreta arxius PHP. Per això, es pot crear un arxiu al DOCUMENT_ROOT '''(generalment /var/www)''' del servidor web. Si no funciona reviseu els passos anteriors i consulteu la documentació de la vostra distribució.

<?php
phpinfo();
?>

== Configuració de fitxers ==
Per tal de no tenir problemes en la nostra instal·lació de l'entorn de desenvolupament, es necessari realitzar algunes modificacions dins d'uns fitxers concrets els quals esmentarem per tal de que tot funcioni correctament:

En l'adreça següent:
/etc/apache2/sites-enabled/

Hi tenim un únic fitxer el qual es diu '000-default'. Mitjançant un editor de text de shell (vi/nano) editarem el fitxer:

$ vi 000-default

Dins del fitxer, hem de buscar el següent text: 'Allow Override None' en tot el text i substituir-lo per 'Allow Override All'. Per realitzar la modificació, mitjançant les fletxes de direcció ens situarem sobre la línia en qüestió i apretarem la tecla 'i' la qual ens permetrà escriure. Si es presenten problemes, sembre es pot sortir del fitxer sense desar mitjançant la tecla 'ESC' seguit de la comanda ':q!' <quit without saving> << sortir sense guardar.

$ nano 000-default

Fem l'edició i sortim desant Ctrl+X

== Preparació de les Clean URL ==

La nostra web amb drupal necessita fer servir '''Clean URL''' i per tal que aquestes es puguin aplicar es necessari tenir activat el mòdul '''rewrite'''. Per tal d'activar aquest mòdul, utilitzarem les comandes següents:

a2enmod rewrite

Ens informarà que el mòdul està actiu i que s'haurà de reiniciar el servei, cosa que farem amb la comanda:

/etc/init.d/apache2 restart
o bé
service apache2 restart

= Descarregant el codi font =
El codi dels mòduls "drupal-guifi", "drupal-bugdets" i "theme_guifinet2011" són [[programari lliure]] i estan allotjats als [[repositoris]] de Gitorious. Els repositoris són útils pel desenvolupament de programari però nosaltres ens limitarem a clonar-los.

La idea és que hi ha el repositori de cada un dels mòduls i el tema, cada desenvolupador té una còpia del repositori també a Gitorious, d'aquesta manera instal·larà la seva còpia a la seva màquina de desenvolupament, realitzarà el desenvolupament a la seva màquina i un cop el desenvolupament és correcte, enviarà els canvis a la seva còpia de Gitorious i demanarà incloure'ls al repositori principal.

== Requisits pel clonatge del repositori drupal-guifi a la còpia del desenvolupador a Gitorious ==
Haurem de fer un fork del projecte "drupal-guifi" de cara a realitzar alguna modificació sobre el seu codi font.

* Crear-se un compte a [http://gitorious.org Gitorious].
* Crear unes claus SSH (ssh-keygen) sense contrasenya a l'ordinador de treball i s'afegiran al perfil d'usuari de gitorious. Per exemple:

ssh-keygen

Generating public/private rsa key pair.
Enter file in which to save the key (/home/dave/.ssh/id_rsa):
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /home/dave/.ssh/id_rsa.
Your public key has been saved in /home/dave/.ssh/id_rsa.pub.

* Accedir a la pàgina del projecte "[https://gitorious.org/guifi/drupal-guifi drupal-guifi]".
* Clonar el projecte. Amb això ja tindrem un fork del projecte sobre el que podem realitzar els nostres canvis.

Pàgines web a Gitorious dels projectes amb les que podem participar en el desenvolupament:
* https://gitorious.org/guifi/drupal-guifi
* https://gitorious.org/guifi/drupal-budgets
* https://gitorious.org/guifi-web/theme_guifinet2011

Amb això tindrem una còpia de l'original a l'espai del desenvolupador a Gitorious.

= Descàrrega, instalació i configuració de l'entorn Drupal =

Al principi hem instal·lats els serveis bàsics a la nostra màquina de desenvolupament i hem clonat els repositoris de codi font amb els que volem treballar, hem de posar en funcionant a la màquina de desenvolupament el Drupal 6.x (amb alguns mòduls adicionals), ja que així podrem veure i testejar els canvis que anem fent al nostre repositori de "drupal-guifi".

== Descàrregues des de la línea de comandes ==

* La darrera versió de Drupal 6 (6.38):

wget http://ftp.drupal.org/files/projects/drupal-6.38.tar.gz

i habilitar l'accès via web:

ln -s /usr/share/drupal6/ /var/www/guifi

* Els Mòduls de Drupal fonamentals:
Que els descarregarem a /var/www/drupal-6.38/sites/all/modules

'''Mòdul WebForm:'''
wget http://ftp.drupal.org/files/projects/webform-6.x-3.23.tar.gz

'''Mòdul Views:'''
wget http://ftp.drupal.org/files/projects/views-6.x-2.18.tar.gz

'''Mòdul Views_slideshow:'''
wget http://ftp.drupal.org/files/projects/views_slideshow-6.x-2.4.tar.gz

'''Mòdul Internationalization (i18n) <Multi-idioma>:'''
wget http://ftp.drupal.org/files/projects/i18n-6.x-1.10.tar.gz

* Els Mòduls de Drupal opcionals:

'''Mòdul schema:'''
wget http://ftp.drupal.org/files/projects/schema-6.x-1.7.tar.gz

'''Mòdul devel:'''
wget http://ftp.drupal.org/files/projects/devel-6.x-1.28.tar.gz

'''Mòdul Translation template extractor (potx):'''
wget http://ftp.drupal.org/files/projects/potx-6.x-3.3.tar.gz

'''Mòdul Localization client (l10n client):'''
wget http://ftp.drupal.org/files/projects/l10n_client-6.x-2.2.tar.gz

'''Mòdul language (???):'''
wget ???

'''Mòdul icons (Language icons???):'''
wget http://ftp.drupal.org/files/projects/languageicons-6.x-2.1.tar.gz ???

'''Mòdul language_sections:'''
wget http://ftp.drupal.org/files/projects/language_sections-6.x-2.5.tar.gz

'''Mòdul diff:'''
wget http://ftp.drupal.org/files/projects/diff-6.x-2.3.tar.gz

'''Mòdul captcha:'''
wget http://ftp.drupal.org/files/projects/captcha-6.x-2.7.tar.gz

'''Mòdul captcha_pack:'''
wget http://ftp.drupal.org/files/projects/captcha_pack-6.x-1.0-beta3.tar.gz

'''Mòdul event:'''
wget http://ftp.drupal.org/files/projects/event-6.x-2.x-dev.tar.gz

'''Mòdul cck:'''
wget http://ftp.drupal.org/files/projects/cck-6.x-2.10.tar.gz

'''Mòdul fckeditor:'''
wget http://ftp.drupal.org/files/projects/fckeditor-6.x-2.4.tar.gz

'''Mòdul image:'''
wget http://ftp.drupal.org/files/projects/image-6.x-1.2.tar.gz

'''Mòdul image_filter:'''
wget http://ftp.drupal.org/files/projects/image_filter-6.x-1.0.tar.gz

'''Mòdul fivestar'''
wget http://ftp.drupal.org/files/projects/fivestar-6.x-1.21.tar.gz

'''Mòdul votingapi'''
wget http://ftp.drupal.org/files/projects/votingapi-6.x-2.3.tar.gz

* Mòduls desenvolupats per la comunitat Guifi.net:

- Mòdul budgets

- Mòdul guifi

* El tema oficial "theme_guifinet2011":

* La base de dades actual de desenvolupament de la web de guifi.net:

wget http://www.guifi.net/guifi66_devel.sql.gz

== Instalació de Drupal ==

Hem de posar en marxa un entorn Drupal bàsic i posteriorment sobreescriurem la base de dades amb la que hem descarregat prèviament de Guifi.net

Aquests són els passos bàsics per a instal·lar i configurar un site Drupal:

* Descomprimim el paquet de Drupal que ens hem descarregat i el posem accesible al DOCUMENT_ROOT d'Apache:

cd /var/www
tar zxvf drupal-6.29.tar.gz
ln -s drupal-6.29 guifi

* Iniciem el procés d'instalació via web de Drupal accedint a http://<ip_del_teu_servidor>/guifi exemples:

http://10.138.71.10/guifi

http://localhost/guifi

* En arribar a l'apartat de configuració de la base de dades, necessitarem tenir creada una base de dades local de MySQL per a desenvolupament:

[dave@inuik http]$ mysql -u <nomusuari> -p <contrassenya> << és possible que amb root no faci falta una password

exemple:

mysql -u root -p <salt de linia>
Enter password: <escritura_de_la_password>

Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 525
Server version: 5.5.31-0+wheezy1 (Debian)

Copyright (c) 2000,2013, Oracle and/or its affiliates. All rights reserved.
Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql> create database guifi_test;
Query OK, 1 row affected (0.00 sec)

mysql> grant all on guifi_test.* to guifi@localhost identified by 'guifinet';
Query OK, 0 rows affected (0.00 sec)

Ja podem introduir la informació de connexió a la base de dades per a que Drupal creï les taules necessàries.

== Instal·lació dels mòduls de Drupal necessaris per a engegar l'entorn ==

Dins de l'adreça /var/www/drupal-6.29/sites/all/modules, on tindrem descarregats els nostres mòduls, els descomprimirem mitjançant la ordre:

tar zxvf <nom_del_fitxer_a_descomprimir>

per exemple:

tar zxvf i18n-6.x-1.10.tar.gz

'''ATENCIÓ'''. Fixeu-vos que el mòdul "drupal-guifi" que estem clonant no és el repositori principal que hi ha a Gitorious, sinó el que hem creat fent un fork del projecte principal. Així els canvis que fem els podrem pujar a Gitorious al repositori nostre com a desenvolupadors, per a posteriorment, si ho considerem convenient, notificar el canvi als desenvolupadors principals per a que els puguin integrar a la branca principal de desenvolupament, això es fa des del mateix Gitorious amb un ''merge request''.

mkdir drupal-6.29/sites/all/modules
cd drupal-6.29/sites/all/modules
git clone git://gitorious.org/guifi/drupal-budgets.git budgets
# Clonat del MEU FORK del mòdul "drupal-guifi"
git clone git@gitorious.org:~tombatossals/guifi/tombatossalss-drupal-guifi.git guifi (canvia "~tombatossals/guifi/tombatossalss-drupal-guifi.git" pel teu repositori clonat a Gitorious)

== Instalació de la base de dades de desenvolupament de Guifi.net ==

Tenint una instal·lació neta de Drupal, anem a sobreescriure la base de dades amb la informació de les taules de la base de dades de Guifi.net, el que ens proporcionarà un entorn de desenvolupament similar a la web en producció. Des de la carpeta on anteriorment hem baixat la base de dades cal fer:

gunzip guifi66_devel.sql.gz

mysql -u root -p guifi_test < guifi66_devel.sql; << recordem que les comandes dins de MySQL s'acaben amb un ';'

== Afinant la instalació ==

Un cop realitzada la instal·lació, s'ha d'editar el fitxer .htaccess, que es troba dins de la carpeta arrel de drupal :

cd /var/www/drupal-6.29
ls -la << per mostrar llistats tots els fitxers inclosos els ocults

Ens mostrarà un arxiu ocult anomenat : .htaccess
L'editarem mitjançant un editor de text:

vi .htaccess

En una linia buida del fitxer, apretarem la 'i' per escriure-hi i afegirem la següent linia: RewriteBase /drupal-6.29

Un cop instalada la base de dades amb tota la informació de la web de Guifi.net, tindrem accés a la informació de qualsevol node o zona de la web principal. Per a loguejar-te com usuari, has de fer servir el nom d'usuari corresponent i la contrasenya genèrica "guifi".

L'usuari administrador serà "webmestre" i la contrasenya "guifi".

'''Alguns consells per a refinar la instalació:'''

* Creeu i comproveu que els directoris "files", "files/nanostation" i "tmp" del directori de instalació de drupal tenen permisos de escriptura per l'usuari del servidor web (o poseu-los a 777):
mkdir drupal-6.29/{files,files/nanostation,tmp}
chmod 777 drupal-6.29/{files,files/nanostation,tmp}

* La carpeta "files/nanostation" contendrà els arxius "unsolclic" de les antenes Ubiquiti que anem consultant o creant.

* Protegiu la carpeta "files" i "tmp" amb el seu respectiu fixter .htaccess
A la carpeta "files" el ftixer .htaccess ha de incloure aquest contingut:

# Turn off all options we don't need.
Options None
Options +FollowSymLinks
# Set the catch-all handler to prevent scripts from being executed.
SetHandler Drupal_Security_Do_Not_Remove_See_SA_2006_006
<Files *>
# Override the handler again if we're run later in the evaluation list.
SetHandler Drupal_Security_Do_Not_Remove_See_SA_2013_003
</Files>
# If we know how to do it safely, disable the PHP engine entirely.
<IfModule mod_php5.c>
php_flag engine off
</IfModule>
# PHP 4, Apache 1.
<IfModule mod_php4.c>
php_flag engine off
</IfModule>
# PHP 4, Apache 2.
<IfModule sapi_apache2.c>
php_flag engine off
</IfModule>

I a la carpeta "tmp", el fitxer .htaccess ha de ser exactament el mateix que el de "files" pero hi hem d'afegir al final de tot això:

Deny from all

* Editeu el fitxer robots.txt, elimineu-ne tot el contingut i afegiu únicament aquestes linies, doncs no ens interessa que els robots indexin el nostre entorn local.

User-agent: *
Disallow: /

* Comproveu els possibles errors de instalació de Drupal accedint com usuari "webmestre" a la pàgina de administració i, des d'allà, a la pàgina de "Report Status". Ex: http://localhost/guifi/ca/admin/reports/status

* Accediu a la secció de configuració de "Performance" y deshabiliteu tot l'usatge de caché, optimització y compressió. Ens interessa que els canvis que fem sobre els arxius s'actualitzin en temps real. La URL d'accés a aquesta configuració serà de l'estil de: http://localhost/guifi/admin/settings/performance

== Instalació del tema Guifi.net al Drupal ==

mkdir drupal-6.29/sites/all/themes
cd drupal-6.29/sites/all/themes
git clone git://gitorious.org/guifi-web/theme_guifinet2011.git

El tema no s'activarà inmediatament, ja que li mancaran els arxius d'estils que Drupal creu que esten cachejats al sistema. Per a aconseguir que el tema s'activi completament, haurem d'accedir a l'"administració de temes", "configuració del tema de guifinet2011" i "desar" sense tocar cap opció. El tema per fi estarà activat.

Per visualitzar les imatges de la portada cal haver instal·lat els mòduls opcionals d'imatges i descarregar a:

$ cd /var/www/drupal-6.29/files/images

les següents imatges que es poden descarregar des de la línia de comandes:

wget http://guifi.net/files/images/el_molar_v2.jpg
wget http://guifi.net/files/images/platadaro_910x454.jpg
wget http://guifi.net/files/images/antenes2.jpg
wget http://guifi.net/files/images/dsc07219_910x454_v2.jpg
wget http://guifi.net/files/images/puigcubell_portada.jpg
wget http://guifi.net/files/images/taller_fibra1.jpg
wget http://guifi.net/files/images/DSC08889_910x454_v2.jpg
wget http://guifi.net/files/images/20246_910x454_v2.jpg
wget http://guifi.net/files/images/illes_910x454.jpg
wget http://guifi.net/files/images/cel-bcn-portada.jpg

== Instal·lació dels idiomes ==

La base de dades de Guifi.net que hem importat té habilitats varis idiomes per defecte, però les traduccions no estan instalades al sistema. Per a solucionar-ho, seguim aquests passos:

* Descarregueu la traducció de l'idioma de aquí: http://localize.drupal.org/.

Per exemple: http://ftp.drupal.org/files/translations/6.x/drupal/drupal-6.29.ca.po

* Aneu a la administració de idiomes de la vostra instalació com ''webmestre'', està localitzada a /admin/settings/language, i fixeu-vos que hi ha un enllaç per a importació manual dels strings de traducció: /admin/build/translate/import

* Indiqueu-li l'idioma de l'arxiu que heu descarregat e importeu-lo. A partir d'aquí ja tindrem l'interfície traduïda.

= Començant a treballar =

Ja tenim un entorn preparat per començar a modificar els mòduls de Drupal, pujar-los al nostre propi repositori i, si ho considerem convenient, notificar els nostres commits als desenvolupadors per a que els integrin a la branca principal.

Per a fer commit dels nostres canvis:

cd drupal-6.29/site/all/modules/guifi
# Fem modificacions a alguns arxius, les enregistrem al nostre repositori de treball i procedirem a pujar-les a Gitorious
git commit -a
git push

Posteriorment, des de la web de Gitorious podrem fer servir un "Merge request" per notificar als desenvolupadors alguna de les nostres modificacions i que valorin la seva incorporació al repositori principal.

== Actualitzant el nostre repositori amb els canvis del repositori pare ==

Si volem mantenir el nostre repositori actualitzat amb els darrers canvis que es van produint al repositori pare, haurem de seguir la següent recepta:

# Definim com repositori remot anomenat "upstream" el repositori de "drupal-guifi"
git remote add upstream git://gitorious.org/guifi/drupal-guifi.git

# Obtenim els darrers canvis del nostre repositori
git fetch origin -v

# Obtenim els darrers canvis del repositori pare
git fetch upstream -v

# Fem el merge dels canvis obtinguts
git merge upstream/master

== Referències ==

{{MM|url=https://lists.guifi.net/pipermail/guifi-webdev/2012-February/001750.html|list=webdev}}

== Enllaços externs ==

* http://acacha.org/mediawiki/index.php/Entorn_de_desenvolupament_guifi

[[Categoria:desenvolupament]]

Annex:subxarxes mesh

2016-07-06T10:41:06Z

Rogerpueyo:

{| 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]]
! [[binari concret]]
! [[canal]] <ref name="canals">'''IMPORTANT++: els canals WiFi de 40 MHz han de seguir l'estàndar, pel que el 140- no és vàlid i S'HA DE CANVIAR a totes les zones'''</ref> <ref>Missatge a les llistes sobre els canals incorrectes: https://llistes.guifi.net/sympa/arc/guifi-mesh/2015-01/msg00000.html</ref>
! [[BSSID (adhoc)]]
! [[Mesh id (802.11s)]]
! [[vlan]]
! IPv4
! IPv6
! [[BMX6]] versió
! URL del Mapa o llistat dels nodes
! Comentari
|-
| GSF - '''BCNgsf'''
| [[Gràcia Sense Fils]]
| Vila de Gràcia al municipi de Barcelona
|
| [[gsffirm]] i [[qMp]]
|
| 140- old 149+
| 02:CA:FF:EE:BA:BE
|
|
| 10.1.0.0/21
|
|
|
|
|-
| GS - gs - '''BCNsants''' <ref name="Sants">Es suggereix fer servir <code>BCNsants</code> en comptes de <code>gs</code> perquè <code>gs</code> és també el començament de l'abreviació de Gràcia SenseFils, així, quan un nom de carrer d'un node de Gràcia SenseFils comença per "f" resulta confús al mirar-los al mateix llistat de survey o similar.</ref>
| [[GuifiSants]]
| Sants - Les Corts al municipi de Barcelona
|
| [[qMp]]
|
| 108+, 124+ (en migració cap al canal 100+) i 140
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.8.0/21
|
|
|
|
|-
| RAV - '''BCNrav'''
| [[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-
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.16.0/21
|
|
|
|
|-
| UPC - '''BCNupc'''
| [[Mesh a la UPC]]
| Campus Nord de la Universitat Politècnica de Catalunya a Barcelona
|
| [[qMp]]
|
| 140-
| 02:CA:FF:EE:BA:BE
|
|
| 10.1.24.0/21
|
|
|
|
|-
| HW
| [[Hospitalet Wireless]]
| Núvol de Bellvitge a la ciutat de l'Hospitalet del Llobregat
|
| [[qMp]]
|
| 108+
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.32.0/21
|
|
|
|
|-
| SJD - '''BCNsjd'''
| [http://www.guifibaix.coop Mesh a Sant Joan Despí]
| Municipi de Sant Joan Despí a la comarca del Baix Llobregat
|
| [[qMp]]
|
| 136-
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.40.0/21
|
| BMX6-0.1-alpha comPatibility=16 revision=8f26909e8808ed7fab0359afc15a3e44563fbd40 (revision=4d3819b255540915408b827ae03fd92cbd7b4bdd old nodes)
| http://map.guifibaix.coop
|
|-
| vllc - BCNvkk
| [[Mesh a Vallcarca]]
| Barri de Vallcarca i els Penitents al municipi de Barcelona
|
| [[qMp]]
|
| 108+ i 140-
| 02:CA:FF:EE:BA:BE
|
|
| 10.1.48.0/21
|
|
|
|
|-
| SAND - '''BCNsand'''
| [[Mesh a Sant Andreu]]
| Barri de Sant Andreu al municipi de Barcelona
|
| [[qMp]]
|
| 132+ i 120-
| 02:CA:FF:EE:BA:BE
|
|
| 10.1.56.0/21
|
|
|
|
|-
| P9SF - '''BCNp9sf'''
| [[Poblenou Sense Fils]]
| Poblenou al municipi de Barcelona
|
| [[qMp]]
|
| 140- old 132+ base 124+ alt
| 02:CA:FF:EE:BA:BE
|
|
| 10.1.64.0/21
|
|
|
|
|-
| BCNhctm
| [[Horta-Carmel-Montbau-Teixonera]]
| Part nord del districte Horta-Guinardó al municipi de Barcelona
|
| [[qMp]]
|
| 149+
| 02:CA:FF:EE:BA:BE
|
|
| 10.1.72.0/21
|
|
|
|
|-
| SCC
| [http://www.guifibaix.coop Mesh a Santa Coloma de Cervelló]
| Municipi de Santa Coloma de Cervelló a la comarca del Baix Llobregat
|
| [[qMp]]
|
| 140-
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.80.0/21
|
| BMX6-0.1-alpha comPatibility=16 revision=4d3819b255540915408b827ae03fd92cbd7b4bdd
| http://map.guifibaix.coop
|
|-
| SCLL
| [http://www.guifibaix.coop Mesh a Sant Climent de Llobregat]
| Municipi de Sant Climent de Llobregat a la comarca de Baix Llobregat
|
| [[qMp]]
|
| 140-
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.144.0/21
|
| BMX6-0.1-alpha comPatibility=16 revision=4d3819b255540915408b827ae03fd92cbd7b4bdd
| http://map.guifibaix.coop
|
|-
| PRLL
| [http://www.guifibaix.coop Mesh al Prat]
| Municipi de El Prat de Llobregat a la comarca de Baix Llobregat
|
| [[qMp]]
|
| 136-
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.88.0/21
|
| BMX6-0.1-alpha comPatibility=16 revision=8f26909e8808ed7fab0359afc15a3e44563fbd40
| http://map.guifibaix.coop
|
|-
| gll
| [[Garraf Lliure]]
| Comarca del Garraf a Barcelona
| garraflliure.integral.guifi.net
| [[libre-mesh]]
|
| 11 i 48
| CA:FE:00:C0:FF:EE
|
| 245
| 10.1.96.0/21
|
|
|
|
|-
| BCNmtj
| [[Montjuïc]]
| Cara alta nord de Montjuïc al districte de Sants - Montjuïc a Barcelona
| jardibotanic.integral.guifi.net
| [[libre-mesh]]
|
| 48
|
|
| 11
| 10.1.104.0/21
| 2a00:1508:1:f000 o 2a00:1508:1:fe4c::/64
|
|
|
|-
| CRNLL
| [http://www.guifibaix.coop Mesh a Cornellà]
| Municipi de Cornellà a la comarca de Baix Llobregat
|
| [[qMp]]
|
| 136-
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.112.0/21
|
| BMX6-0.1-alpha comPatibility=16 revision=8f26909e8808ed7fab0359afc15a3e44563fbd40
| http://map.guifibaix.coop
|
|-
| afrd
| Aiguafreda
|
|
| [[qMp]]
|
| 140-
| 02:CA:FF:EE:BA:BE
|
|
| 10.1.120.0/21
|
|
|
|
|-
| Wales
| [http://www.digitalmerthyr.org.uk Digital Merthyr]
| Nodes desplegats a Merthyr Tydfil (més info: Routek.net)
|
| [[qMp]]
|
| 140-
| 02:CA:FF:EE:BA:BE
|
|
| 10.1.128.0/20, 10.1.224.0/21, 10.92.2.0/24
|
|
|
|
|-
| CIU
| [[Mesh a Ciutadella]]
| Ciutadella a l'illa de Menorca.
|
| [[qMp]]
|
| 140- i més ...?
| 02:CA:FF:EE:BA:BE
|
|
| 10.2.0.0/21
|
|
|
|
|-
| IRU
| [[Mesh a Iruña]]
| Iruña a Navarra
|
| [[qMp]]
|
| 140-
| 02:CA:FF:EE:BA:BE
|
|
|style="background-color: orange;"| 10.3.0.0/21 <ref name="conflict"> '''IMPORTANT: encara hi ha 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]]
|
| ?
| 02:CA:FF:EE:BA:BE
|
|
| 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].
|-
| ?
| [[Mesh de Castelló]]
| Ciutat de Castelló al País Valencià
|
| [[qMp]]
|
| -
| 02:CA:FF:EE:BA:BE
|
|
| 10.4.0.0/21
|
|
|
|
|-
| ?
| [[Mesh de Benicàssim]]
| Ciutat de Benicàssim a la província de Castelló, País Valencià
|
| [[qMp]]
|
| -
| 02:CA:FF:EE:BA:BE
|
|
| 10.4.8.0/21
|
|
|
|
|-
| ?
| [[Xarxa Veïnal dels barris valencians]]
| Barri del Cabanyal i altres a la ciutat de Valencia
|
| [[libre-mesh]]
|
| -
|
|
|
| 10.5.0.0/21
|
|
|
|
|-
| sn
| [[Sierra Libre]]
| Región de la Sierra Norte, en el Estado de Oaxaca, México
| sierralibre.guifi.net
| [[libre-mesh]]
|
|
|
|
|
| 10.72.8.0/21
|
|
|
|
|-
| SFCM
| Mesh a Sant Feliu de Codines
| Sant Feliu de Codines, Valles Oriental, BCN
|
| [[qMp]]
|
|
| 02:CA:FF:EE:BA:BE
|
|
| 10.91.176.0/22
|
|
|
|
|-
| BCNeixD
| [[Eixample Dret]]
| Barri de l'Eixample Dret a Barcelona
|
| [[libre-mesh]]
|
| 9 i 140
|
|
| 11
| 10.1.152.0/21
| 2a00:1508:1:f017::/64 2a00:1508:1:f018::/64 2a00:1508:1:f019::/64
|
|
|
|-
| VLDC
| [http://www.guifibaix.coop Mesh a Viladecans]
| Municipi de Viladecans de Baix Llobregat
|
| [[qMp]]
|
| 136-
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.168.0/21
|
| BMX6-0.1-alpha comPatibility=16 revision=8b0585e84ca8a0110bd4587e19192beda1ba3238
| http://map.guifibaix.coop
|
|-
| SBLL
| [http://www.guifibaix.coop Mesh a Sant Boi de Llobregat]
| Municipi de Sant Boi de Llobregat a la comarca de Baix Llobregat
|
| [[qMp]]
|
| 136-
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.176.0/21
|
| BMX6-0.1-alpha comPatibility=16 revision=8f26909e8808ed7fab0359afc15a3e44563fbd40
| http://map.guifibaix.coop
|
|-
| MSOL-VDX
| [[Mira-sol i Valldoreix]]
| Barri de Mira-sol i entitat municipal descentralitzada de Valldoreix al municipi de Sant Cugat del Vallès
|
| [[libre-mesh]]
| [https://chef.altermundi.net/ls/msol-vdxguifinet/r44952/1509/ar71xx/ 15.09]
|
|
|
|
| 10.1.200.0/21
|
|
|
|
|-
| Rio
| [[Rio de Janeiro]]
| Estat de Rio de Janeiro al Brasil (es fa servir de manera estable a la subzona [https://guifi.net/Fuma%C3%A7a Fumaça - Porto Real])
|
| [[libre-mesh]]
|
|
|
|
|
| [https://guifi.net/es/node/80001/view/ipv4 10.7.0.0/16]
|
|
|
|
|}
<references />

[[categoria:MANET]]

Annex:subxarxes mesh

2016-03-16T16:10:34Z

Rogerpueyo: Canvi freqüència HW-Bellvitge

{| 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]] <ref name="canals">'''IMPORTANT++: els canals WiFi de 40 MHz han de seguir l'estàndar, pel que el 140- no és vàlid i S'HA DE CANVIAR a totes les zones'''</ref> <ref>Missatge a les llistes sobre els canals incorrectes: https://llistes.guifi.net/sympa/arc/guifi-mesh/2015-01/msg00000.html</ref>
! [[BSSID (adhoc)]]
! [[Mesh id (802.11s)]]
! [[vlan]]
! IPv4
! IPv6
! Comentari
|-
| GSF - '''gsf'''
| [[Gràcia Sense Fils]]
| Vila de Gràcia al municipi de Barcelona
|
| [[gsffirm]] i [[qMp]]
| 140- old 149+
| 02:CA:FF:EE:BA:BE
|
|
| 10.1.0.0/21
|
|
|-
| GS - '''gs'''
| [[GuifiSants]]
| Sants - Les Corts al municipi de Barcelona
|
| [[qMp]]
| 108+, 124+ i 140-
| 02:CA:FF:EE:BA:BE
| qMp
|
| 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-
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.16.0/21
|
|
|-
| UPC - '''upc'''
| [[Mesh a la UPC]]
| Campus Nord de la Universitat Politècnica de Catalunya a Barcelona
|
| [[qMp]]
| 140-
| 02:CA:FF:EE:BA:BE
|
|
| 10.1.24.0/21
|
|
|-
| HW
| [[Hospitalet Wireless]]
| Núvol de Bellvitge a la ciutat de l'Hospitalet del Llobregat
|
| [[qMp]]
| 108+
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.32.0/21
|
|
|-
| SJD - '''sjd'''
| [http://www.guifibaix.coop Mesh a Sant Joan Despí]
| Municipi de Sant Joan Despí a la comarca del Baix Llobregat
|
| [[qMp]]
| 136-
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.40.0/21
|
|
|-
| vllc
| [[Mesh a Vallcarca]]
| Barri de Vallcarca i els Penitents al municipi de Barcelona
|
| [[qMp]]
| 108+ i 140-
| 02:CA:FF:EE:BA:BE
|
|
| 10.1.48.0/21
|
|
|-
| SAND - '''sand'''
| [[Mesh a Sant Andreu]]
| Barri de Sant Andreu al municipi de Barcelona
|
| [[qMp]]
| 132+ i 120-
| 02:CA:FF:EE:BA:BE
|
|
| 10.1.56.0/21
|
|
|-
| P9SF - '''p9sf'''
| [[Poblenou Sense Fils]]
| Poblenou al municipi de Barcelona
|
| [[qMp]]
| 140- old 132+ base 124+ alt
| 02:CA:FF:EE:BA:BE
|
|
| 10.1.64.0/21
|
|
|-
| HCMT
| [[Horta-Carmel-Montbau-Teixonera]]
| Part nord del districte Horta-Guinardó al municipi de Barcelona
|
| [[qMp]]
| 149+
| 02:CA:FF:EE:BA:BE
|
|
| 10.1.72.0/21
|
|
|-
| SCC
| [http://www.guifibaix.coop Mesh a Santa Coloma de Cervelló]
| Municipi de Santa Coloma de Cervelló a la comarca del Baix Llobregat
|
| [[qMp]]
| 140-
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.80.0/21
|
|
|-
| PRLL
| [http://www.guifibaix.coop Mesh al Prat]
| Municipi de El Prat de Llobregat a la comarca de Baix Llobregat
|
| [[qMp]]
| 136-
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.88.0/21
|
|
|-
| gll
| [[Garraf Lliure]]
| Comarca del Garraf a Barcelona
| garraflliure.integral.guifi.net
| [[libre-mesh]]
| 11 i 48
| CA:FE:00:C0:FF:EE
|
| 245
| 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.integral.guifi.net
| [[libre-mesh]]
| 48
|
|
| 11
| 10.1.104.0/21
| 2a00:1508:1:f000 o 2a00:1508:1:fe4c::/64
|
|-
| CRNLL
| [http://www.guifibaix.coop Mesh a Cornellà]
| Municipi de Cornellà a la comarca de Baix Llobregat
|
| [[qMp]]
| 136-
| 02:CA:FF:EE:BA:BE
| qMp
|
| 10.1.112.0/21
|
|
|-
| afrd
| Aiguafreda
|
|
| [[qMp]]
| 140-
| 02:CA:FF:EE:BA:BE
|
|
| 10.1.120.0/21
|
|
|-
| Wales
| [http://www.digitalmerthyr.org.uk Digital Merthyr]
| Nodes desplegats a Merthyr Tydfil (més info: Routek.net)
|
| [[qMp]]
| 140-
| 02:CA:FF:EE:BA:BE
|
|
| 10.1.128.0/20, 10.1.224.0/21, 10.92.2.0/24
|
|
|-
| CIU
| [[Mesh a Ciutadella]]
| Ciutadella a l'illa de Menorca.
|
| [[qMp]]
| 140- i més ...?
| 02:CA:FF:EE:BA:BE
|
|
| 10.2.0.0/21
|
|
|-
| IRU
| [[Mesh a Iruña]]
| Iruña a Navarra
|
| [[qMp]]
| 140-
| 02:CA:FF:EE:BA:BE
|
|
|style="background-color: orange;"| 10.3.0.0/21 <ref name="conflict"> '''IMPORTANT: encara hi ha 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]]
| ?
| 02:CA:FF:EE:BA:BE
|
|
| 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].
|-
| ?
| [[Mesh de Castelló]]
| Ciutat de Castelló al País Valencià
|
| [[qMp]]
| -
| 02:CA:FF:EE:BA:BE
|
|
| 10.4.0.0/21
|
|
|-
| ?
| [[Mesh de Benicàssim]]
| Ciutat de Benicàssim a la província de Castelló, País Valencià
|
| [[qMp]]
| -
| 02:CA:FF:EE:BA:BE
|
|
| 10.4.8.0/21
|
|
|-
| sn
| [[Sierra Libre]]
| Región de la Sierra Norte, en el Estado de Oaxaca, México
| sierralibre.guifi.net
| [[libre-mesh]]
|
|
|
|
| 10.72.8.0/21
|
|
|-
|SFCM
| Mesh a Sant Feliu de Codines
| Sant Feliu de Codines, Valles Oriental, BCN
|
|[[qMp]]
|
| 02:CA:FF:EE:BA:BE
|
|
| 10.91.176.0/22
|
|
|-
| eixD
| [[Cooperativa Integral Catalana]]
| Zona mesh guifi.net de la Cooperativa Integral Catalana
|
| [[libre-mesh]]
| 9 i 140
|
|
| 11
| 10.1.152.0/21
| 2a00:1508:1:f017::/64 2a00:1508:1:f018::/64 2a00:1508:1:f019::/64
|
|-
| Rio
| [[Rio de Janeiro]]
| Estat de Rio de Janeiro al Brasil (es fa servir de manera estable a la subzona [https://guifi.net/Fuma%C3%A7a Fumaça - Porto Real])
|
| [[libre-mesh]]
|
|
|
|
| [https://guifi.net/es/node/80001/view/ipv4 10.7.0.0/16]
|
|
|}
<references />

[[categoria:MANET]]

Entorn de desenvolupament de Guifi.net basat en Drupal 7

2016-01-14T16:10:44Z

Rogerpueyo: /* Codi */

Aquest document explica com preparar un entorn de desenvolupament de la web de Guifi.net basat en [https://www.drupal.org Drupal], per poder col·laborar en el seu desenvolupament.

La web de Guifi.net, actualment, està construïda sobre la [https://www.drupal.org/drupal-7.0 versió 7] de Drupal. El desenvolupament se centra entorn del mòdul de Drupal "'''drupal-guifi'''", que gestiona tot el funcionament de la web de Guifi.net, però també serveix per desenvolupar altres mòduls (com "'''budgets'''") i temes ("'''theme_guifinet2011'''").

= Resum del procés =

La preparació de l'entorn de desenvolupament consta dels següents punts essencials:

* Instal·lació i configuració del servidor web i de la base de dades
* Descàrrega, instal·lació i configuració de Drupal 7 i dels mòduls necessaris
* Clonatge del codi font dels mòduls de Guifi des del repositori

= Requisits del servidor =
En aquest document es contempla que l'entorn de desenvolupament s'executa en un servidor amb una instal·lació neta d'un d'aquests sistemes operatius:

* [https://www.debian.org/releases/jessie/ Debian 8.2 ''Jessie''] amb retroversions ([http://backports.debian.org/ ''backports''])
* [https://wiki.ubuntu.com/TrustyTahr/ReleaseNotes Ubuntu 14.04.3 LTS ''Trusty Tahr''] amb retroversions ([https://help.ubuntu.com/community/UbuntuBackports ''backports''])
* [https://www.archlinux.org '''Arch Linux''']

tot i que també se'n poden utilitzar d'altres. En qualsevol cas, s'assumeix que el sistema operatiu ja es troba instal·lat i té els paquets actualitzats. Afegir i activar els repositoris de retroversions (''backports'') de Debian i Ubuntu ens ajudarà, respectivament, a mantenir les instal·lacions més actualitzades.

= Instal·lació i configuració del servidor web =

Per a l'entorn de desenvolupament farem servir el servidor web [http://www.apache.org/ Apache] i, com que Drupal 7 està escrit en [http://www.php.net PHP], també instal·larem el mòdul de PHP5. La instal·lació afegirà automàticament alguns paquets més, com a dependències dels anteriors.

== Instal·lació del servidor web ==

Instal·lem els paquets necessaris (amb l'usuari ''root'', o bé amb un usuari que tingui els permisos adequats, afegint "sudo" davant de les ordres):

* '''Debian''':
# apt-get install apache2 libapache2-mod-php5
* '''Ubuntu'''
# apt-get install apache2 libapache2-mod-php5
* '''Archlinux''':
# todo

== Configuració del servidor web ==

Un cop acabada la instal·lació, cal configurar el servidor web. Primer, ens assegurem de que el mòdul de PHP5 està activat:
* '''Debian'''
# a2enmod php5
* '''Ubuntu'''
# a2ensmod php5
* '''Archlinux''':
# todo

El servidor web Apache2 pot gestionar diversos ''hosts virtuals'' (i.e. llocs web) alhora, configurant-los en diferents fitxers de la carpeta "''/etc/apache2/sites-available/''" i després activant-los amb l'ordre "''a2ensite nom_del_lloc_web''". Per defecte en ve un d'activat, que es configura al fitxer "''000-default.conf''" i que utilitzarem per mostrar la web de desenvolupament.

Editem el fitxer "'''/etc/apache2/sites-enabled/000-default.conf'''" amb l'editor de text "''nano''" (en podeu fer servir qualsevol altre, si ho preferiu) i canviem la línia

DocumentRoot '''/var/www/html'''

per
DocumentRoot '''/var/www'''

<Directory /var/www/guifi>
AllowOverride All
</Directory>

Sortim de l'editor de text i recarreguem el servidor web Apache2:
* '''Debian'''
# service restart apache2
* '''Ubuntu'''
# service restart apache2
* '''Archlinux''':
# todo

= Instal·lació i configuració de la base de dades =

En aquest entorn de desenvolupament utilitzarem la base de dades [https://www.mysql.com/ MySQL] per emmagatzemar-hi les dades de Drupal i de Guifi. Primer farem la instal·lació i, acte seguit, crearem una base de dades i un usuari per emmagatzemar-hi les dades de Drupal i de la web de Guifi.

== Instal·lació de MySQL ==

Instal·lem el paquet amb el servidor de base de dades MySQL:
* '''Debian / Ubuntu''':
# apt-get install mysql-server

Durant la instal·lació se'ns demanarà posar una contrasenya per a l'usuari "''root''" de la base de dades: és important '''no oblidar-la'''; la farem servir més endavant.

== Configuració de MySQL ==
Un cop instal·lat el paquet de MySQL el servidor està llest i funcionant, però més endavant ens caldrà haver creat una base de dades on emmagatzemar-hi les dades de la web. Aprofitem per fer-ho ara.

El procés consta de diversos passos, explicats a continuació:

* Iniciem una sessió al servidor MySQL amb l'usuari "'''root'''" i la contrasenya que acabem d'establir-hi:
# mysql -u root -p
Enter password: <<escrivim la contrasenya>>
Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 53
Server version: 5.5.46-0+deb8u1 (Debian)

Copyright (c) 2000, 2015, Oracle and/or its affiliates. All rights reserved.

Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

* Creem una base de dades anomenada "'''guifidev'''":
mysql> '''create database guifidev;'''

* Creem un nou usuari de la base de dades, anomenat "'''guifi'''", li assignem una '''contrasenya''' (la que volguem) i li atorguem permisos per modificar la base de dades tot just creada:
mysql> '''grant all on guifidev.* to guifi@localhost identified by 'contrasenya_nou_usuari_guifi';'''

En resum, tenim:
* Nom de la base de dades: '''guifidev'''
* Usuari de la base de dades: '''guifi'''
* Contrasenya de la base de dades: ''la que hagueu escollit''

Aquestes tres dades seran necessàries per poder instal·lar Drupal 7 més endavant.

= [Opcional] Instal·lació d'una interfície web per a la base de dades =

Per al desenvolupament de la web de Guifi, és molt útil disposar d'una interfície web com [https://www.phpmyadmin.net/ phpMyAdmin] per inspeccionar el contingut de la base de dades. L'instal·lem:
* '''Debian'''
# apt-get install phpmyadmin
* '''Ubuntu'''
# apt-get install phpmyadmin
* '''Archlinux''':
# todo
Durant la instal·lació, se'ns demana quin servidor tenim instal·lat al sistema. Marcarem (amb la tecla ''Espai'') el servidor "''apache2''", que acabem d'instal·lar. També se'ns preguntarà si volem "''configurar la base de dades de phpmyadmin amb dbconfig-common''". Respondrem que sí, i aleshores se'ns demanarà per la contrasenya de l'usuari "''root''" de la base de dades que hem introduït anteriorment.

A continuació, abans d'acabar amb la instal·lació del paquet, se'ns demanarà una contrasenya per a l'usuari "''phpmyadmin''" a la base de dades; tal com se suggereix, la podem deixar en blanc i seguir: no la farem servir.

= Instal·lació de Drupal 7 =

Un cop configurat el servidor amb els paquets necessaris, procedim a descarregar, instal·lar i configurar Drupal 7.

== Descàrrega de Drupal 7 ==

Ens dirigim al lloc web de [http://www.drupal.org Drupal] i naveguem fins a l'apartat de [http://www.drupal.org/download descàrregues]. Cliquem [https://www.drupal.org/node/3060/release altres versions (''other releases'')] i cerquem la darrera versió de Drupal 7, que en aquest cas és la [https://www.drupal.org/drupal-7.41-release-notes versió 7.41]. Copiem l'enllaç de baixada en format "''tar.gz''" i el descarreguem al directori "''/var/www''":
# cd /var/www
# wget https://ftp.drupal.org/files/projects/drupal-7.41.tar.gz

El descomprimim i reanomenem la carpeta:
# tar -xf drupal-7.41.tar.gz
# mv drupal-7.41 guifi

== Instal·lació i configuració de Drupal 7 ==

Un cop descomprimit Drupal 7 i reanomenada la carpeta, obrim l'adreça del servidor web amb el navegador: [http://ip_del_servidor/guifi http://ip_del_servidor/guifi]. Si esteu treballant amb la mateixa màquina on heu instal·lat l'entorn de desenvolupament, "''ip_del_servidor''" serà "http://ip_del_servidor/guifi "'''localhost'''"; altrament poseu-hi l'adreça IP que toqui.

La instal·lació i la configuració de Drupal 7 es fa des del navegador web.

=== Elecció d'un perfil (''Choose profile'') ===

El procés d'instal·lació ens mostra dos possibles perfils: "estàndard (''standard'')" i "mínim (''minimal''). Escollim "'''Estàndard''' (''standard'')".

=== Elecció de l'idioma (''Choose language'') ===

La instal·lació per defecte es fa en anglès, però podeu descarregar-vos paquets d'idiomes addicionals o versions de Drupal que ja els incorporen. Escollim "'''Anglès''' (''English'')".

=== Verificació de requisits (''Verify requirements'') ===

Per seguir amb la instal·lació cal crear els següents directoris i fitxers amb els seus respectius permisos:
# cd /var/www/guifi
# mkdir sites/default/files
# chmod a+w sites/default/files
# cp sites/default/default.settings.php sites/default/settings.php
# chmod a+w sites/default/settings.php

Un cop fet, en recarregar la pàgina, continuarem ja al següent pas.

=== Configuració de la base de dades (''Set up database'') ===

En aquest pas configurarem el nom de la base de dades, l'usuari i la contrasenya que hem creat anteriorment, per desar-hi les dades de Drupal i de la web de Guifi. Recuperem les dades introduïdes anteriorment:

* Nom de la base de dades (''Database name''): '''guifidev'''
* Usuari de la base de dades: (''Database username''): '''guifi'''
* Contrasenya de la base de dades: (''Database password''): ''la que haguem escollit anteriorment''

Les introduïm al formulari i procedim amb la instal·lació. Si tot va bé, la pàgina ens informarà del procés d'instal·lació de mòduls, etc. i acabarà en uns segons.

=== Configuració del lloc web (''Configure site''') ===
Abans d'acabar la configuració de Drupal, cal introduir algunes dades més. En primer lloc, la informació bàsica del lloc web:

* '''Informació del lloc (''Site information'')'''
** '''Nom del lloc web (''Site name'')''': ''podeu escollir el nom que més us agradi, com "Desenvolupament Guifi", etc.''
** '''Adreça de correu del lloc web (''Site e-mail address'')''': ''poseu-hi la vostra adreça de correu electrònic -en qualsevol cas, no configurarem el correu electrònic--

A continuació, l'usuari que tindrà permisos per administrar el lloc web:
* '''Compte de manteniment del lloc (''Site maintenance account'')'''
** '''Nom d'usuari (''Username'')''': '''guifi''' ''o un altre, si us convé més'''
** '''Correu electrònic (''E-mail address'')''': ''poseu-hi la vostra adreça de correu electrònic''
** '''Contrasenya (''Password'')''': ''podeu posar-hi la mateixa contrasenya que heu posat anteriorment a la base de dades''

Alguns paràmetres opcionals respecte al servidor web es poden ajustar:
* '''Paràmetres del servidor (''Server settings'')'''
** '''País per defecte (''Default country'')''': ''escolliu el país on us trobeu''
** '''Zona horària per defecte (''Default time zone'')''': ''escolliu la vostra zona horària''

Finalment, configurem les opcions d'actualització:
* '''Notificacions d'actualitzacions (''Update notifications'')'''
** '''País per defecte (''Check for updates automatically '')''': sí'''
** '''Rebre notificacions per correu electrònic (''Receive e-mail notifications '')''': no

=== Restabliment dels permisos dels fitxers de configuració ===
Per acabar, és convenient restablir els permisos dels fitxers creats anteriorment:
# cd /var/www/guifi
# chmod a-w sites/default/files
# chmod a-w sites/default/settings.php

Això deixarà llesta la instal·lació i configuració de Drupal 7.

= Descàrrega i instal·lació del codi font per al desenvolupament de la web de Guifi.net =

El codi font de la web de Guifi.net (és a dir, el codi font dels diferents mòduls per a Drupal es troba al [https://github.com/guifi GitHub de Guifi]. En aquesta secció s'explica com descarregar-lo i integrar-lo a l'entorn de desenvolupament de Drupal 7 que acabem de configurar.

== Instal·lació de Git ==
Utilitzarem [https://git-scm.com/ Git] per clonar el codi font de la web des del repositori de GitHub. Instal·lem els paquets "git" i els requisits:

* Debian / Ubuntu
# apt-get install git

== Descàrrega del codi font de la web de Guifi.net ==
Amb el compte d'usuari normal, clonarem els diferents mòduls de Drupal al directori de l'usuari:
$ cd ~
$ git clone https://github.com/guifi/drupal-guifi.git
$ git clone https://github.com/guifi/drupal-theme_guifinet2011.git
$ <nowiki>[opcional]</nowiki> git clone https://github.com/guifi/drupal-budgets.git

=== Ús de la branca de Drupal 7 ===
Actualment el codi font de la branca "'''master'''" conté el mòdul Guifi per a la versió 6 de Drupal. El '''codi en desenvolupament''' per a Drupal 7 és a la branca '''''drupal7''''. La clonem així:

$ cd drupal-guifi
$ git checkout -b drupal7 origin/drupal7

El mòdul "'''budgets'''" encara no està portat a Drupal 7.

== Instal·lació i activació del mòdul drupal-guifi a Drupal ==
Des del terminal, amb l'usuari "'''root'''" o posant l'ordre "'''sudo'''" davant, enllaçarem els mòduls i el tema de Guifi a la carpeta "'''sites/all/modules'''" i "'''sites/all/themes'''"Drupal:
# cd /var/www/guifi/sites/all/modules
# ln -s ~<<nom_de_l'usuari_normal>>/drupal-guifi guifi
# <nowiki>[opcional]</nowiki> ln -s ~<<nom_de_l'usuari_normal>>/drupal-budgets budgets
# cd /var/www/guifi/sites/all/themes
# ln -s ~<<nom_de_l'usuari_normal>>/drupal-theme_guifinet2011 guifinet2011

Amb el navegador web, iniciem sessió amb l'usuari d'administració que hem creat i accedim a l'apartat "Modules" de Drupal (http://ip_del_servidor/guifi/?q=admin/modules). Al final de tot hi trobarem el mòdul "'''guifi.net'''", que activarem.

[[Categoria:desenvolupament]]

Entorn de desenvolupament de Guifi.net basat en Drupal 7

2016-01-14T13:13:47Z

Rogerpueyo: /* Configuració del lloc web (Configure site') */

Entorn de desenvolupament de Guifi.net basat en Drupal 7

2016-01-14T12:56:09Z

Rogerpueyo: /* Configuració de la base de dades (Set up database) */

Entorn de desenvolupament de Guifi.net basat en Drupal 7

2016-01-14T12:40:33Z

Rogerpueyo: /* Configuració de MySQL */

Entorn de desenvolupament de Guifi.net basat en Drupal 7

2016-01-14T12:38:24Z

Rogerpueyo: /* Instal·lació i configuració de la base de dades */

Entorn de desenvolupament de Guifi.net basat en Drupal 7

2016-01-14T12:28:11Z

Rogerpueyo: /* Verificació de requisits (Verify requirements) */

Entorn de desenvolupament de Guifi.net basat en Drupal 7

2016-01-14T12:22:57Z

Rogerpueyo: Requisists drupal 7

Entorn de desenvolupament de Guifi.net basat en Drupal 7

2016-01-14T12:04:18Z

Rogerpueyo: /* = Descàrrega de Drupal 7 */

Entorn de desenvolupament de Guifi.net basat en Drupal 7

2016-01-14T12:03:59Z

Rogerpueyo:

Entorn de desenvolupament de Guifi.net basat en Drupal 7

2016-01-14T11:54:46Z

Rogerpueyo: /* Instal·lació i configuració de la base de dades */

Entorn de desenvolupament de Guifi.net basat en Drupal 7

2016-01-14T11:44:58Z

Rogerpueyo: /* Configuració */

Entorn de desenvolupament de Guifi.net basat en Drupal 7

2016-01-14T11:44:50Z

Rogerpueyo: /* Instal·lació */

Entorn de desenvolupament de Guifi.net basat en Drupal 7

2016-01-14T11:44:39Z

Rogerpueyo: /* Instal·lació i configuració del servidor web */

Entorn de desenvolupament de Guifi.net basat en Drupal 7

2016-01-14T11:43:58Z

Rogerpueyo: Base de dades

Entorn de desenvolupament de Guifi.net basat en Drupal 7

2016-01-14T11:00:21Z

Rogerpueyo: Typo

Entorn de desenvolupament de Guifi.net basat en Drupal 7

2016-01-14T10:08:32Z

Rogerpueyo: Retroversions

Entorn de desenvolupament de Guifi.net basat en Drupal 7

2016-01-14T10:04:56Z

Rogerpueyo: Resum del procés

Entorn de desenvolupament de Guifi.net basat en Drupal 7

2016-01-14T09:53:54Z

Rogerpueyo: Requisitis del servidor

Fitxer:Druplicon-large.png

2016-01-14T09:43:18Z

Rogerpueyo: Druplicon (large)

Druplicon (large)

Entorn de desenvolupament de Guifi.net basat en Drupal 7

2016-01-13T17:52:39Z

Rogerpueyo: Creat esborrany

Preparant l'entorn de desenvolupament

2015-12-23T13:55:00Z

Rogerpueyo: Typo

Aquest document documenta com preparar un entorn de desenvolupament per col·laborar en el desenvolupament de la web de guifi.net.

Ens centrarem al mòdul "'''drupal-guifi'''", que és el fonamental de tota la gestió a la [[web de guifi.net]], però l'entorn muntat pot fer-se servir per desenvolupar altres mòduls o temes, com per exemple "'''budgets'''" i "'''theme_guifinet2011'''".

= Instalació i configuracó de la base =
Per fer funcionar [[Drupal]] a la màquina de desenvolupament cal posar en marxa un [[servidor web]], el mòdul [[PHP]] pel servidor web i un servidor de base de dades, recomanat [[MySQL]].

En funció del nostre sistema operatiu i les nostres preferències, la instalació d'aquests serveis es realitzarà d'una manera o d'una altra. A continuació es detalla pels entorns '''Debian/Ubuntu''' amb '''Apache+PHP+Mysql''' i '''Archlinux''' amb '''Nginx+PHP+Mysql'''. Totes dues instalacions són simples.

* Debian/Ubuntu:
$ sudo apt-get install mysql-server libapache2-mod-php5 php5-gd php5-mysql

* Archlinux:
$ pacman -S nginx mysql php-fpm php-gd

Documentació per a Archlinux: [https://wiki.archlinux.org/index.php/Apache,_PHP,_and_MySQL Apache, PHP and MySQL], [https://wiki.archlinux.org/index.php/Nginx Nginx]

La configuració del servidor web (Apache/lighttpd/nginx) per a fer que funcioni el mòdul de PHP a l'arrel del nostre directori web depèn del nostre sistema.

== Configuració de l'arxiu php.ini ==
Cal tenir activats els següents mòduls a l'arxiu php.ini:

extension=mysql.so
extension=iconv.so
extension=gd.so

Cal testejar si el sistema interpreta arxius PHP. Per això, es pot crear un arxiu al DOCUMENT_ROOT '''(generalment /var/www)''' del servidor web. Si no funciona reviseu els passos anteriors i consulteu la documentació de la vostra distribució.

<?php
phpinfo();
?>

== Configuració de fitxers ==
Per tal de no tenir problemes en la nostra instal·lació de l'entorn de desenvolupament, es necessari realitzar algunes modificacions dins d'uns fitxers concrets els quals esmentarem per tal de que tot funcioni correctament:

En l'adreça següent:
/etc/apache2/sites-enabled/

Hi tenim un únic fitxer el qual es diu '000-default'. Mitjançant un editor de text de shell (vi/nano) editarem el fitxer:

$ vi 000-default

Dins del fitxer, hem de buscar el següent text: 'Allow Override None' en tot el text i substituir-lo per 'Allow Override All'. Per realitzar la modificació, mitjançant les fletxes de direcció ens situarem sobre la línia en qüestió i apretarem la tecla 'i' la qual ens permetrà escriure. Si es presenten problemes, sembre es pot sortir del fitxer sense desar mitjançant la tecla 'ESC' seguit de la comanda ':q!' <quit without saving> << sortir sense guardar.

$ nano 000-default

Fem l'edició i sortim desant Ctrl+X

== Preparació de les Clean URL ==

La nostra web amb drupal necessita fer servir '''Clean URL''' i per tal que aquestes es puguin aplicar es necessari tenir activat el mòdul '''rewrite'''. Per tal d'activar aquest mòdul, utilitzarem les comandes següents:

a2enmod rewrite

Ens informarà que el mòdul està actiu i que s'haurà de reiniciar el servei, cosa que farem amb la comanda:

/etc/init.d/apache2 restart
o bé
service apache2 restart

= Descarregant el codi font =
El codi dels mòduls "drupal-guifi", "drupal-bugdets" i "theme_guifinet2011" són [[programari lliure]] i estan allotjats als [[repositoris]] de Gitorious. Els repositoris són útils pel desenvolupament de programari però nosaltres ens limitarem a clonar-los.

La idea és que hi ha el repositori de cada un dels mòduls i el tema, cada desenvolupador té una còpia del repositori també a Gitorious, d'aquesta manera instal·larà la seva còpia a la seva màquina de desenvolupament, realitzarà el desenvolupament a la seva màquina i un cop el desenvolupament és correcte, enviarà els canvis a la seva còpia de Gitorious i demanarà incloure'ls al repositori principal.

== Requisits pel clonatge del repositori drupal-guifi a la còpia del desenvolupador a Gitorious ==
Haurem de fer un fork del projecte "drupal-guifi" de cara a realitzar alguna modificació sobre el seu codi font.

* Crear-se un compte a [http://gitorious.org Gitorious].
* Crear unes claus SSH (ssh-keygen) sense contrasenya a l'ordinador de treball i s'afegiran al perfil d'usuari de gitorious. Per exemple:

ssh-keygen

Generating public/private rsa key pair.
Enter file in which to save the key (/home/dave/.ssh/id_rsa):
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /home/dave/.ssh/id_rsa.
Your public key has been saved in /home/dave/.ssh/id_rsa.pub.

* Accedir a la pàgina del projecte "[https://gitorious.org/guifi/drupal-guifi drupal-guifi]".
* Clonar el projecte. Amb això ja tindrem un fork del projecte sobre el que podem realitzar els nostres canvis.

Pàgines web a Gitorious dels projectes amb les que podem participar en el desenvolupament:
* https://gitorious.org/guifi/drupal-guifi
* https://gitorious.org/guifi/drupal-budgets
* https://gitorious.org/guifi-web/theme_guifinet2011

Amb això tindrem una còpia de l'original a l'espai del desenvolupador a Gitorious.

= Descàrrega, instalació i configuració de l'entorn Drupal =

Al principi hem instal·lats els serveis bàsics a la nostra màquina de desenvolupament i hem clonat els repositoris de codi font amb els que volem treballar, hem de posar en funcionant a la màquina de desenvolupament el Drupal 6.x (amb alguns mòduls adicionals), ja que així podrem veure i testejar els canvis que anem fent al nostre repositori de "drupal-guifi".

== Descàrregues des de la línea de comandes ==

* La darrera versió de Drupal 6 (6.37):

wget http://ftp.drupal.org/files/projects/drupal-6.37.tar.gz

i habilitar l'accès via web:

ln -s /usr/share/drupal6/ /var/www/guifi

* Els Mòduls de Drupal fonamentals:
Que els descarregarem a /var/www/drupal-6.37/sites/all/modules

'''Mòdul WebForm:'''
wget http://ftp.drupal.org/files/projects/webform-6.x-3.23.tar.gz

'''Mòdul Views:'''
wget http://ftp.drupal.org/files/projects/views-6.x-2.18.tar.gz

'''Mòdul Views_slideshow:'''
wget http://ftp.drupal.org/files/projects/views_slideshow-6.x-2.4.tar.gz

'''Mòdul Internationalization (i18n) <Multi-idioma>:'''
wget http://ftp.drupal.org/files/projects/i18n-6.x-1.10.tar.gz

* Els Mòduls de Drupal opcionals:

'''Mòdul schema:'''
wget http://ftp.drupal.org/files/projects/schema-6.x-1.7.tar.gz

'''Mòdul devel:'''
wget http://ftp.drupal.org/files/projects/devel-6.x-1.28.tar.gz

'''Mòdul Translation template extractor (potx):'''
wget http://ftp.drupal.org/files/projects/potx-6.x-3.3.tar.gz

'''Mòdul Localization client (l10n client):'''
wget http://ftp.drupal.org/files/projects/l10n_client-6.x-2.2.tar.gz

'''Mòdul language (???):'''
wget ???

'''Mòdul icons (Language icons???):'''
wget http://ftp.drupal.org/files/projects/languageicons-6.x-2.1.tar.gz ???

'''Mòdul language_sections:'''
wget http://ftp.drupal.org/files/projects/language_sections-6.x-2.5.tar.gz

'''Mòdul diff:'''
wget http://ftp.drupal.org/files/projects/diff-6.x-2.3.tar.gz

'''Mòdul captcha:'''
wget http://ftp.drupal.org/files/projects/captcha-6.x-2.7.tar.gz

'''Mòdul captcha_pack:'''
wget http://ftp.drupal.org/files/projects/captcha_pack-6.x-1.0-beta3.tar.gz

'''Mòdul event:'''
wget http://ftp.drupal.org/files/projects/event-6.x-2.x-dev.tar.gz

'''Mòdul cck:'''
wget http://ftp.drupal.org/files/projects/cck-6.x-2.10.tar.gz

'''Mòdul fckeditor:'''
wget http://ftp.drupal.org/files/projects/fckeditor-6.x-2.4.tar.gz

'''Mòdul image:'''
wget http://ftp.drupal.org/files/projects/image-6.x-1.2.tar.gz

'''Mòdul image_filter:'''
wget http://ftp.drupal.org/files/projects/image_filter-6.x-1.0.tar.gz

'''Mòdul fivestar'''
wget http://ftp.drupal.org/files/projects/fivestar-6.x-1.21.tar.gz

'''Mòdul votingapi'''
wget http://ftp.drupal.org/files/projects/votingapi-6.x-2.3.tar.gz

* Mòduls desenvolupats per la comunitat Guifi.net:

- Mòdul budgets

- Mòdul guifi

* El tema oficial "theme_guifinet2011":

* La base de dades actual de desenvolupament de la web de guifi.net:

wget http://www.guifi.net/guifi66_devel.sql.gz

== Instalació de Drupal ==

Hem de posar en marxa un entorn Drupal bàsic i posteriorment sobreescriurem la base de dades amb la que hem descarregat prèviament de Guifi.net

Aquests són els passos bàsics per a instal·lar i configurar un site Drupal:

* Descomprimim el paquet de Drupal que ens hem descarregat i el posem accesible al DOCUMENT_ROOT d'Apache:

cd /var/www
tar zxvf drupal-6.29.tar.gz
ln -s drupal-6.29 guifi

* Iniciem el procés d'instalació via web de Drupal accedint a http://<ip_del_teu_servidor>/guifi exemples:

http://10.138.71.10/guifi

http://localhost/guifi

* En arribar a l'apartat de configuració de la base de dades, necessitarem tenir creada una base de dades local de MySQL per a desenvolupament:

[dave@inuik http]$ mysql -u <nomusuari> -p <contrassenya> << és possible que amb root no faci falta una password

exemple:

mysql -u root -p <salt de linia>
Enter password: <escritura_de_la_password>

Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 525
Server version: 5.5.31-0+wheezy1 (Debian)

Copyright (c) 2000,2013, Oracle and/or its affiliates. All rights reserved.
Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql> create database guifi_test;
Query OK, 1 row affected (0.00 sec)

mysql> grant all on guifi_test.* to guifi@localhost identified by 'guifinet';
Query OK, 0 rows affected (0.00 sec)

Ja podem introduir la informació de connexió a la base de dades per a que Drupal creï les taules necessàries.

== Instal·lació dels mòduls de Drupal necessaris per a engegar l'entorn ==

Dins de l'adreça /var/www/drupal-6.29/sites/all/modules, on tindrem descarregats els nostres mòduls, els descomprimirem mitjançant la ordre:

tar zxvf <nom_del_fitxer_a_descomprimir>

per exemple:

tar zxvf i18n-6.x-1.10.tar.gz

'''ATENCIÓ'''. Fixeu-vos que el mòdul "drupal-guifi" que estem clonant no és el repositori principal que hi ha a Gitorious, sinó el que hem creat fent un fork del projecte principal. Així els canvis que fem els podrem pujar a Gitorious al repositori nostre com a desenvolupadors, per a posteriorment, si ho considerem convenient, notificar el canvi als desenvolupadors principals per a que els puguin integrar a la branca principal de desenvolupament, això es fa des del mateix Gitorious amb un ''merge request''.

mkdir drupal-6.29/sites/all/modules
cd drupal-6.29/sites/all/modules
git clone git://gitorious.org/guifi/drupal-budgets.git budgets
# Clonat del MEU FORK del mòdul "drupal-guifi"
git clone git@gitorious.org:~tombatossals/guifi/tombatossalss-drupal-guifi.git guifi (canvia "~tombatossals/guifi/tombatossalss-drupal-guifi.git" pel teu repositori clonat a Gitorious)

== Instalació de la base de dades de desenvolupament de Guifi.net ==

Tenint una instal·lació neta de Drupal, anem a sobreescriure la base de dades amb la informació de les taules de la base de dades de Guifi.net, el que ens proporcionarà un entorn de desenvolupament similar a la web en producció. Des de la carpeta on anteriorment hem baixat la base de dades cal fer:

gunzip guifi66_devel.sql.gz

mysql -u root -p guifi_test < guifi66_devel.sql; << recordem que les comandes dins de MySQL s'acaben amb un ';'

== Afinant la instalació ==

Un cop realitzada la instal·lació, s'ha d'editar el fitxer .htaccess, que es troba dins de la carpeta arrel de drupal :

cd /var/www/drupal-6.29
ls -la << per mostrar llistats tots els fitxers inclosos els ocults

Ens mostrarà un arxiu ocult anomenat : .htaccess
L'editarem mitjançant un editor de text:

vi .htaccess

En una linia buida del fitxer, apretarem la 'i' per escriure-hi i afegirem la següent linia: RewriteBase /drupal-6.29

Un cop instalada la base de dades amb tota la informació de la web de Guifi.net, tindrem accés a la informació de qualsevol node o zona de la web principal. Per a loguejar-te com usuari, has de fer servir el nom d'usuari corresponent i la contrasenya genèrica "guifi".

L'usuari administrador serà "webmestre" i la contrasenya "guifi".

'''Alguns consells per a refinar la instalació:'''

* Creeu i comproveu que els directoris "files", "files/nanostation" i "tmp" del directori de instalació de drupal tenen permisos de escriptura per l'usuari del servidor web (o poseu-los a 777):
mkdir drupal-6.29/{files,files/nanostation,tmp}
chmod 777 drupal-6.29/{files,files/nanostation,tmp}

* La carpeta "files/nanostation" contendrà els arxius "unsolclic" de les antenes Ubiquiti que anem consultant o creant.

* Protegiu la carpeta "files" i "tmp" amb el seu respectiu fixter .htaccess
A la carpeta "files" el ftixer .htaccess ha de incloure aquest contingut:

# Turn off all options we don't need.
Options None
Options +FollowSymLinks
# Set the catch-all handler to prevent scripts from being executed.
SetHandler Drupal_Security_Do_Not_Remove_See_SA_2006_006
<Files *>
# Override the handler again if we're run later in the evaluation list.
SetHandler Drupal_Security_Do_Not_Remove_See_SA_2013_003
</Files>
# If we know how to do it safely, disable the PHP engine entirely.
<IfModule mod_php5.c>
php_flag engine off
</IfModule>
# PHP 4, Apache 1.
<IfModule mod_php4.c>
php_flag engine off
</IfModule>
# PHP 4, Apache 2.
<IfModule sapi_apache2.c>
php_flag engine off
</IfModule>

I a la carpeta "tmp", el fitxer .htaccess ha de ser exactament el mateix que el de "files" pero hi hem d'afegir al final de tot això:

Deny from all

* Editeu el fitxer robots.txt, elimineu-ne tot el contingut i afegiu únicament aquestes linies, doncs no ens interessa que els robots indexin el nostre entorn local.

User-agent: *
Disallow: /

* Comproveu els possibles errors de instalació de Drupal accedint com usuari "webmestre" a la pàgina de administració i, des d'allà, a la pàgina de "Report Status". Ex: http://localhost/guifi/ca/admin/reports/status

* Accediu a la secció de configuració de "Performance" y deshabiliteu tot l'usatge de caché, optimització y compressió. Ens interessa que els canvis que fem sobre els arxius s'actualitzin en temps real. La URL d'accés a aquesta configuració serà de l'estil de: http://localhost/guifi/admin/settings/performance

== Instalació del tema Guifi.net al Drupal ==

mkdir drupal-6.29/sites/all/themes
cd drupal-6.29/sites/all/themes
git clone git://gitorious.org/guifi-web/theme_guifinet2011.git

El tema no s'activarà inmediatament, ja que li mancaran els arxius d'estils que Drupal creu que esten cachejats al sistema. Per a aconseguir que el tema s'activi completament, haurem d'accedir a l'"administració de temes", "configuració del tema de guifinet2011" i "desar" sense tocar cap opció. El tema per fi estarà activat.

Per visualitzar les imatges de la portada cal haver instal·lat els mòduls opcionals d'imatges i descarregar a:

$ cd /var/www/drupal-6.29/files/images

les següents imatges que es poden descarregar des de la línia de comandes:

wget http://guifi.net/files/images/el_molar_v2.jpg
wget http://guifi.net/files/images/platadaro_910x454.jpg
wget http://guifi.net/files/images/antenes2.jpg
wget http://guifi.net/files/images/dsc07219_910x454_v2.jpg
wget http://guifi.net/files/images/puigcubell_portada.jpg
wget http://guifi.net/files/images/taller_fibra1.jpg
wget http://guifi.net/files/images/DSC08889_910x454_v2.jpg
wget http://guifi.net/files/images/20246_910x454_v2.jpg
wget http://guifi.net/files/images/illes_910x454.jpg
wget http://guifi.net/files/images/cel-bcn-portada.jpg

== Instal·lació dels idiomes ==

La base de dades de Guifi.net que hem importat té habilitats varis idiomes per defecte, però les traduccions no estan instalades al sistema. Per a solucionar-ho, seguim aquests passos:

* Descarregueu la traducció de l'idioma de aquí: http://localize.drupal.org/.

Per exemple: http://ftp.drupal.org/files/translations/6.x/drupal/drupal-6.29.ca.po

* Aneu a la administració de idiomes de la vostra instalació com ''webmestre'', està localitzada a /admin/settings/language, i fixeu-vos que hi ha un enllaç per a importació manual dels strings de traducció: /admin/build/translate/import

* Indiqueu-li l'idioma de l'arxiu que heu descarregat e importeu-lo. A partir d'aquí ja tindrem l'interfície traduïda.

= Començant a treballar =

Ja tenim un entorn preparat per començar a modificar els mòduls de Drupal, pujar-los al nostre propi repositori i, si ho considerem convenient, notificar els nostres commits als desenvolupadors per a que els integrin a la branca principal.

Per a fer commit dels nostres canvis:

cd drupal-6.29/site/all/modules/guifi
# Fem modificacions a alguns arxius, les enregistrem al nostre repositori de treball i procedirem a pujar-les a Gitorious
git commit -a
git push

Posteriorment, des de la web de Gitorious podrem fer servir un "Merge request" per notificar als desenvolupadors alguna de les nostres modificacions i que valorin la seva incorporació al repositori principal.

== Actualitzant el nostre repositori amb els canvis del repositori pare ==

Si volem mantenir el nostre repositori actualitzat amb els darrers canvis que es van produint al repositori pare, haurem de seguir la següent recepta:

# Definim com repositori remot anomenat "upstream" el repositori de "drupal-guifi"
git remote add upstream git://gitorious.org/guifi/drupal-guifi.git

# Obtenim els darrers canvis del nostre repositori
git fetch origin -v

# Obtenim els darrers canvis del repositori pare
git fetch upstream -v

# Fem el merge dels canvis obtinguts
git merge upstream/master

== Referències ==

{{MM|url=https://lists.guifi.net/pipermail/guifi-webdev/2012-February/001750.html|list=webdev}}

== Enllaços externs ==

* http://acacha.org/mediawiki/index.php/Entorn_de_desenvolupament_guifi

[[Categoria:desenvolupament]]

Preparant l'entorn de desenvolupament

2015-12-23T11:48:12Z

Rogerpueyo: Actualització dels enllaços

Aquest document documenta com preparar un entorn de desenvolupament per col·laborar en el desenvolupament de la web de guifi.net.

Ens centrarem al mòdul "'''drupal-guifi'''", que és el fonamental de tota la gestió a la [[web de guifi.net]], però l'entorn muntat pot fer-se servir per desenvolupar altres mòduls o temes, com per exemple "'''budgets'''" i "'''theme_guifinet2011'''".

= Instalació i configuracó de la base =
Per fer funcionar [[Drupal]] a la màquina de desenvolupament cal posar en marxa un [[servidor web]], el mòdul [[PHP]] pel servidor web i un servidor de base de dades, recomanat [[MySQL]].

En funció del nostre sistema operatiu i les nostres preferències, la instalació d'aquests serveis es realitzarà d'una manera o d'una altra. A continuació es detalla pels entorns '''Debian/Ubuntu''' amb '''Apache+PHP+Mysql''' i '''Archlinux''' amb '''Nginx+PHP+Mysql'''. Totes dues instalacions són simples.

* Debian/Ubuntu:
$ sudo apt-get install mysql-server libapache2-mod-php5 php5-gd php5-mysql

* Archlinux:
$ pacman -S nginx mysql php-fpm php-gd

Documentació per a Archlinux: [https://wiki.archlinux.org/index.php/Apache,_PHP,_and_MySQL Apache, PHP and MySQL], [https://wiki.archlinux.org/index.php/Nginx Nginx]

La configuració del servidor web (Apache/lighttpd/nginx) per a fer que funcioni el mòdul de PHP a l'arrel del nostre directori web depèn del nostre sistema.

== Configuració de l'arxiu php.ini ==
Cal tenir activats els següents mòduls a l'arxiu php.ini:

extension=mysql.so
extension=iconv.so
extension=gd.so

Cal testejar si el sistema interpreta arxius PHP. Per això, es pot crear un arxiu al DOCUMENT_ROOT '''(generalment /var/www)''' del servidor web. Si no funciona reviseu els passos anteriors i consulteu la documentació de la vostra distribució.

<?php
phpinfo();
?>

== Configuració de fitxers ==
Per tal de no tenir problemes en la nostra instal·lació de l'entorn de desenvolupament, es necessari realitzar algunes modificacions dins d'uns fitxers concrets els quals esmentarem per tal de que tot funcioni correctament:

En l'adreça següent:
/etc/apache2/sites-enabled/

Hi tenim un únic fitxer el qual es diu '000-default'. Mitjançant un editor de text de shell (vi/nano) editarem el fitxer:

$ vi 000-default

Dins del fitxer, hem de buscar el següent text: 'Allow Override None' en tot el text i substituir-lo per 'Allow Override All'. Per realitzar la modificació, mitjançant les fletxes de direcció ens situarem sobre la línia en qüestió i apretarem la tecla 'i' la qual ens permetrà escriure. Si es presenten problemes, sembre es pot sortir del fitxer sense desar mitjançant la tecla 'ESC' seguit de la comanda ':q!' <quit without saving> << sortir sense guardar.

$ nano 000-default

Fem l'edició i sortim desant Ctrl+X

== Preparació de les Clean URL ==

La nostra web amb drupal necessita fer servir '''Clean URL''' i per tal que aquestes es puguin aplicar es necessari tenir activat el mòdul '''rewrite'''. Per tal d'activar aquest mòdul, utilitzarem les comandes següents:

a2enmod rewrite

Ens informarà que el mòdul està actiu i que s'haurà de reiniciar el servei, cosa que farem amb la comanda:

/etc/init.d/apache2 restart
o bé
service apache2 restart

= Descarregant el codi font =
El codi dels mòduls "drupal-guifi", "drupal-bugdets" i "theme_guifinet2011" són [[programari lliure]] i estan allotjats als [[repositoris]] de Gitorious. Els repositoris són útils pel desenvolupament de programari però nosaltres ens limitarem a clonar-los.

La idea és que hi ha el repositori de cada un dels mòduls i el tema, cada desenvolupador té una còpia del repositori també a Gitorious, d'aquesta manera instal·larà la seva còpia a la seva màquina de desenvolupament, realitzarà el desenvolupament a la seva màquina i un cop el desenvolupament és correcte, enviarà els canvis a la seva còpia de Gitorious i demanarà incloure'ls al repositori principal.

== Requisits pel clonatge del repositori drupal-guifi a la còpia del desenvolupador a Gitorious ==
Haurem de fer un fork del projecte "drupal-guifi" de cara a realitzar alguna modificació sobre el seu codi font.

* Crear-se un compte a [http://gitorious.org Gitorious].
* Crear unes claus SSH (ssh-keygen) sense contrasenya a l'ordinador de treball i s'afegiran al perfil d'usuari de gitorious. Per exemple:

ssh-keygen

Generating public/private rsa key pair.
Enter file in which to save the key (/home/dave/.ssh/id_rsa):
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /home/dave/.ssh/id_rsa.
Your public key has been saved in /home/dave/.ssh/id_rsa.pub.

* Accedir a la pàgina del projecte "[https://gitorious.org/guifi/drupal-guifi drupal-guifi]".
* Clonar el projecte. Amb això ja tindrem un fork del projecte sobre el que podem realitzar els nostres canvis.

Pàgines web a Gitorious dels projectes amb les que podem participar en el desenvolupament:
* https://gitorious.org/guifi/drupal-guifi
* https://gitorious.org/guifi/drupal-budgets
* https://gitorious.org/guifi-web/theme_guifinet2011

Amb això tindrem una còpia de l'original a l'espai del desenvolupador a Gitorious.

= Descàrrega, instalació i configuració de l'entorn Drupal =

Al principi hem instal·lats els serveis bàsics a la nostra màquina de desenvolupament i hem clonat els repositoris de codi font amb els que volem treballar, hem de posar en funcionant a la màquina de desenvolupament el Drupal 6.x (amb alguns mòduls adicionals), ja que així podrem veure i testejar els canvis que anem fent al nostre repositori de "drupal-guifi".

== Descàrregues des de la línea de comandes ==

* La darrera versió de Drupal 6 (6.37):

wget http://ftp.drupal.org/files/projects/drupal-6.37.tar.gz

i habilitar l'accès via web:

ln -s /usr/share/drupal6/ /var/www/guifi

* Els Mòduls de Drupal fonamentals:
Que els descarregarem a /var/www/drupal-6.37/sites/all/modules

'''Mòdul WebForm:'''
wget http://ftp.drupal.org/files/projects/webform-6.x-3.23.tar.gz

'''Mòdul Views:'''
wget http://ftp.drupal.org/files/projects/views-6.x-2.18.tar.gz

'''Mòdul Views_slideshow:'''
wget http://ftp.drupal.org/files/projects/views_slideshow-6.x-2.4.tar.gz

'''Mòdul Internationalization (i18n) <Multi-idioma>:'''
wget http://ftp.drupal.org/files/projects/i18n-6.x-1.10.tar.gz

* Els Mòduls de Drupal opcionals:

'''Mòdul schema:'''
wget http://ftp.drupal.org/files/projects/schema-6.x-1.7.tar.gz

'''Mòdul devel:'''
wget http://ftp.drupal.org/files/projects/devel-6.x-1.28.tar.gz

'''Mòdul Translation template extractor (potx):'''
wget http://ftp.drupal.org/files/projects/potx-6.x-3.3.tar.gz

'''Mòdul Localization client (l10n client):'''
wget http://ftp.drupal.org/files/projects/l10n_client-6.x-2.2.tar.gz

'''Mòdul language (???):'''
wget ???

'''Mòdul icons (Language icons???):'''
¿¿¿ wget http://ftp.drupal.org/files/projects/languageicons-6.x-2.1.tar.gz ???

'''Mòdul language_sections:'''
wget http://ftp.drupal.org/files/projects/language_sections-6.x-2.5.tar.gz

'''Mòdul diff:'''
wget http://ftp.drupal.org/files/projects/diff-6.x-2.3.tar.gz

'''Mòdul captcha:'''
wget http://ftp.drupal.org/files/projects/captcha-6.x-2.7.tar.gz

'''Mòdul captcha_pack:'''
wget http://ftp.drupal.org/files/projects/captcha_pack-6.x-1.0-beta3.tar.gz

'''Mòdul event:'''
wget http://ftp.drupal.org/files/projects/event-6.x-2.x-dev.tar.gz

'''Mòdul cck:'''
wget http://ftp.drupal.org/files/projects/cck-6.x-2.10.tar.gz

'''Mòdul fckeditor:'''
wget http://ftp.drupal.org/files/projects/fckeditor-6.x-2.4.tar.gz

'''Mòdul image:'''
wget http://ftp.drupal.org/files/projects/image-6.x-1.2.tar.gz

'''Mòdul image_filter:'''
wget http://ftp.drupal.org/files/projects/image_filter-6.x-1.0.tar.gz

'''Mòdul fivestar'''
wget http://ftp.drupal.org/files/projects/fivestar-6.x-1.21.tar.gz

'''Mòdul votingapi'''
wget http://ftp.drupal.org/files/projects/votingapi-6.x-2.3.tar.gz

* Mòduls desenvolupats per la comunitat Guifi.net:

- Mòdul budgets

- Mòdul guifi

* El tema oficial "theme_guifinet2011":

* La base de dades actual de desenvolupament de la web de guifi.net:

wget http://www.guifi.net/guifi66_devel.sql.gz

== Instalació de Drupal ==

Hem de posar en marxa un entorn Drupal bàsic i posteriorment sobreescriurem la base de dades amb la que hem descarregat prèviament de Guifi.net

Aquests són els passos bàsics per a instal·lar i configurar un site Drupal:

* Descomprimim el paquet de Drupal que ens hem descarregat i el posem accesible al DOCUMENT_ROOT d'Apache:

cd /var/www
tar zxvf drupal-6.29.tar.gz
ln -s drupal-6.29 guifi

* Iniciem el procés d'instalació via web de Drupal accedint a http://<ip_del_teu_servidor>/guifi exemples:

http://10.138.71.10/guifi

http://localhost/guifi

* En arribar a l'apartat de configuració de la base de dades, necessitarem tenir creada una base de dades local de MySQL per a desenvolupament:

[dave@inuik http]$ mysql -u <nomusuari> -p <contrassenya> << és possible que amb root no faci falta una password

exemple:

mysql -u root -p <salt de linia>
Enter password: <escritura_de_la_password>

Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 525
Server version: 5.5.31-0+wheezy1 (Debian)

Copyright (c) 2000,2013, Oracle and/or its affiliates. All rights reserved.
Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql> create database guifi_test;
Query OK, 1 row affected (0.00 sec)

mysql> grant all on guifi_test.* to guifi@localhost identified by 'guifinet';
Query OK, 0 rows affected (0.00 sec)

Ja podem introduir la informació de connexió a la base de dades per a que Drupal creï les taules necessàries.

== Instal·lació dels mòduls de Drupal necessaris per a engegar l'entorn ==

Dins de l'adreça /var/www/drupal-6.29/sites/all/modules, on tindrem descarregats els nostres mòduls, els descomprimirem mitjançant la ordre:

tar zxvf <nom_del_fitxer_a_descomprimir>

per exemple:

tar zxvf i18n-6.x-1.10.tar.gz

'''ATENCIÓ'''. Fixeu-vos que el mòdul "drupal-guifi" que estem clonant no és el repositori principal que hi ha a Gitorious, sinó el que hem creat fent un fork del projecte principal. Així els canvis que fem els podrem pujar a Gitorious al repositori nostre com a desenvolupadors, per a posteriorment, si ho considerem convenient, notificar el canvi als desenvolupadors principals per a que els puguin integrar a la branca principal de desenvolupament, això es fa des del mateix Gitorious amb un ''merge request''.

mkdir drupal-6.29/sites/all/modules
cd drupal-6.29/sites/all/modules
git clone git://gitorious.org/guifi/drupal-budgets.git budgets
# Clonat del MEU FORK del mòdul "drupal-guifi"
git clone git@gitorious.org:~tombatossals/guifi/tombatossalss-drupal-guifi.git guifi (canvia "~tombatossals/guifi/tombatossalss-drupal-guifi.git" pel teu repositori clonat a Gitorious)

== Instalació de la base de dades de desenvolupament de Guifi.net ==

Tenint una instal·lació neta de Drupal, anem a sobreescriure la base de dades amb la informació de les taules de la base de dades de Guifi.net, el que ens proporcionarà un entorn de desenvolupament similar a la web en producció. Des de la carpeta on anteriorment hem baixat la base de dades cal fer:

gunzip guifi66_devel.sql.gz

mysql -u root -p guifi_test < guifi66_devel.sql; << recordem que les comandes dins de MySQL s'acaben amb un ';'

== Afinant la instalació ==

Un cop realitzada la instal·lació, s'ha d'editar el fitxer .htaccess, que es troba dins de la carpeta arrel de drupal :

cd /var/www/drupal-6.29
ls -la << per mostrar llistats tots els fitxers inclosos els ocults

Ens mostrarà un arxiu ocult anomenat : .htaccess
L'editarem mitjançant un editor de text:

vi .htaccess

En una linia buida del fitxer, apretarem la 'i' per escriure-hi i afegirem la següent linia: RewriteBase /drupal-6.29

Un cop instalada la base de dades amb tota la informació de la web de Guifi.net, tindrem accés a la informació de qualsevol node o zona de la web principal. Per a loguejar-te com usuari, has de fer servir el nom d'usuari corresponent i la contrasenya genèrica "guifi".

L'usuari administrador serà "webmestre" i la contrasenya "guifi".

'''Alguns consells per a refinar la instalació:'''

* Creeu i comproveu que els directoris "files", "files/nanostation" i "tmp" del directori de instalació de drupal tenen permisos de escriptura per l'usuari del servidor web (o poseu-los a 777):
mkdir drupal-6.29/{files,files/nanostation,tmp}
chmod 777 drupal-6.29/{files,files/nanostation,tmp}

* La carpeta "files/nanostation" contendrà els arxius "unsolclic" de les antenes Ubiquiti que anem consultant o creant.

* Protegiu la carpeta "files" i "tmp" amb el seu respectiu fixter .htaccess
A la carpeta "files" el ftixer .htaccess ha de incloure aquest contingut:

# Turn off all options we don't need.
Options None
Options +FollowSymLinks
# Set the catch-all handler to prevent scripts from being executed.
SetHandler Drupal_Security_Do_Not_Remove_See_SA_2006_006
<Files *>
# Override the handler again if we're run later in the evaluation list.
SetHandler Drupal_Security_Do_Not_Remove_See_SA_2013_003
</Files>
# If we know how to do it safely, disable the PHP engine entirely.
<IfModule mod_php5.c>
php_flag engine off
</IfModule>
# PHP 4, Apache 1.
<IfModule mod_php4.c>
php_flag engine off
</IfModule>
# PHP 4, Apache 2.
<IfModule sapi_apache2.c>
php_flag engine off
</IfModule>

I a la carpeta "tmp", el fitxer .htaccess ha de ser exactament el mateix que el de "files" pero hi hem d'afegir al final de tot això:

Deny from all

* Editeu el fitxer robots.txt, elimineu-ne tot el contingut i afegiu únicament aquestes linies, doncs no ens interessa que els robots indexin el nostre entorn local.

User-agent: *
Disallow: /

* Comproveu els possibles errors de instalació de Drupal accedint com usuari "webmestre" a la pàgina de administració i, des d'allà, a la pàgina de "Report Status". Ex: http://localhost/guifi/ca/admin/reports/status

* Accediu a la secció de configuració de "Performance" y deshabiliteu tot l'usatge de caché, optimització y compressió. Ens interessa que els canvis que fem sobre els arxius s'actualitzin en temps real. La URL d'accés a aquesta configuració serà de l'estil de: http://localhost/guifi/admin/settings/performance

== Instalació del tema Guifi.net al Drupal ==

mkdir drupal-6.29/sites/all/themes
cd drupal-6.29/sites/all/themes
git clone git://gitorious.org/guifi-web/theme_guifinet2011.git

El tema no s'activarà inmediatament, ja que li mancaran els arxius d'estils que Drupal creu que esten cachejats al sistema. Per a aconseguir que el tema s'activi completament, haurem d'accedir a l'"administració de temes", "configuració del tema de guifinet2011" i "desar" sense tocar cap opció. El tema per fi estarà activat.

Per visualitzar les imatges de la portada cal haver instal·lat els mòduls opcionals d'imatges i descarregar a:

$ cd /var/www/drupal-6.29/files/images

les següents imatges que es poden descarregar des de la línia de comandes:

wget http://guifi.net/files/images/el_molar_v2.jpg
wget http://guifi.net/files/images/platadaro_910x454.jpg
wget http://guifi.net/files/images/antenes2.jpg
wget http://guifi.net/files/images/dsc07219_910x454_v2.jpg
wget http://guifi.net/files/images/puigcubell_portada.jpg
wget http://guifi.net/files/images/taller_fibra1.jpg
wget http://guifi.net/files/images/DSC08889_910x454_v2.jpg
wget http://guifi.net/files/images/20246_910x454_v2.jpg
wget http://guifi.net/files/images/illes_910x454.jpg
wget http://guifi.net/files/images/cel-bcn-portada.jpg

== Instal·lació dels idiomes ==

La base de dades de Guifi.net que hem importat té habilitats varis idiomes per defecte, però les traduccions no estan instalades al sistema. Per a solucionar-ho, seguim aquests passos:

* Descarregueu la traducció de l'idioma de aquí: http://localize.drupal.org/.

Per exemple: http://ftp.drupal.org/files/translations/6.x/drupal/drupal-6.29.ca.po

* Aneu a la administració de idiomes de la vostra instalació com ''webmestre'', està localitzada a /admin/settings/language, i fixeu-vos que hi ha un enllaç per a importació manual dels strings de traducció: /admin/build/translate/import

* Indiqueu-li l'idioma de l'arxiu que heu descarregat e importeu-lo. A partir d'aquí ja tindrem l'interfície traduïda.

= Començant a treballar =

Ja tenim un entorn preparat per començar a modificar els mòduls de Drupal, pujar-los al nostre propi repositori i, si ho considerem convenient, notificar els nostres commits als desenvolupadors per a que els integrin a la branca principal.

Per a fer commit dels nostres canvis:

cd drupal-6.29/site/all/modules/guifi
# Fem modificacions a alguns arxius, les enregistrem al nostre repositori de treball i procedirem a pujar-les a Gitorious
git commit -a
git push

Posteriorment, des de la web de Gitorious podrem fer servir un "Merge request" per notificar als desenvolupadors alguna de les nostres modificacions i que valorin la seva incorporació al repositori principal.

== Actualitzant el nostre repositori amb els canvis del repositori pare ==

Si volem mantenir el nostre repositori actualitzat amb els darrers canvis que es van produint al repositori pare, haurem de seguir la següent recepta:

# Definim com repositori remot anomenat "upstream" el repositori de "drupal-guifi"
git remote add upstream git://gitorious.org/guifi/drupal-guifi.git

# Obtenim els darrers canvis del nostre repositori
git fetch origin -v

# Obtenim els darrers canvis del repositori pare
git fetch upstream -v

# Fem el merge dels canvis obtinguts
git merge upstream/master

== Referències ==

{{MM|url=https://lists.guifi.net/pipermail/guifi-webdev/2012-February/001750.html|list=webdev}}

== Enllaços externs ==

* http://acacha.org/mediawiki/index.php/Entorn_de_desenvolupament_guifi

[[Categoria:desenvolupament]]

Preparant l'entorn de desenvolupament

2015-11-23T13:18:24Z

Rogerpueyo: /* Descàrregues des de la línea de comandes */

Aquest document documenta com preparar un entorn de desenvolupament per col·laborar en el desenvolupament de la web de guifi.net.

Ens centrarem al mòdul "'''drupal-guifi'''", que és el fonamental de tota la gestió a la [[web de guifi.net]], però l'entorn muntat pot fer-se servir per desenvolupar altres mòduls o temes, com per exemple "'''budgets'''" i "'''theme_guifinet2011'''".

= Instalació i configuracó de la base =
Per fer funcionar [[Drupal]] a la màquina de desenvolupament cal posar en marxa un [[servidor web]], el mòdul [[PHP]] pel servidor web i un servidor de base de dades, recomanat [[MySQL]].

En funció del nostre sistema operatiu i les nostres preferències, la instalació d'aquests serveis es realitzarà d'una manera o d'una altra. A continuació es detalla pels entorns '''Debian/Ubuntu''' amb '''Apache+PHP+Mysql''' i '''Archlinux''' amb '''Nginx+PHP+Mysql'''. Totes dues instalacions són simples.

* Debian/Ubuntu:
$ sudo apt-get install mysql-server libapache2-mod-php5 php5-gd php5-mysql

* Archlinux:
$ pacman -S nginx mysql php-fpm php-gd

Documentació per a Archlinux: [https://wiki.archlinux.org/index.php/Apache,_PHP,_and_MySQL Apache, PHP and MySQL], [https://wiki.archlinux.org/index.php/Nginx Nginx]

La configuració del servidor web (Apache/lighttpd/nginx) per a fer que funcioni el mòdul de PHP a l'arrel del nostre directori web depèn del nostre sistema.

== Configuració de l'arxiu php.ini ==
Cal tenir activats els següents mòduls a l'arxiu php.ini:

extension=mysql.so
extension=iconv.so
extension=gd.so

Cal testejar si el sistema interpreta arxius PHP. Per això, es pot crear un arxiu al DOCUMENT_ROOT '''(generalment /var/www)''' del servidor web. Si no funciona reviseu els passos anteriors i consulteu la documentació de la vostra distribució.

<?php
phpinfo();
?>

== Configuració de fitxers ==
Per tal de no tenir problemes en la nostra instal·lació de l'entorn de desenvolupament, es necessari realitzar algunes modificacions dins d'uns fitxers concrets els quals esmentarem per tal de que tot funcioni correctament:

En l'adreça següent:
/etc/apache2/sites-enabled/

Hi tenim un únic fitxer el qual es diu '000-default'. Mitjançant un editor de text de shell (vi/nano) editarem el fitxer:

$ vi 000-default

Dins del fitxer, hem de buscar el següent text: 'Allow Override None' en tot el text i substituir-lo per 'Allow Override All'. Per realitzar la modificació, mitjançant les fletxes de direcció ens situarem sobre la línia en qüestió i apretarem la tecla 'i' la qual ens permetrà escriure. Si es presenten problemes, sembre es pot sortir del fitxer sense desar mitjançant la tecla 'ESC' seguit de la comanda ':q!' <quit without saving> << sortir sense guardar.

$ nano 000-default

Fem l'edició i sortim desant Ctrl+X

== Preparació de les Clean URL ==

La nostra web amb drupal necessita fer servir '''Clean URL''' i per tal que aquestes es puguin aplicar es necessari tenir activat el mòdul '''rewrite'''. Per tal d'activar aquest mòdul, utilitzarem les comandes següents:

a2enmod rewrite

Ens informarà que el mòdul està actiu i que s'haurà de reiniciar el servei, cosa que farem amb la comanda:

/etc/init.d/apache2 restart
o bé
service apache2 restart

= Descarregant el codi font =
El codi dels mòduls "drupal-guifi", "drupal-bugdets" i "theme_guifinet2011" són [[programari lliure]] i estan allotjats als [[repositoris]] de Gitorious. Els repositoris són útils pel desenvolupament de programari però nosaltres ens limitarem a clonar-los.

La idea és que hi ha el repositori de cada un dels mòduls i el tema, cada desenvolupador té una còpia del repositori també a Gitorious, d'aquesta manera instal·larà la seva còpia a la seva màquina de desenvolupament, realitzarà el desenvolupament a la seva màquina i un cop el desenvolupament és correcte, enviarà els canvis a la seva còpia de Gitorious i demanarà incloure'ls al repositori principal.

== Requisits pel clonatge del repositori drupal-guifi a la còpia del desenvolupador a Gitorious ==
Haurem de fer un fork del projecte "drupal-guifi" de cara a realitzar alguna modificació sobre el seu codi font.

* Crear-se un compte a [http://gitorious.org Gitorious].
* Crear unes claus SSH (ssh-keygen) sense contrasenya a l'ordinador de treball i s'afegiran al perfil d'usuari de gitorious. Per exemple:

ssh-keygen

Generating public/private rsa key pair.
Enter file in which to save the key (/home/dave/.ssh/id_rsa):
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /home/dave/.ssh/id_rsa.
Your public key has been saved in /home/dave/.ssh/id_rsa.pub.

* Accedir a la pàgina del projecte "[https://gitorious.org/guifi/drupal-guifi drupal-guifi]".
* Clonar el projecte. Amb això ja tindrem un fork del projecte sobre el que podem realitzar els nostres canvis.

Pàgines web a Gitorious dels projectes amb les que podem participar en el desenvolupament:
* https://gitorious.org/guifi/drupal-guifi
* https://gitorious.org/guifi/drupal-budgets
* https://gitorious.org/guifi-web/theme_guifinet2011

Amb això tindrem una còpia de l'original a l'espai del desenvolupador a Gitorious.

= Descàrrega, instalació i configuració de l'entorn Drupal =

Al principi hem instal·lats els serveis bàsics a la nostra màquina de desenvolupament i hem clonat els repositoris de codi font amb els que volem treballar, hem de posar en funcionant a la màquina de desenvolupament el Drupal 6.x (amb alguns mòduls adicionals), ja que així podrem veure i testejar els canvis que anem fent al nostre repositori de "drupal-guifi".

== Descàrregues des de la línea de comandes ==

* La darrera versió de Drupal 6 (6.37):

wget http://ftp.drupal.org/files/projects/drupal-6.37.tar.gz

i habilitar l'accès via web:

ln -s /usr/share/drupal6/ /var/www/guifi

* Els Mòduls de Drupal fonamentals:
Que els descarregarem a /var/www/drupal-6.29/sites/all/modules

'''Mòdul WebForm:'''
wget http://ftp.drupal.org/files/projects/webform-6.x-3.19.tar.gz

'''Mòdul Views:'''
wget http://ftp.drupal.org/files/projects/views-6.x-2.16.tar.gz

'''Mòdul Views_slideshow:'''
wget http://ftp.drupal.org/files/projects/views_slideshow-6.x-2.4.tar.gz

'''Mòdul i18n <Multi-idioma>:'''
wget http://ftp.drupal.org/files/projects/i18n-6.x-1.10.tar.gz

* Els Mòduls de Drupal opcionals:

'''Mòdul schema:'''
wget http://ftp.drupal.org/files/projects/schema-6.x-1.7.tar.gz

'''Mòdul devel:'''
wget http://ftp.drupal.org/files/projects/devel-6.x-1.27.tar.gz

'''Mòdul potx:'''
wget http://ftp.drupal.org/files/projects/potx-6.x-3.3.tar.gz

'''Mòdul l10n_client:'''
wget http://ftp.drupal.org/files/projects/l10n_client-6.x-2.2.tar.gz

'''Mòdul language:'''
wget

'''Mòdul icons:'''
wget

'''Mòdul language_sections:'''
wget http://ftp.drupal.org/files/projects/language_sections-6.x-2.5.tar.gz

'''Mòdul diff:'''
wget http://ftp.drupal.org/files/projects/diff-6.x-2.3.tar.gz

'''Mòdul captcha:'''
wget http://ftp.drupal.org/files/projects/captcha-6.x-2.5.tar.gz

'''Mòdul captcha_pack:'''
wget http://ftp.drupal.org/files/projects/captcha_pack-6.x-1.0-beta3.tar.gz

'''Mòdul event:'''
wget http://ftp.drupal.org/files/projects/event-6.x-2.x-dev.tar.gz

'''Mòdul cck:'''
wget http://ftp.drupal.org/files/projects/cck-6.x-2.9.tar.gz

'''Mòdul fckeditor:'''
wget http://ftp.drupal.org/files/projects/fckeditor-6.x-2.3.tar.gz

'''Mòdul image:'''
wget http://ftp.drupal.org/files/projects/image-6.x-1.2.tar.gz

'''Mòdul image_filter:'''
wget http://ftp.drupal.org/files/projects/image_filter-6.x-1.0.tar.gz

'''Mòdul fivestar'''
wget http://ftp.drupal.org/files/projects/fivestar-6.x-1.20.tar.gz

'''Mòdul votingapi'''
wget http://ftp.drupal.org/files/projects/votingapi-6.x-2.3.tar.gz

* Mòduls desenvolupats per la comunitat Guifi.net:

- Mòdul budgets

- Mòdul guifi

* El tema oficial "theme_guifinet2011":

* La base de dades actual de desenvolupament de la web de guifi.net:

wget http://www.guifi.net/guifi66_devel.sql.gz

== Instalació de Drupal ==

Hem de posar en marxa un entorn Drupal bàsic i posteriorment sobreescriurem la base de dades amb la que hem descarregat prèviament de Guifi.net

Aquests són els passos bàsics per a instal·lar i configurar un site Drupal:

* Descomprimim el paquet de Drupal que ens hem descarregat i el posem accesible al DOCUMENT_ROOT d'Apache:

cd /var/www
tar zxvf drupal-6.29.tar.gz
ln -s drupal-6.29 guifi

* Iniciem el procés d'instalació via web de Drupal accedint a http://<ip_del_teu_servidor>/guifi exemples:

http://10.138.71.10/guifi

http://localhost/guifi

* En arribar a l'apartat de configuració de la base de dades, necessitarem tenir creada una base de dades local de MySQL per a desenvolupament:

[dave@inuik http]$ mysql -u <nomusuari> -p <contrassenya> << és possible que amb root no faci falta una password

exemple:

mysql -u root -p <salt de linia>
Enter password: <escritura_de_la_password>

Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 525
Server version: 5.5.31-0+wheezy1 (Debian)

Copyright (c) 2000,2013, Oracle and/or its affiliates. All rights reserved.
Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql> create database guifi_test;
Query OK, 1 row affected (0.00 sec)

mysql> grant all on guifi_test.* to guifi@localhost identified by 'guifinet';
Query OK, 0 rows affected (0.00 sec)

Ja podem introduir la informació de connexió a la base de dades per a que Drupal creï les taules necessàries.

== Instal·lació dels mòduls de Drupal necessaris per a engegar l'entorn ==

Dins de l'adreça /var/www/drupal-6.29/sites/all/modules, on tindrem descarregats els nostres mòduls, els descomprimirem mitjançant la ordre:

tar zxvf <nom_del_fitxer_a_descomprimir>

per exemple:

tar zxvf i18n-6.x-1.10.tar.gz

'''ATENCIÓ'''. Fixeu-vos que el mòdul "drupal-guifi" que estem clonant no és el repositori principal que hi ha a Gitorious, sinó el que hem creat fent un fork del projecte principal. Així els canvis que fem els podrem pujar a Gitorious al repositori nostre com a desenvolupadors, per a posteriorment, si ho considerem convenient, notificar el canvi als desenvolupadors principals per a que els puguin integrar a la branca principal de desenvolupament, això es fa des del mateix Gitorious amb un ''merge request''.

mkdir drupal-6.29/sites/all/modules
cd drupal-6.29/sites/all/modules
git clone git://gitorious.org/guifi/drupal-budgets.git budgets
# Clonat del MEU FORK del mòdul "drupal-guifi"
git clone git@gitorious.org:~tombatossals/guifi/tombatossalss-drupal-guifi.git guifi (canvia "~tombatossals/guifi/tombatossalss-drupal-guifi.git" pel teu repositori clonat a Gitorious)

== Instalació de la base de dades de desenvolupament de Guifi.net ==

Tenint una instal·lació neta de Drupal, anem a sobreescriure la base de dades amb la informació de les taules de la base de dades de Guifi.net, el que ens proporcionarà un entorn de desenvolupament similar a la web en producció. Des de la carpeta on anteriorment hem baixat la base de dades cal fer:

gunzip guifi66_devel.sql.gz

mysql -u root -p guifi_test < guifi66_devel.sql; << recordem que les comandes dins de MySQL s'acaben amb un ';'

== Afinant la instalació ==

Un cop realitzada la instal·lació, s'ha d'editar el fitxer .htaccess, que es troba dins de la carpeta arrel de drupal :

cd /var/www/drupal-6.29
ls -la << per mostrar llistats tots els fitxers inclosos els ocults

Ens mostrarà un arxiu ocult anomenat : .htaccess
L'editarem mitjançant un editor de text:

vi .htaccess

En una linia buida del fitxer, apretarem la 'i' per escriure-hi i afegirem la següent linia: RewriteBase /drupal-6.29

Un cop instalada la base de dades amb tota la informació de la web de Guifi.net, tindrem accés a la informació de qualsevol node o zona de la web principal. Per a loguejar-te com usuari, has de fer servir el nom d'usuari corresponent i la contrasenya genèrica "guifi".

L'usuari administrador serà "webmestre" i la contrasenya "guifi".

'''Alguns consells per a refinar la instalació:'''

* Creeu i comproveu que els directoris "files", "files/nanostation" i "tmp" del directori de instalació de drupal tenen permisos de escriptura per l'usuari del servidor web (o poseu-los a 777):
mkdir drupal-6.29/{files,files/nanostation,tmp}
chmod 777 drupal-6.29/{files,files/nanostation,tmp}

* La carpeta "files/nanostation" contendrà els arxius "unsolclic" de les antenes Ubiquiti que anem consultant o creant.

* Protegiu la carpeta "files" i "tmp" amb el seu respectiu fixter .htaccess
A la carpeta "files" el ftixer .htaccess ha de incloure aquest contingut:

# Turn off all options we don't need.
Options None
Options +FollowSymLinks
# Set the catch-all handler to prevent scripts from being executed.
SetHandler Drupal_Security_Do_Not_Remove_See_SA_2006_006
<Files *>
# Override the handler again if we're run later in the evaluation list.
SetHandler Drupal_Security_Do_Not_Remove_See_SA_2013_003
</Files>
# If we know how to do it safely, disable the PHP engine entirely.
<IfModule mod_php5.c>
php_flag engine off
</IfModule>
# PHP 4, Apache 1.
<IfModule mod_php4.c>
php_flag engine off
</IfModule>
# PHP 4, Apache 2.
<IfModule sapi_apache2.c>
php_flag engine off
</IfModule>

I a la carpeta "tmp", el fitxer .htaccess ha de ser exactament el mateix que el de "files" pero hi hem d'afegir al final de tot això:

Deny from all

* Editeu el fitxer robots.txt, elimineu-ne tot el contingut i afegiu únicament aquestes linies, doncs no ens interessa que els robots indexin el nostre entorn local.

User-agent: *
Disallow: /

* Comproveu els possibles errors de instalació de Drupal accedint com usuari "webmestre" a la pàgina de administració i, des d'allà, a la pàgina de "Report Status". Ex: http://localhost/guifi/ca/admin/reports/status

* Accediu a la secció de configuració de "Performance" y deshabiliteu tot l'usatge de caché, optimització y compressió. Ens interessa que els canvis que fem sobre els arxius s'actualitzin en temps real. La URL d'accés a aquesta configuració serà de l'estil de: http://localhost/guifi/admin/settings/performance

== Instalació del tema Guifi.net al Drupal ==

mkdir drupal-6.29/sites/all/themes
cd drupal-6.29/sites/all/themes
git clone git://gitorious.org/guifi-web/theme_guifinet2011.git

El tema no s'activarà inmediatament, ja que li mancaran els arxius d'estils que Drupal creu que esten cachejats al sistema. Per a aconseguir que el tema s'activi completament, haurem d'accedir a l'"administració de temes", "configuració del tema de guifinet2011" i "desar" sense tocar cap opció. El tema per fi estarà activat.

Per visualitzar les imatges de la portada cal haver instal·lat els mòduls opcionals d'imatges i descarregar a:

$ cd /var/www/drupal-6.29/files/images

les següents imatges que es poden descarregar des de la línia de comandes:

wget http://guifi.net/files/images/el_molar_v2.jpg
wget http://guifi.net/files/images/platadaro_910x454.jpg
wget http://guifi.net/files/images/antenes2.jpg
wget http://guifi.net/files/images/dsc07219_910x454_v2.jpg
wget http://guifi.net/files/images/puigcubell_portada.jpg
wget http://guifi.net/files/images/taller_fibra1.jpg
wget http://guifi.net/files/images/DSC08889_910x454_v2.jpg
wget http://guifi.net/files/images/20246_910x454_v2.jpg
wget http://guifi.net/files/images/illes_910x454.jpg
wget http://guifi.net/files/images/cel-bcn-portada.jpg

== Instal·lació dels idiomes ==

La base de dades de Guifi.net que hem importat té habilitats varis idiomes per defecte, però les traduccions no estan instalades al sistema. Per a solucionar-ho, seguim aquests passos:

* Descarregueu la traducció de l'idioma de aquí: http://localize.drupal.org/.

Per exemple: http://ftp.drupal.org/files/translations/6.x/drupal/drupal-6.29.ca.po

* Aneu a la administració de idiomes de la vostra instalació com ''webmestre'', està localitzada a /admin/settings/language, i fixeu-vos que hi ha un enllaç per a importació manual dels strings de traducció: /admin/build/translate/import

* Indiqueu-li l'idioma de l'arxiu que heu descarregat e importeu-lo. A partir d'aquí ja tindrem l'interfície traduïda.

= Començant a treballar =

Ja tenim un entorn preparat per començar a modificar els mòduls de Drupal, pujar-los al nostre propi repositori i, si ho considerem convenient, notificar els nostres commits als desenvolupadors per a que els integrin a la branca principal.

Per a fer commit dels nostres canvis:

cd drupal-6.29/site/all/modules/guifi
# Fem modificacions a alguns arxius, les enregistrem al nostre repositori de treball i procedirem a pujar-les a Gitorious
git commit -a
git push

Posteriorment, des de la web de Gitorious podrem fer servir un "Merge request" per notificar als desenvolupadors alguna de les nostres modificacions i que valorin la seva incorporació al repositori principal.

== Actualitzant el nostre repositori amb els canvis del repositori pare ==

Si volem mantenir el nostre repositori actualitzat amb els darrers canvis que es van produint al repositori pare, haurem de seguir la següent recepta:

# Definim com repositori remot anomenat "upstream" el repositori de "drupal-guifi"
git remote add upstream git://gitorious.org/guifi/drupal-guifi.git

# Obtenim els darrers canvis del nostre repositori
git fetch origin -v

# Obtenim els darrers canvis del repositori pare
git fetch upstream -v

# Fem el merge dels canvis obtinguts
git merge upstream/master

== Referències ==

{{MM|url=https://lists.guifi.net/pipermail/guifi-webdev/2012-February/001750.html|list=webdev}}

== Enllaços externs ==

* http://acacha.org/mediawiki/index.php/Entorn_de_desenvolupament_guifi

[[Categoria:desenvolupament]]

SNPServices

2015-10-14T17:47:25Z

Rogerpueyo:

SNPServices és el servei de recollida de dades i generació de gràfiques de disponibilitat i trànsit per a nodes de Guifi.net.

=== Migració del servei SNPServices a una altra màquina ===

El servei SNPServices emmagatzema dades històriques dels nodes que monitoritza. A l'hora de migrar el servei a una altra màquina (per exemple, a una de nova) és convenient mantenir aquest historial de gràfiques, en comptes de començar des de zero. Per fer-ho correctament, s'han de seguir els següents passos:
* Instal·lar el servei SNPServices al nou servidor. Es recomana utilitzar la distribució [[Cloudy]], que automatitza el procés i permet fer-ho a través del navegador web.
* Copiar la carpeta /var/lib/snpservices/rrdb (on es guarden les dades històriques) del servidor antic al nou.
* Configurar l'SNPServices del servidor nou utilitzant el mateix identificador de servei (ID) que tenia el servidor antic. Un cop copiats, s'ha de comprovar que la carpeta pertany a l'usuari del servidor web amb la següent comanda:
chown -R www-data:www-data /var/lib/snpservices
* Aturar el servidor antic. Al cap d'uns minuts el servidor nou ja estarà monitoritzant els nodes i generant les gràfiques.

Si durant la migració al nou servidor s'ha canviat -respecte l'antic- l'adreça IP, el número de node, etc. cal actualitzar el servei a la pàgina corresponent de [http://www.guifi.net].

==== Migració entre diferents arquitectures ====

Si la màquina nova fa servir una arquitectura diferent a l'antiga (per exemple, ara 64 bits i abans 32) els fitxers .rrd han de ser convertits. En caquest cas, cal transformar els fitxers .rrd al format XML i, després, retornar-los al format .rrd. ficheros .rrd deben ser convertidos. Per fer-ho, s'han de seguir els passos anteriors tenint en compte el següent:

* A la màquina antiga, abans de copiar la carpeta /var/lib/snpservices/rrdb, executeu:
:rrdtool dump fitxer.rrd > fitxer.xml
* Un cop copiada la carpeta al nou servidor, executeu:
:rrdtool restore fitxer.xml

I el fitxer .rrd resultant quedarà convertit al format correcte.

[[en:SNPservices]]
[[es:SNPservices]]

SNPServices

2015-10-14T17:27:55Z

Rogerpueyo:

SNPServices

2015-10-14T16:56:22Z

Rogerpueyo: Rogerpueyo ha mogut SNPservices a SNPServices: Coherència en el nom

[[en:SNPservices]]
[[es:SNPservices]]

SNPservices

2015-10-14T16:56:22Z

Rogerpueyo: Rogerpueyo ha mogut SNPservices a SNPServices: Coherència en el nom

#REDIRECT [[SNPServices]]

SNPServices

2015-10-14T16:53:42Z

Rogerpueyo: Afegeix traduccions castellà i anglès

[[en:SNPservices]]
[[es:SNPservices]]

Annex:subxarxes mesh

2015-10-03T08:40:25Z

Rogerpueyo:

Annex:subxarxes mesh

2015-10-03T08:39:10Z

Rogerpueyo: Update Wales

Cloudy plug-ins

2015-04-22T15:09:34Z

Rogerpueyo: Add translations links.

== Què és un plug-in? ==

Cloudy és una distribució de Linux basada en Debian que dona als usuaris una interfície simple i còmode per gestionar diferents serveis que poden ser fets servir a través d'una xarxa comunitària; en el nostre cas, Guifi.

Al mateix temps, Cloudy ofereix una sèrie d'eines que permeten a un usuari afegir un servei del seu gust sense haver de tenir coneixements molt complexos sobre xarxes i informàtica en general. Automaticament, aquests serveis es publiquen mitjançant Avahi, de manera que tothom que disposi Cloudy pot fer ús d'aquests servei.

Una altra manera d'anomenar aquests serveis que es poden posar i treure de forma senzilla és plug-in. Així doncs, entenem per plug-in un programa o software que un usuari vol afegir a la distribució i que pot ser gestionat de forma senzilla des de l'interfície web que proveeix Cloudy.

== Afegir serveis a Cloudy ==

=== Una petita introducció ===

Aquesta guia t'ensenyarà el procés per afegir un nou servei a la distribució Cloudy.

Per tal de ser clar i donar alguns exemples al mateix temps, integrarem un servei bastant
simple mostrant alguns troços de codi pel camí. Per seguir el tutorial amb més claredat, o bé per integrar
serveis més complexes, fora bò que sapiguéssiu alguna cosa de Bash<ref name="Bash">(http://www.tldp.org/LDP/Bash-Beginners-Guide/Bash-Beginners-Guide.pdf)</ref> i de PHP<ref name="PHP">(https://php.net/manual/es/index.php)</ref>.

Per simplicitat farem servir Pastecat<ref name="Pastecat">(https://github.com/mvdan/pastecat)</ref>. És un bon candidat ja que:

* És independent i no es federa ni es comunica amb altres nodes
* Està fet en Go, és fàcil de distribuïr i instal·lar
* No necessita fitxers de configuració
* No necessita gaires recursos

=== Obtenint el binari ===

El primer que hem d'investigar és com descarregar i instal·lar el binari a Cloudy.
La majoria del software que podem trobat està per defecte en els paquets de Debian,
però el Pastecat no hi és. Si es donés el cas que hi fós, tan sols hauriem d'executar
la comanda <code>apt-get install pastecat</code> des de PHP.

Però com que aquest no és el cas, haurem de treure el binari d'algun altre lloc. Una
opció és agafar el codi font i compilarl-lo nosaltres mateixos, però el problema d'això
és que Cloudy necessitaría incloure moltes eines i llibreries per compil·lar, i aquest
no és l'objectiu.

La millor opció si un paquet de Debian no està disponible en els repositoris, és
descarregar els binaris des d'algun lloc segur. Podem fer servir el servei de "releases"
de Github per això. Les dues opcions ens deixen amb un fitxer executable que hauriem de
ser capaços de córrer directe sobre Cloudy.

En aquest cas en particular descarregarem els binaris des del repositori git amb la
següent línia de comandes:

<code>
wget https://github.com/mvdan/pastecat/releases/download/v0.3.0/pastecat_linux_386
</code>

Noteu que en aquest cas en concret estem descarregant una versió específica per un Linux
amb arquitectura i386.

Fixeu-vos però, que tenir el servei en els paquets de Debian té moltes avantatges:

* Les actualitzacions són simples i no necessiten feina extra des de Cloudy
* El paquet està compilat per Debian d'una manera segura
* Els fitxer de l'init.d ja venen per defecte
* Els paquets de Debian solen contenir correccions

=== Provant-lo ===

Abans d'afegir un servei hauriem de configurar-lo i provar-lo directament nosaltres
mateixos per veure com funciona i que realment funciona. També hem entendre quines opcions
de configuració o línies de comandes necessitarem per fer ús d'aquest servei en particular
i com el gestionarem un cop estigui funcionant.

=== Afegint el controlador ===

En <code>web/plug/controllers</code> tenim un fitxer PHP per cada servei anomenat
controlador (o 'controller' en anglès). Aquest fitxer conté el codi que s'executarà quan
es visiti la pàgina del nostre servei des de la interfície web de Cloudy.

==== Afegint la funció índex ====

El que volem fer és que el nostre servei estigui integrat en l'estructura web de Cloudy.
Per fer això, necessitem crear uns quants 'scripts' en PHP i afegir-los al nostre
dispositiu. De moment necessitarem crear dos scripts: <code>pastecat.php</code> i
<code>pastecat.menu.php</code>. El primer fitxer és el controlador, és a dir, l'script que
renderitza la pàgina i té tota la informació tal com botons o redireccionaments. L'altre
és el que permet que el nostre servei es mostri en els menus superiors desplegables de
Cloudy.

El codi del menú serà quelcom semblant a això:

<code php>
<?php
//peerstreamer.menu.php
addMenu('Pastecat','pastecat','Clommunity');
</code>

Per ara, farem servir un script molt simple en PHP com a controlador:

<code php>
<?php
//pastecat
$title="Pastecat";

function index(){
global $paspath,$title;
global $staticFile;

$page=hlc(t($title));
$page .= hl(t("Minimalist pastebin engine written in Go"),4);
$page .= par(t("A simple and self-hosted pastebin service written in Go").' '.t("Can use a variety of storage backends").' '.t(" Designed to optionally remove pastes after a certain period of time.").' '.("If using a persistent storage backend, pastes will be kept between runs.").' '.t("This software runs the").' '."<a href='http://paste.cat'>".t("paste.cat")."</a>". t(" public service."));

return(array('type' => 'render','page' => $page));
}
</code>

En el nostre sistema Cloudy, aquests fitxers han de posar-se als directoris dins de <code>/var/local/cDistro/plug/</code>.
El primer de tot ha d'anar dins de <code>menus</code> i el segon al directori <code>controllers</code>.
Un cop haguem fet això, podem anar al web del nostre dispositiu amb Cloudy i accedir al nou menú Pastecat.

==== Fent que el controlador instal·li el nostre servei ====

Com s'ha mencionat anteriorment, aquest pas és molt més senzill de realitzar si el servei
està en els paquets de Debian. Com que no és el cas del pastecat, ho haurem de fer manualment.
Normalment, fer aquest procés manualment inclou una combinació de les comandes <code>wget</code>, <code>mv</code> i <code>chmod</code>.
En general, és bona idea mantenir els fitxers d'aquest tipus de serveis a <code>/opt/SERVICENAME</code>.

En el nostre cas en particular, la primera cosa que necessitem fer és descarregar el binari
de la 'release' de Github. per tal de fer això farem ús de la comanda mencionada abans: <code>wget</code>.
Donada una URL a un fitxer, aquesta comanda en permet descarregar aquest fitxer al nostre sistema,
i això és el que farem tot seguit amb:

<code bash>
wget https://github.com/mvdan/pastecat/releases/download/v0.3.0/pastecat_linux_386
</code>

Una cop tinguem el binari en la nostre màquina el mourem al directori /opt/pastecat/. per tal
de moure els fitxers pel nostre sistema farem servir la comanda <code>mv</code>. Tot i així,
primer haurem de crear el directori on posarem el fitxer. Per fer això, utilitzarem <code>mkdir</code>
de la següent manera:

<code bash>
mkdir -p /opt/pastecat/
</code>

Una vegada haguem creat el directori, és hora de moure-hi el binari:

<code bash>
mv current_directory/pastecat_linux_386 /opt/pastecat/
</code>

On 'current_directory és el directori on prèviament hem descarregat el binari. Com que el
nom del binari depèn de l'arquitectura, per tal de simplificar el codi del controlado, canviarem
el nom del fitxer executable a quelcom més genèric i simple:

<code bash>
mv /opt/pastecat/pastecat_linux_386 /opt/pastecat/pastecat
</code>

Ara el nostre binari es diu <code>pastecat</code> en comptes de <code>pastecat_linux_386</code>

Aquests passos són els mínim requerits per instal·lar un servei que no s'ofereix directament
en els repositoris oficials de Debian. Nogensmenys, de cara a un usuari final, seria un malson
haver de fet totes aquestes comandes en una consola connectat a través de <code>ssh</code> al
seu dispositiu, així que el que farem tot seguit és crear un script en bash que serà cridat
més endavant a través de la interfície web clicant un botó.

Aquest script és la primera versió del controlador del pastecat. Per ara només inclourem una
funció per instal·lar el pastecat en el nostre dispositiu. Més endavant onclourem algunes
altres funcions per proveïr al nostre script amb més serveis:

<code bash>
#!/bin/bash
PCPATH="/opt/pastecat/"

doInstall() {
if isInstall
then
echo "Pastecat is already installed."
return
fi

# Creating directory and switching
mkdir -p $pcpath && cd $pcpath

# Getting file
wget https://github.com/mvdan/pastecat/releases/download/v0.3.0/pastecat_linux_386

# Changing name so controller can invoke it generically
mv pastecat_linux_386 pastecat
chmod +x pastecat

cd -
}

isInstalled() {
[ -d $pcpath ] && return 0
return 1
}

case $1 in
"install")
shift
doInstall $@
;;
esac
</code>

Podem veure com els últims passos s'han concentrat dins d'una mateixa funció, permetent-nos
instal·lar el software en el dispositiu d'una forma més senzilla.

==== Fent que el controlador utilitzi pastecat ====

===== Executar el servei =====

El següent que volem fer és que el nostre software es pugui fer servir des de la interfície web.
És per això que inclourem una nova opció a la nostra pàgina principal de pastecat i inclourem
una nova funció en el nostre controlador per gestionar el binari. Afegirem un botó en el PHP
de la següent manera:

<code bash>
$page .= addButton(array('label'=>t('Create a Pastecat server'),'href'=>$staticFile.'/pastecat/publish'));
</code>

just després del missatge <code>Pastecat is installed</code>. El proper que cal fer és implementar
la funció <code>publish</code> en el mateix PHP. Aquesta funció és la responsable de cridar la funció
corresponent en el controlador i anunciar el nostre servei fent servir Avahi. La diferència amb
aquesta funció és que requereix un formulari per introduïr-hi dades, així que al final acabarem
tenint dues funcions: una get i una post:

<code php>
function publish_get() {
global $pcpath,$title;
global $staticFile;

$page = hlc(t($title));
$page .= hlc(t('Publish a pastecat server'),2);
$page .= par(t("Write the port to publish your Pastecat service"));
$page .= createForm(array('class'=>'form-horizontal'));
$page .= addInput('description',t('Describe this server'));
$page .= addSubmit(array('label'=>t('Publish'),'class'=>'btn btn-primary'));
$page .= addButton(array('label'=>t('Cancel'),'href'=>$staticFile.'/peerstreamer'));

return(array('type' => 'render','page' => $page));
}

function publish_post() {
$port = $_POST['port'];
$description = $_POST['description'];
$ip = "";

<nowiki>$page = "<pre>";
$page .= _pcsource($description);
$page .= "</pre>";</nowiki>

return(array('type' => 'render','page' => $page));
}
</code>

Com podem veure en la funció <code>post</code> estem invocant una altra funció. La raó de fer
això és escriure un codi més simple i modular. En aquesta última funció per fi cridem a l'script:

<code php>
function _pcsource($port,$description) {
global $pcpath,$pcprogram,$title,$pcutils,$avahi_type,$port;

$page = "";
$device = getCommunityDev()['output'][0];
$ipserver = getCommunityIP()['output'][0];

if ($description == "") $description = $type;

$cmd = $pcutils." publish '$port' '$description';
execute_program_detached($cmd);

$page .= t($ipserver);
$page .= par(t('Published this server.'));

$page .= addButton(array('label'=>t('Back'),'href'=>$staticFile.'/pastecat'));

return($page)
}
</code>

El proper que hem de fer és crear una funció <code>publish</code> en el controlador, així que
afegirem una nova funció al controlador bàsic que teniem a la secció '''3.2'''. Primer afegirem
un nou paràmetre anomenat "publish", així que la primera part a exeutar-se de l'script serà:

<code bash>
if [ $# -lt 1 ]
then
doHelp
fi

case $1 in
"install")
shift
doInstall $@
;;
"publish")
shift
doServer $@
;;
esac
</code>

Com podem veure, quan el primer argument de l'script és <code>publish</code>, "shiftem" la resta
d'arguments i cridem a la funció <code>doServer</code>. En aquesta funció hem de posar en marxa
el servei amb els arguments corresponents, així que el primer que farem serà posar aquests paràmetres
en variables locals. Una vegada haguem fet això, el més lògic sería llençar l'aplicació directament,
però com que l'script es crida amb permisos de "root" (i això és dolent) hem de llençar Pastecat com
a usuari <code>nobody</code>. El problema és que l'usuari <code>nobody</code> no té quasi permisos...
i el Pastecat necessita alguns permisos per crear directoris i fitxers de text. Per permetre que <code>nobody</code>
pugui fer aquestes coses, primer crearem un directori garantint permisos a casibé tothom. Per aconseguir
això, farem servir la comanda <code>chmod</code> altre vegada. Ara, l'usuari pot crear fitxers i directoris
dins d'aquest mateix directori, i en conseqüència, podem córrer Pastecat. Finalment, mantindre el
PID en una variable en cas que el necessitem més endavant (que ja us dic que sí que el necessitarem):

<code bash>
doServer() {
# Turning machine into a server

local port=${1:-""}
local description=${2:-""}
local ip=${3:-"0.0.0.0"}

# Creating directory with nobody permissions
mkdir -p "/var/local/pastecat"
chmod 777 "/var/local/pastecat" && cd "/var/local/pastecat"

# Running pastecat
cmd='su '$PCUSER' -c "{ '$PCPATH$PCPROG' -l :'$port' > '$LOGFILE' 2>&1 & }; echo \$!"'
pidpc=$(eval $cmd) # keeping PID for future needs...

cd -

# Using the PID, we could carry on process control so if the pastecat process die, we can also
# stop the avahi process to avoid "false connections"

return
}
</code>

Fixeu-vos que ara estem fent servir algunes variables globals que no estaven definides abans, com
ara <code>PCUSER</code> i <code>LOGFILE</code>. Aquestes variables tenen els següents valors:

<code bash>
PCPATH="/opt/pastecat/"
PCPROG="pastecat"
LOGFILE="/dev/null"
PCUSER="nobody
</code>

===== Aturar el servei =====

En algun moment, és possible que vulguem aturar el nostre servei. És per això que crearem
un botó per fer això. La primera cosa a fer sería crear el botó, però si pensem una mica, veurem
que abans de crear-lo, necessitem una manera de saber si el nostre servei està corrent o no.
A més a més, també necessitem una manera d'aturar el nostre servei. Com que estem corrent sobre
Linux, podem aconseguir aturar el servei fàcilment fent servir la comanda <code>kill</code>.
El problema és que, per fer servir aquesta comanda, primer necessitem saber el número d'identificació
del procés (PID). Per sort nostra, ja vam quedar-nos amb aquest número quan vam crear el servidor
de pastecat. En concret amb la línia <code>pidpc=$(eval $cmd)</code>.

Ara que tenim tot el que necessitem per matar el nostre procés, anem a veure com ho fem perquè
el PHP pugui saber si el servei està corrent o no. Una manera fàcil i eficient de fer-ho és
emmagatzemant algunes dades útils en un fitxer i borrar-lo quan s'aturi el Pastecat. D'aquesta
manera ens assegurem que el fitxer només existeix quan el Pastecat està actiu. Aquest fitxer
el crearem des del controlador afegint les següents línies just sota la sentència que hem
mencionat en el paràgraf enterior:

<code bash>
# Writting server info to file
info="$pidpc http://$ip:$port" # Separator is space character
echo $info > $PCFILE
</code>

On <code>$PCFILE</code> és una variable global que conté <code>/var/run/pc.info</code>. Fixeu-vos
que el contingut del fitxer serà el PID del Pastecat i la direcció completa del servidor d'aquest.

Ara ja tenim una manera de saber si el servei està actiu o no, de manera que tot seguit afegirem
el botó 'stop' a la interfície web. Modificarem una mica l'script php que teniem abans, afegint
un anunci indicant si el pastecat s'està executant o no i 2 botons més quan aquest estigui corrent.
Així doncs, la nostra funció índex contindrà el següent codi dins la condició que comproba si
el pastecat esa instal·lat o no:

<code php>
<nowiki>$page .= "<div class='alert alert-success text-center'>".t("Pastecat is installed")."</div>\n";
if ( isRunning() ) {
$page .= "<div class='alert alert-success text-center'>".t("Pastecat is running")."</div>\n";
$page .= addButton(array('label'=>t('Go to server'),'href'=>'http://'. getCommunityIP()['output'][0] .':'. $port));
$page .= addButton(array('label'=>t('Stop server'),'href'=>$staticFile.'/pastecat/stop'));
} else {
$page .= "<div class='alert alert-error text-center'>".t("Pastecat is not running")."</div>\n";
}
$page .= addButton(array('label'=>t('Create a Pastecat server'),'href'=>$staticFile.'/pastecat/publish'));</nowiki>
</code>

En aquest tros de codi podem apreciar dues coses noves en el nostre codi. La primera és una funció
de comprovació anomenada <code>isRunning()</code>. Aquesta funció s'assembla molt a la funció que feiem servir per comprovar si
el Pastecat estava instal·lat o no:

<code php>
function isRunning() {
// Returns whether pastecat is running or not
global $pcfile;

return(file_exists($pcfile));
}
</code>

És tant simple com sembla, només comprova que el fitxer creat quan es llença el server de Pastecat
encara existeixi. La segona cosa que podem veure nova en el nostre codi és l'existència d'una
nova funció anomenada <code>stop</code>. Aquesta funció invocarà una altra funció en el controlador
que aturarà el servidor de Pastecat:

<code php>
function stop() {
// Stops Pastecat server
global $pcpath,$pcprogram,$title,$pcutils,$avahi_type,$port;

$page = "";
$cmd = $pcutils." stop ";
execute_program_detached($cmd);

return(array('type'=>'redirect','url'=>$staticFile.'/pastecat'));
}
</code>

Per tal de fer que el controlador entengui aquesta ordre, haurem de modificar-ne el <code>case</code> i
afegir-hi la noca funció. En la sentència <code>case</code> hi afegirem el següent sota de l'opció
<code>install</code>:

<code bash>
"stop")
shift
doStop $@
;;
</code>

Això crida la funció <code>doStop</code> dins del mateix controlador. Aquesta funció serà semblant a això:

<code bash>
doStop() {
# Stopping pastecat server
pcpid=$(cat $PCFILE | cut -d' ' -f1)
kill $pcpid

# Removing info file
rm $PCFILE
}
</code>

Aquesta funció agafa el PID de Pastecat del fitxer que hem creat abans, mata el procés i finalment
esborra el fitxer de manera que el php pugui detectar que el pastecat s'ha aturat.

Ara podem crear un servidor de pastecat i aturar-lo. Tot i així, encara hi ha quelcom que manca:
fer que la resta d'usuaris puguin veure el nostre servei. I és per això que utilitzarem Avahi.

=== Publicació de serveis Avahi ===

Una de les millors coses de Cloudy és la característica de publicar els nostres serveis com una
publicació d'avahi, permetent als altres usuaris saber què oferim i unir-se al nostre servei.
Per fer aixo, primer hem d'afegir algunes línies de codi al controlador php, just sota de la crida
al controlador en bash per activar el servidor Pastecat. Afegirem les següents línies:

<code php>
$description = str_replace(' ', '', $description);
$temp = avahi_publish($avahi_type, $description, $port, "");
$page .= ptxt($temp);
</code>

Així que al final la nostra funció quedarà així:

<code php>
function _pcsource($port,$description) {
global $pcpath,$pcprogram,$title,$pcutils,$avahi_type;

$page = "";
$device = getCommunityDev()['output'][0];
$ipserver = getCommunityIP()['output'][0];

if ($description == "") $description = $type;

$cmd = $pcutils." publish '$port' '$description'";
execute_program_detached($cmd);

$page .= t($ipserver);
$page .= par(t('Published this server.'));
$description = str_replace(' ', '', $description);
$temp = avahi_publish($avahi_type, $description, $port, "");
$page .= ptxt($temp);

$page .= addButton(array('label'=>t('Back'),'href'=>$staticFile.'/pastecat'));

return($page)
}
</code>

Amb aquest simple pas hem anunciat el nostre servei a la xarxa d'avahi. Tot i això, la feina
no acaba aquí, encara queda una cosa més a fer: crear un botó i programar-lo de manera que quan
es cliqui, ens redirigeixi directament al nostre servidor de Pastecat.

Per fer això hi ha una carpeta anomenada <code>avahi</code> dins del directori <code>plug</code>.
Els escripts que defineixen l'acció a dur a terme quan es cliquen els botons d'avahi es defineixen
en diferents fitxers dins d'aquest directori. D'aquesta manera, crearem un fitxer anomenat
<code>pastecat.avahi.php</code> que contindrà:

<code php>
<?php
// plug/avahi/pastecat.avahi.php

addAvahi('pastecat','fpcserver');

function fpcserver($dates){
global $staticFile;

return ("<a class='btn' href='http://" .$dates['ip'] .":". $dates['port']."'>Go to server</a> ");
}
</code>

Això crearà un botó al costat de l'anunci d'avahi que apuntarà al nostre servidor.

Ara que ja tenim el nostre servei anunciat, volem que aquest desaparegui un cop aturem el servidor
Pastecat. Aquest últim pas és molt simple però important. Consisteix en unes poques línies de codi
en la funció 'stop' de l'script php. Fins ara, aquesta funció només cridava el controlador bash
i aturava el Pastecat, però ara també aturarà la publicació avahi i mostrarà un breu comentari
donant a conèixer que la crida ha funcionat:

<code php>
$temp = avahi_unpublish($avahi_type, $port);
$flash = ptxt($temp);
setFlash($flash);
</code>

Aquestes línies han de ser afegides just després de la sentència <code>execute_program_detached($cmd)</code>
a la funció stop del php.

=== Final ===

Finalment afegir que tots els fitxers implementats durant aquest tutorial es poden trobar en un repositori GitHub que apareix a l'apartat d'Enllaços Externs, juntament amb aquest mateix tutorial en format Markdown (md).

== Referències ==

<references/>

== Enllaços externs ==

https://github.com/Clommunity/Doc/tree/master/plugins/pastecat

[[Categoria:Cloudy]]
[[en:Cloudy_plug-ins]]
[[es:Cloudy_plug-ins]]

Servidor Proxy/ca

2015-04-16T15:19:57Z

Rogerpueyo:

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

Des de principis del 2013, el paquet guifi-proxy3 autentica els usuaris a través d'una base de dades ldap, situats sota ldap.guifi.net i ldap2.guifi.net.

= 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:
* url servei
* nº del node del servidor proxy (el numero de node del servei)
* Servidor LDAP 1 ( per defecte ldap.guifi.net )
* Servidor LDAP 2 ( per defecte ldap2.guifi.net )
* 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. ( defecte 100Mb )

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)

== Problemes freqüents ==
* '''No funciona l'autenticació de cap usuari:''' Possiblement hi ha o hi ha hagut un problema amb el servidor ldap, en aquest cas, prova de reiniciar squid3 (service squid3 restart). Si segueix sense funcionar, posa't en contacte amb la comunitat a través de la llista [https://llistes.guifi.net/sympa/info/guifi-dev guifi-dev].

== Validació d'usuaris i proxys federats ==
'''Mètode guifi-proxy3 amb ldap:''' guifi-proxy3, consulta a la web el llista de federació dels nodes i es guarda aquesta info per generar el guifi.conf amb la informació de federacions quan ja té aquesta info quin un usuari es valida compara el id de usuari amb el seu id de proxy si aquest usuari pertany a un proxy federat, l'accepta o no.. segons com estigui configurat el proxy on es vol connectar.

El procediment és que s'executa un cron cada 30 minuts i aquest fa una consulta a la web amb els proxys federats que accepta aquell proxy:

<nowiki>http://guifi.net/guifi/export/[id_proxy]/federation</nowiki>

Aquesta petició és instantània a la web. Amb aquesta comprovació el què es fa és regenerar el fitxer /etc/squid3/guifi.conf i integra els nous proxys als que el [id_proxy] està federat.

Paral·lelament, cada 30 minuts, ldap consulta la web i integra els usuaris nous de forma incremental (fa una comparació dels usuaris que hi ha a la bbdd de la web i a l'arbre ldap, i els nous els integra). Un cop al dia, a les 3 del matí, es regenera la bbdd de usuaris de proxy de la web a l'arbre ldap.

Si canvies la contrasenya, o esborres el usuari, el canvi no s'aplica fins a les 3 de la matinada.

== Validació d'usuaris i proxys federats 2 ==
En els Debian 7.3 al fitxer /etc/ldap/ldap.conf hi havia la linea

<nowiki>
#TLS_CACERT /etc/ssl/certs/ca-certificates.crt
</nowiki>

Sense comentar... (cal que estigui comentada) o sigui que nomes pot estar sense comentar la linea TLS_REQCERT never

= Configuracions avançades =

* [[Squid|Manual avançat i complet squid]]
* [[Servidor_Proxy_IM|Permetre connexions serveis de missatgeria]]
* [[Servidor_Proxy_delaypools|Delay Pools]]
* [[Servidor_Proxy_videos|Servidor Proxy per a Vídeos]]
* [[Servidor_Proxy_logs|Canviar el format de la hora dels logs]]
* [[Servidor_Proxy_webmin|Instal·lació + webmin + sarge (Manual Antic)]]
* [[Proxy_socks|Proxy Socks (Proxy per a protocols no http com pop o imap)]]

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

[[Categoria:Proxy]]
[[es:Servidor_Proxy]]
[[en:Proxy_Server]]

Annex:subxarxes mesh

2015-03-11T17:12:13Z

Rogerpueyo: Posar canal de Bellvitge a 124+

Annex:subxarxes mesh

2015-01-13T14:38:52Z

Rogerpueyo: Afegits BSSID (adhoc) i Mesh id (802.11s)

Annex:subxarxes mesh

2014-10-07T21:12:20Z

Rogerpueyo:

Annex:subxarxes mesh

2014-06-30T13:37:32Z

Rogerpueyo:

Annex:subxarxes mesh

2014-06-30T13:27:25Z

Rogerpueyo:

Annex:subxarxes mesh

2014-02-22T12:53:05Z

Rogerpueyo:

{{en desenvolupament}}

{| 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]]
! IP
|-
| CIU
| [[Mesh a Ciutadella]]
| Ciutadella a l'illa de Menorca.
|
| [[qMp]]
| 140- i més ...?
| 10.2.0.0/21
|-
| Wales
| Mesh a Gal·les
| Nodes desplegats a Merthyr Tydfil (més info: Routek.net)
|
| [[qMp]]
| 140-
| 10.1.128.0/17
|-
| gll
| [[Garraf Lliure]]
| Comarca del Garraf a Barcelona
| garraflliure.guifi.net
| [[libre-mesh]]
| 11 i 36
| 10.1.96.0/21
|-
| GS - '''gs'''
| [[GuifiSants]]
| Sants - Les Corts al municipi de Barcelona
|
| [[qMp]]
| 108+, 124+ i 140-
| 10.1.8.0/21
|-
| GSF - '''gsf'''
| [[Gràcia Sense Fils]]
| Vila de Gràcia al municipi de Barcelona
|
| [[gsffirm]] i [[qMp]]
| 140-
| 10.1.0.0/21
|-
| HRT
| [[Horta-Carmel]]
| Part nord del districte Horta-Guinardó al municipi de Barcelona
|
| [[qMp]]
| 140-
| 10.1.72.0/21
|-
| HW
| [[Hospitalet Wireless]]
| Núvol de Bellvitge a la ciutat de l'Hospitalet del Llobregat
|
| [[qMp]]
| 124-
| 10.1.32.0/21
|-
| IRU
| [[Mesh a Iruña]]
| Núvol Mesh a Iruña a Navarra
|
| [[qMp]]
| 140-
| 10.1.248.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
| [[qMp]], [[altermesh]] i [[libre-mesh]]
| 48
| 10.1.104.0/21
|-
| P9SF - '''p9sf'''
| [[Poblenou Sense Fils]]
| Poblenou al municipi de Barcelona
|
| [[qMp]]
| 140-
| 10.1.64.0/21
|-
| RAV - '''rav'''
| [[Mesh al Raval]]
| Barri del raval al municipi de Barcelona
|
| [[qMp]]
| 140-
| 10.1.16.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
|-
| 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
|-
| SAND - '''sand'''
| [[Mesh a Sant Andreu]]
| Barri de Sant Andreu al municipi de Barcelona
|
| [[qMp]]
| 140-
| 10.1.56.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
|-
| vllc
| [[Mesh a Vallcarca]]
| Barri de Vallcarca i els Penitents al municipi de Barcelona
|
| [[qMp]]
| 108+ i 140-
| 10.1.48.0/21
|}

<references />

'''IMPORTANT: Actualment hi ha un conflicte amb els adreçaments IP de les zones d'''Anglaterra'' i ''Iruña''. S'hauria de corregir abans de que aquestes illes connectin amb la resta de Guifi, per tal d'evitar problemes.'''

[[categoria:MANET]]