Hi ha diverses guies de com instal·lar-se tot el tingladu necessari per a poder desenvolupar els mòduls de drupal de guifi.net però tot i que siguin força senzills sempre hi ha alguna opció que no et funciona, alguna configuració de l'Apache que fa la punyeta, etc...

Per sort, com tot a la vida, hi ha una sol·lució fàcil: màquines virtuals!

Què és?

Una màquina virtual (entrada Virtualització de la Viquipèdia) és un fitxer que ve a ser una representació d'un ordinador però que no existeix físicament, sinó que els programes de virtualització el creen virtualment. Gràcies a això pots tenir en un sol ordinador tants ordinadors virtuals com et facin falta (mentre ho aguanti el teu ordinador).

La màquina virtual de guifi.net

És una Debian amb el mínim necessari instal·lat i que ja conté l'Apache, el Drupal, els mòduls de guifi.net del Subversion de lafarga.cat i una versió de la base de dades de guifi.net.

Amb aquesta màquina virtual, un cop baixada i instal·lada podreu posar-vos a remenar el codi que hi ha darrere dels formularis i llistats de guifi.net per a millorar-los sense cap més entrebanc que entendre el codi, res de configurar l'Apache, barallar-se amb el PHP o el Drupal :)

Instal·lació de la màquina virtual

• Baixeu la màquina virtual
• Descomprimiu-la
• Instal·leu-vos el VirtualBox (disponible per a Linux, Mac i Windows, la majoria de distribucions de Linux ja el porten en els seus catàlegs de programari)
• Afegiu la màquina virtual que us heu baixat al VirtualBox. Heu d'anar a Fitxer -> Gestor de suports virtuals (drecera Ctrl+D). Allà afegiu un disc dur virtual existent i seleccioneu el fitxer que heu descomprimit.
• Creeu una màquina virtual nova (apunteu-vos el nom que el necessitareu més endavant) i quan us demani el disc dur que voleu fer servir li dieu el que heu afegit en el punt anterior.

Llestos, ja teniu la màquina virtual instal·lada.

Redirigir els ports

Per a facilitar encara més la feina podeu fer que el vostre ordinador redirigeixi alguns ports en concret cap a la màquina virtual, de manera que per exemple si teclegeu http://localhost:8000/guifi vagi a la màquina virtual i us retorni la pàgina de guifi. Per a fer-ho heu de teclegar en un terminal (instruccions per a Linux, per a Mac i Windows hauria de ser semblant però no ho puc assegurar):

Nota: Substituïut NOM_MAQUINA_VIRTUAL per el nom que li heu donat a la màquina virtual.

Nota 2: Heu d'executar aquestes ordres amb la màquina virtual completament apagada, sinó no us funcionaran.

# VBoxManage setextradata "NOM_MAQUINA_VIRTUAL" "VBoxInternal/Devices/pcnet/0/LUN#0/Config/guesthttpd/HostPort" 8000
# VBoxManage setextradata "NOM_MAQUINA_VIRTUAL" "VBoxInternal/Devices/pcnet/0/LUN#0/Config/guesthttpd/GuestPort" 80
# VBoxManage setextradata "NOM_MAQUINA_VIRTUAL" "VBoxInternal/Devices/pcnet/0/LUN#0/Config/guesthttpd/Protocol" TCP

També podeu fer el mateix amb el port 22 (ssh):

# VBoxManage setextradata "NOM_MAQUINA_VIRTUAL" "VBoxInternal/Devices/pcnet/0/LUN#0/Config/ssh/HostPort" 2222
# VBoxManage setextradata "NOM_MAQUINA_VIRTUAL" "VBoxInternal/Devices/pcnet/0/LUN#0/Config/ssh/GuestPort" 22
# VBoxManage setextradata "NOM_MAQUINA_VIRTUAL" "VBoxInternal/Devices/pcnet/0/LUN#0/Config/ssh/Protocol" TCP

Un cop fet això podreu accedir a http://localhost:8000/ i us retornarà el "It works!" de l'Apache i també podreu fer un ssh a la màquina virtual (ssh -p 2222 root@localhost)

Usuaris

De nou, per a facilitar-ho tot encara més els usuaris i contrasenyes són el màxim de senzilles possibles.

Usuaris del sistema:

• root / guifi
• guifi / guifi

Usuaris del mysql:

• root / guifi
• guifi / guifi

Usuaris del drupal:

tots els usuaris de la pàgina web tenen la contrasenya guifi, l'usuari administrador és webmestre.

Més facilitats:

Com que la base de dades on es desa tot és MySQL també hi he instal·lat un phpMyAdmin, i podeu accedir des de http://localhost:8000/phpmyadmin

El web de guifi és a http://localhost:8000/guifi

El codi dels mòduls de guifi

Com que el codi dels mòduls de guifi és a lafarga.cat teniu el codi anònim a /root/guifi-drupal. Això d'anònim vol dir que he baixat el codi amb el meu usuari però sense que el Subversion es desi les credencials d'autenticació, de manera que cadascú s'haurà de registrar per ell mateix a la pàgina de lafarga.cat i ja podrà baixar-se les actualitzacions del codi.

Nota: per a poder enviar canvis fets heu d'enviar un correu a en Lluís Dalmau o a les llistes de guifi per demanar permisos d'escriptura.

Resum

Codi a: /root/guifi-drupal

El primer cop que feu un svn up us demanarà l'usuari i contrasenya de lafarga.cat

Drupal: http://localhost:8000/guifi

phpMyAdmin: http://localhost:8000/phpmyadmin

Tots els usuaris tenen de contrasenya "guifi"

Dubtes i suggeriments de millora

• Llistes de correu de guifi
• Xat de guifi