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

Introducció al desenvolupament de Guifi.net

2017-11-20T15:58:27Z

Rgf1042: /* Introducció */

Aquest document ens ajudarà a començar a desenvolupar sobre els serveis i aplicacions que trobem a la xarxa de guifi. Principalment la xarxa comunitària Guifi.net està construïda sobre la web www.guifi.net basada en el '''CMS''' ''Drupal'', no obstant, actualment també tenim altres eines que interactuen amb aquest Drupal o que directament es troben aïllades.

= Repositoris =

Per treballar en projectes en grup s'utilitzen repositoris amb control de versions, com per exemple '''git'''. A Guifi.net disposem d'una pàgina de ''github.com'' on hi trobarem tots els repositoris de software de la xarxa. La seva direcció és https://github.com/guifi

= Entorns de desenvolupament preparats =
== Introducció ==
Des de l'estiu del 2017 disposem d'entorns de desenvolupament basats en la tecnologia ''Docker''. ''Docker'' és un software que permet col·locar aplicacions dins d'uns contenidors amb les seves pròpies llibreries i de forma aïllada del sistema operatiu del host. Podeu descarregar una presentació que es va mostrar al passat SAX de Valls que explica els detalls de ''Docker'' i l'ús que en fem a Guifi:
[[:File:docker-intro.pdf|Presentació Docker]]

== Instal·lació de Docker ==
Tot-hi que Docker és multiplataforma, només funcionen les imatges que estan basades en aquell sistema operatiu, és a dir, no es pot executar un contenidor d'una imatge de ''Windows'' amb un host que executi ''Linux''. Totes les imatges de guifi estan basades en ''Linux'' així que es necessari aquest sistema. Per tal d'instal·lar ''Docker'' es recomana seguir les indicacions de la seva pàgina oficial: https://www.docker.com/

Encara que la vostre distribució incorpori ''Docker'' no se'n recomana la instal·lació ja que normalment els paquets es troben força desactualitzats.

Un cop instal·lat ''Docker'' hem d'instal·lar el ''Docker Compose''. Aquesta eina ens permet executar aplicacions basades en més d'un contenidor. Per fer-ho, necessitem l'aplicació ''pip'' de '''Python''' i instalar el paquet ''docker-compose''.

Per a ''Debian/Ubuntu'' les instruccions són:

$ sudo apt install python-pip
$ sudo pip install docker-compose

== Posada en marxa dels entorns ==
S'ha creat un repositori especific per totes les composicions de ''Docker''. Per fer-ho servir necessitem clonar el repositori:

$ git clone https://github.com/guifi/docker-guificompose.git

I navegar pels diferents directoris fins arribar a la composició que ens interessi:

$ docker-compose up

Amb aquesta comanda ja tindrem l'aplicació a desenvolupar executant-se a la nostra màquina.

= Projectes principals =
== Web Drupal 6 ==
És la web principal de la xarxa guifi.net. Actualment es basa en el popular '''CMS''' ''Drupal 6'' i conté dos mòduls de desenvolupament propi (drupal-guifi i drupal-budgets). El primer d'aquests mòduls serveix per representar i descriure la xarxa (assignació de direccions, enllaços, serveis...) i el segon és útil pel recompte de despeses per tal de que els implicats en la xarxa puguin assumir els costos d'operació i construcció segons l'ús de la xarxa per part d'ells.

== Eina fiberfy ==
És una aplicació utilitzada per descriure projectes de fibra òptica de la xarxa Guifi. Permet descriure l'obra cívil involucrada en els desplegaments de fibra i també permet especificar la capa física del desplegament de fibra (splitters, cables...). L'eina es troba desenvolupada en ''node.js'' basada en una '''API Rest''' i el client web està desenvolupat seguint els paradigmes de '''SPA''' (Single Page Application) en JavaScript.

== guifiproxy ==
És un servidor basat en ''squid3'' que interconnecta amb la base de dades d'usuaris de Guifi i permet la creació de proxys sobre la xarxa amb accés a Internet.

== guifimaps ==
És un conjunt d'scripts juntament amb el software [http://mapserver.org/ MapServer] que ens permet traçar els enllaços entre nodes que formen la xarxa. Aquests scripts estan fets en '''PHP'''.

== snpservices ==
És l'eina que ens permet graficar l'estat de la xarxa basant-se en el paradigme de [https://guifi.net/node/5192 Xarxes espontànies]. Per fer aquesta tasca utilitza l'eina ''rrdtool'' i un script fet amb '''PHP'''.

== dnsservices ==
És l'eina que s'utilitza per crear servidors de DNS dins del context de Guifi. Obté les entrades de DNS de la base de dades de la web i genera les configuracions pel servidor de DNS bind.

[[Categoria:desenvolupament]]

Fitxer:Docker-intro.pdf

2017-11-20T15:56:42Z

Rgf1042: MsUpload

MsUpload

Portada

2017-11-20T15:38:11Z

Rgf1042: /* Desenvolupadors */

__NOTITLE__
{| style="background:#f6f6f6; border:1px solid #C7D0F8; font-size:107%; -moz-border-radius:1em; -webkit-border-radius:1em;border-radius:1em; width:100%;"
| valign="top" style="padding:12px 17px 5px 17px" |
'''Guifi.net''' és de tothom, participa-hi [[connectar|connectant]] el teu [[tram de xarxa]] amb el dels altres.

És un projecte col·laboratiu [[organització horitzontal|organitzat horitzontalment]] que agrupa tan a persones individuals, col·lectius, empreses i administracions.

És obert i per tant tothom hi pot participar en igualtat de condicions en el marc del [http://guifi.net/ComunsXOLN Comuns de la Xarxa Oberta, Lliure i Neutral]
<div style=" text-align: right">[[Guifi.net|Més sobre Guifi.net]]</div>
{| style="width:100%; background:#f6f6f6"
| style="background:#f6f6f6; text-align: right; width 30%" |<div style="width: 400px; margin: 0 auto; background-color: #fcfcfc; border: 1px solid #ccc; border-bottom: 5px groove #999999; border-right:5px groove #999999; text-align: center; padding: 0.4em;"><div style="font-size: 162%; padding: 0.1em;">Benvinguda al wiki de '''Guifi.net'''</div>
<div style="font-size: 95%;">Documentació sobre la xarxa oberta, lliure i neutral.</div>
<div style="font-size: 85%;">En aquests moments tenim [[Especial:Estadístiques|{{NUMBEROFARTICLES}}]] [[Especial:Llista_de_pàgines|articles]] en català.</div>
<div style="font-size: 85%;">Ajuda [[Què és un wiki#Categories|categoritzant]] un dels [[Especial:Pàgines_sense_categoria|articles sense categoritzar]], pots fer servir les [[Especial:Categories|categories ja existents]].</div>
</div>
|}
{| style="background:#f6f6f6; width:100%;"
|''A la documentació de guifi.net hi ha els documents de referència per a usuaris novells, experimentats i desenvolupadors. Sigues lliure [[Què és un wiki|d'editar aquest wiki]] per millorar-ne el seu contingut.''
<div style=" text-align: center">Contacta: [http://guifi.net/forum Fòrums] '''|''' [http://llistes.guifi.net Llistes de correu] '''|''' [http://guifi.net/xat Xat]</div>
|}
|}

{| id="mp-upper" style="width: 100%; margin:6px 0 0 0; background:none; border-spacing: 0px;"
| style="width:50%; background:#FFFFE0; border:1px solid #EECFA1; padding:10px; margin-bottom:7px; vertical-align:top; -moz-border-radius:1em; -webkit-border-radius:1em; border-radius:1em;" |

<div id="mp-tfa">
{| id="mp-left" style="vertical-align:top; background:#FFFFE0; border-spacing: 0px;"
! style="background:#FFDEAD; border:1px solid #EECFA1; border-right:0px; padding:0px; font-size:150%; vertical-align:middle; font-weight:normal; width:100%;" | Com unir-se a Guifi.net
! style="background:#a5e085; border:1px solid #99CC33; border-left:0px; padding:0px; vertical-align:middle;" |
|-
| colspan=2 style="color:#000; background:#FFFFE0; padding:15px 5px" | <div id="mp-itn"><div style="text-align:left; font-size:95%;">

* [[tres passos|Com donar d'alta i enllaçar un node]]
* [[Escull el material]]
* [[Configura el teu ordinador]]
* [http://guifi.net/ca/BonesPractiques Bones pràctiques]

|}</div>

| style="border:1px solid transparent;" |
| style="width:50%;background:#f5fffa;border:1px solid #99CC33;padding:10px;margin-bottom:7px; vertical-align:top;-moz-border-radius:1em;-webkit-border-radius:1em;border-radius:1em; " |
<div id="mp-itn">
{| id="mp-left" style="vertical-align:top; background:#f5fffa; border-spacing: 0px;"
! style="background:#a5e085; border:1px solid #99CC33; border-right:0px; padding:0px; font-size:150%; vertical-align:middle; font-weight:normal; width:100%;" | Supernodes i illes
! style="background:#a5e085; border:1px solid #99CC33; border-left:0px; padding:0px; vertical-align:middle;" |
|-
| colspan=2 style="color:#000; background:#f5fffa; padding:15px 5px" |<div id="mp-itn"><div style="text-align:left; font-size:95%;">
* [[Començar una illa des de 0]]
* [[Crear un supernode]]
* [http://guifi.net/ca/BonesPractiques Bones pràctiques]</div></div>
|}</div>
|}

{| id="mp-upper" style="width: 100%; margin:6px 0 0 0; background:none; border-spacing: 0px;"
| style="width:50%; style="background:#f5faff;border:1px solid #cedff2;padding:10px;margin-bottom:7px; vertical-align:top;-moz-border-radius:1em;-webkit-border-radius:1em;border-radius:1em; " |
<div id="mp-dyk">

<div style="float:right;">__TOC__</div>
== [[Legal]] ==
* [[Particulars]]
* [[Institucions]]
* [[Empreses]]
* [[Serveis_General]]
* [[Associació|Constitució d'una associació]]

== Finançament ==
* [[Models de finançament]]

== Xarxa ==
=== Els bàsics a la web ===
* [[Zona|Crear i modificar una zona]]
* [[Afegir_un_node_de_guifi.net|Afegir un node de guifi.net]]
* [[Serveis|Crear serveis i vincular-los als servidors]]
* [[Usuaris dels Proxys Federats]]
* [[Eines|Eines (localització de IPs i MACs, estadístiques, mapes d'enrutament, etc.)]]

=== Infraestructura ===
{{div col|cols=2}}
* [[Crear_un_supernode|Muntatge de supernodes]]
* [[Filtres de xarxes]]
* [[Enllaços virtuals]]
* [[Node frontera amb qMp]]
* [[Hotspot]]
* [[Eina per buscar rangs de IPs lliures]]
* [[Creació de túnels PPTP (Debian/dd-wrt/Mikrotik)]]
* [[PPTP_airos|Tunel PPTP desde antena AirOS]]
* [[Script per detectar problemes de latència]]
* [[Tweaks antenes]]
* [[Fibra_òptica|Fibra Òptica]]
* [[Gestio_vlans_ubnt_supernode|Vlan de gestió ubnt en supernode híbrid]]
* [[Toughswitch_supernode_hibrid|Gestió supernode híbrid amb vlan i toughswitch]]
* [[Fer_bonding_de_dues_ADSL_amb_Routerboard|Fer bonding de dues ADSL amb una Routerboard]]
* [[Calcul_RF|Càlculs RF]]
{{div end}}

=== Mesh ===
* [[Obrir_xarxes_tipus_mesh_a_trav%C3%A9s_de_Guifi.net|Crear una xarxa Mesh en Guifi.net]]
* [[Connectar-se_a_una_xarxa_mesh|Connectar-se a una xarxa Mesh de Guifi.net]]
* [[Annex:subxarxes_mesh|Llistat de les xarxes Mesh]]
* [[Quick Mesh Project (qMp)]] ([[:es:Quick Mesh Project|es]])
* [[Alix+GSF|Configurar Àlix per connectar-se al núvol Mesh de gràcia amb gsffirm]] (antic) ([[:es:Alix|es]])
* [[Altermesh]] (roaming mesh en Capa 2 amb BATMAN-adv) ([[:es:Altermesh|es]])
* [[Mesh|Altres articles sobre Mesh]]

=== Enrutaments i conceptes de xarxes ===
{{div col|cols=2}}
* [[Enrutament]] --General--
* [[Peerings]]
* [[Tunejant salts-BGP PREPEND ]]
* [[Redundància BGP-OSPF-BGP ]]
** [[Exemple iBGP]]
* [[Agregacions BGP ]]
* [[Pesos BGP]]
* [[BGP 2 AS en 1 AS]] (útil per a supernodes amb 2 mikrotiks)
* [[IPv4]]
* [[IPv6]]
* [[Criteris d'assignació d'adreces IPv4]]
* [[ARP]]
* [[Cables_UTP|Cables UTP]]
* [http://packetlife.net/library/cheat-sheets/ Resum de conceptes de xarxa]
{{div end}}

=== General ===
{{div col|cols=2}}
* [[Com es vertebra la xarxa: Troncal, punts d'accés i connexions simples]]
* [[La seguretat a la xarxa oberta]]
* [[Aplicacions | Aplicacions de Guifi.net]]
* [[Recursos externs]]
* [[Instal·lar firmware Ubiquiti Rocket M5]]
{{div end}}

== Sistemes ==
=== Serveis bàsics ===
{{div col|cols=2}}
* [[Configurar Repositori apt guifi]]
* [[Servidor Proxy]]
* [[Servidor de gràfiques]]
* [[Servidor DNS]]
* [[Servidor Rellotge|Servidor de Rellotge (NTP)]]
* [[Servidor logs remots rsyslogd ]]
* [[Configurar xarxa]]
{{div end}}

=== Serveis de compartició de fitxers ===
* [[Servidor FTP]]
* [[Servidor Peer 2 Peer]]
* [[Servidor DCC]]

=== Serveis de missatgeria ===
* [[Servidor de Correu]]
* [[Webmail]]
* [[Servidor Jabber]]
* [[Servidor IRC]]
* [[Mailman]]
* [[Whatsapp]]

=== Serveis de Veu i Vídeo ===
* [[VoIP|Servidor de VeuIP (VoIP)]]
* [[Servidor Radio Streaming]]

=== Altres Serveis ===
{{div col|cols=2}}
* [[LDAP|Servidor LDAP]]
* [[Apache|Servidor web Apache]]
* [[Servidor Repositori Linux]]
* [[Servidor Repositori Linux (Cache)]]
* [[Servidor Iperf]]
* [[Servidor repositori subversion]]
* [[DHCP|Servidor DHCP]]
* [[MySQL]] (Bases de Dades)
* [[Proxmox]] (virtualització)
* [[Cacti]] (monitoratge)
* [[Servei de notificació d'incidencies]] (Servei de notificació d'incidencies)
* [[Monitoratge_Cacti_UBNT|Cacti per a trastos UBNT]]
* [[Clamav]] (antivirus amb GNU/Linux)
* [[Trac]] (sistema de gestió de tiquets)
* [[Squid]] (configuracions avançades squid)
* [[PXE]] (Instal·lació per xarxa)
* [http://www.example.com Observium] (Monitoratge molt gràfic, GPL)
{{div end}}

=== Sistema ===
* [[ACPI]]
* [[Bridges_amb_Linux|Bridges amb GNU/Linux]]
* [[Chroot]]
* [[Corkscrew]]
* [[Túnel Proxy SOCKS]]
* [[Manteniment_de_discs_durs|Manteniment de discs durs]]

=== Cloudy ===
* [[Què és Cloudy]]
* [[Cloudy plug-ins]]
* [[Cloudy|Altres articles sobre Cloudy]]

== Instal·ladors ==
* [[Parallamps]]
* [[Reaprofitar el cable d'antena de televisió]]
* [[Pressupostos]]
* [[Utilitzar RB Mikrotik com a tunel PPPoE Movistar-Jazztel-altres]]
* [http://guifi.net/ca/node/12486 Comunitat de veïns, cas d'exemple]
* [[Configuració de l'antena per a les gràfiques (SNMP)]]
* [[Campanars]]
* [[Accesos Routerboards]] - Per a instal·ladors principiants
* [[Administració senzilla usuari Guifi amb Routerboard Mikrotik]] - Per a instal·ladors principiants

== Desenvolupadors ==
* [[Introducció al desenvolupament de Guifi.net]]
* [[Manual editor wiki]]
* [http://wiki.guifi.net/wiki/Trac Trac de Guifi.net]
* [[Actualitzacions mòduls drupal]]
* [http://gitorious.org/guifi Repositoris de codi del projecte guifi.net]
* [[Mapa del codi]]
* [[API de Guifi]]
* [[CNML]]
* [[Empotrar el mapa de Guifi-Google Maps a una web]]
* [[Unsolclic]]
* [[Preparant l'entorn de desenvolupament]]
* [[:Categoria:router|Routers]]
* [[:Categoria:Telefonia mòbil|Telefonia mòbil]]
* [[Eficiència energètica]]

== Dissenyadors ==
* [[Logos]]
* [[Maquetació de les diverses pàgines web]]
* [[Usabilitat]]
* [[Presentacions de guifi.net]]

== Desenvolupament col·lectiu de la xarxa ==
* [[Cursos]]
* [[Necessitats]]

== Camp de treball ==
* [http://camp2012.guifi.net Bloc del camp de treball 'Internet per a tothom! Vic 2012]

== Glossari ==
* [[Recull de termes emprats habitualment]]
* [[Guia Ràpida de Guifi.net]]
* [[Preguntes Freqüents]]
* [http://guifi.net/ca/CADocs Documents ubicats a la web de guifi.net] antiga "ComEsFa"
|}

= Accessos Ràpids =
* [http://planet.guifi.net Planet]
* [http://guifi.net/cxoln Comuns (Llicència de la xarxa)]
* [http://guifi.net/maps Mapa guifi]
* [[Webs Regionals]]
* [http://trac.guifi.net Reporta Errors de la web]
* [http://fundacio.guifi.net Fundació]
* [http://guifi.net/ca/info Recull de guies i manuals]
* [http://etherpad.guifi.net/serveris-de-guifi Llistat de serveis variats entorn al projecte]
[[es:Portada]]
[[en:Main Page]]
[[eu:Azala]]
[[fr:Accueil]]
[[gl:Portada]]
[[pt:Página principal]]

Introducció al desenvolupament de Guifi.net

2017-11-20T15:35:04Z

Rgf1042: Es crea la pàgina amb «Aquest document ens ajudarà a començar a desenvolupar sobre els serveis i aplicacions que trobem a la xarxa de guifi. Principalment la xarxa comunitària Guifi.net e...».

Aquest document ens ajudarà a començar a desenvolupar sobre els serveis i aplicacions que trobem a la xarxa de guifi. Principalment la xarxa comunitària Guifi.net està construïda sobre la web www.guifi.net basada en el '''CMS''' ''Drupal'', no obstant, actualment també tenim altres eines que interactuen amb aquest Drupal o que directament es troben aïllades.

= Repositoris =

Per treballar en projectes en grup s'utilitzen repositoris amb control de versions, com per exemple '''git'''. A Guifi.net disposem d'una pàgina de ''github.com'' on hi trobarem tots els repositoris de software de la xarxa. La seva direcció és https://github.com/guifi

= Entorns de desenvolupament preparats =
== Introducció ==
Des de l'estiu del 2017 disposem d'entorns de desenvolupament basats en la tecnologia ''Docker''. ''Docker'' és un software que permet col·locar aplicacions dins d'uns contenidors amb les seves pròpies llibreries i de forma aïllada del sistema operatiu del host.

== Instal·lació de Docker ==
Tot-hi que Docker és multiplataforma, només funcionen les imatges que estan basades en aquell sistema operatiu, és a dir, no es pot executar un contenidor d'una imatge de ''Windows'' amb un host que executi ''Linux''. Totes les imatges de guifi estan basades en ''Linux'' així que es necessari aquest sistema. Per tal d'instal·lar ''Docker'' es recomana seguir les indicacions de la seva pàgina oficial: https://www.docker.com/

Encara que la vostre distribució incorpori ''Docker'' no se'n recomana la instal·lació ja que normalment els paquets es troben força desactualitzats.

Un cop instal·lat ''Docker'' hem d'instal·lar el ''Docker Compose''. Aquesta eina ens permet executar aplicacions basades en més d'un contenidor. Per fer-ho, necessitem l'aplicació ''pip'' de '''Python''' i instalar el paquet ''docker-compose''.

Per a ''Debian/Ubuntu'' les instruccions són:

$ sudo apt install python-pip
$ sudo pip install docker-compose

== Posada en marxa dels entorns ==
S'ha creat un repositori especific per totes les composicions de ''Docker''. Per fer-ho servir necessitem clonar el repositori:

$ git clone https://github.com/guifi/docker-guificompose.git

I navegar pels diferents directoris fins arribar a la composició que ens interessi:

$ docker-compose up

Amb aquesta comanda ja tindrem l'aplicació a desenvolupar executant-se a la nostra màquina.

= Projectes principals =
== Web Drupal 6 ==
És la web principal de la xarxa guifi.net. Actualment es basa en el popular '''CMS''' ''Drupal 6'' i conté dos mòduls de desenvolupament propi (drupal-guifi i drupal-budgets). El primer d'aquests mòduls serveix per representar i descriure la xarxa (assignació de direccions, enllaços, serveis...) i el segon és útil pel recompte de despeses per tal de que els implicats en la xarxa puguin assumir els costos d'operació i construcció segons l'ús de la xarxa per part d'ells.

== Eina fiberfy ==
És una aplicació utilitzada per descriure projectes de fibra òptica de la xarxa Guifi. Permet descriure l'obra cívil involucrada en els desplegaments de fibra i també permet especificar la capa física del desplegament de fibra (splitters, cables...). L'eina es troba desenvolupada en ''node.js'' basada en una '''API Rest''' i el client web està desenvolupat seguint els paradigmes de '''SPA''' (Single Page Application) en JavaScript.

== guifiproxy ==
És un servidor basat en ''squid3'' que interconnecta amb la base de dades d'usuaris de Guifi i permet la creació de proxys sobre la xarxa amb accés a Internet.

== guifimaps ==
És un conjunt d'scripts juntament amb el software [http://mapserver.org/ MapServer] que ens permet traçar els enllaços entre nodes que formen la xarxa. Aquests scripts estan fets en '''PHP'''.

== snpservices ==
És l'eina que ens permet graficar l'estat de la xarxa basant-se en el paradigme de [https://guifi.net/node/5192 Xarxes espontànies]. Per fer aquesta tasca utilitza l'eina ''rrdtool'' i un script fet amb '''PHP'''.

== dnsservices ==
És l'eina que s'utilitza per crear servidors de DNS dins del context de Guifi. Obté les entrades de DNS de la base de dades de la web i genera les configuracions pel servidor de DNS bind.

[[Categoria:desenvolupament]]

Entorn de desenvolupament de Guifi.net basat en Drupal 7

2017-06-22T14:51:26Z

Rgf1042: Ordre de paràmetres en comanda service erònia (corregit)

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 apache2 restart
* '''Ubuntu'''
# service apache2 restart
* '''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]]