IMPORTANT: Per accedir als fitxer de subversion: http://acacha.org/svn (sense password). Poc a poc s'aniran migrant els enllaços. Encara però funciona el subversion de la farga però no se sap fins quan... (usuari: prova i la paraula de pas 123456)

Vegeu també mediawiki

Hi ha dos formes principals d'instal·lar-se una wiki (o en general qualsevol aplicació web) en una distribució GNU/Linux:

  • Instal·lació des del repositories de la distribució: per exemple en distribucions de la família Debian (com per exemple Ubuntu) podeu instal·lar la mediawiki utilitzant eines com apt o Synaptic. En altres distribucions Linux es faria quelcom similar utilitzant eines com yum o rpm. Cal que tingueu en compte que normalment aquest tipus d'aplicacions s'instal·len en entorn de producció on correu un sistema operatiu de servidor i on molt possiblement no tindreu entorn gràfic. Per aquesta raó és aconsellable conèixer sempre la instal·lació des de la línia de comandes. Depenent de la distribució i de l'aplicació web us podeu trobar que el procés sigui mḉes o menys automàtic.
  • Instal·lació manual: l'opció que sempre està disponible és instal·lar a mà l'aplicació web. En aquest casos normalment el que es fa és baixar un paquet d'Internet (típicament un fitxer zip o tar.gz) i fer tota la instal·lació a mà. Aquest tipus d'instal·lació acostuma a ser més tediosa. A canvi teniu un control total sobre el procés d'instal·lació.

Quin procés escollir? no és una decisió fàcil. Cal que tingueu en compte:

  • Les aplicacions instal·lades a partir dels repositoris no solen ser la última versió de l'aplicació. Si necessiteu "estar a l'última" descarteu l'opció d'instal·lació des dels repositoris. Per exemple si consulteu la web:
http://packages.ubuntu.com/karmic/mediawiki

veureu que la versió del paquet mediawiki per a Ubuntu 9.10 (karmic) és la 1.15.0 mentre que a la wiki de mediawiki trobareu la versió 1.15.2.

  • Les instal·lacions des dels repositoris tenen l'avantatge de que podreu actualitzar la vostra aplicació de forma automàtica al aparèixer una nova versió als repositoris. En canvi amb la instal·lació manual, les actualitzacions també han de ser manuals,
  • Si necessiteu una configuració a mida que surti dels estàndards o formes comunes d'instal·lació haureu de fer una instal·lació manual.

Passos previs

Cal disposar d'un entorn LAMP. Executeu:

$ sudo tasksel install lamp-server

Instal·lació manual

Per tal d'obtenir la última versió de mediawiki cal anar a la web oficial:

http://www.mediawiki.org/wiki/MediaWiki/ca

Busqueu l'apartat de descarregues, quelcom similar a:

CapturaPantallaMediawiki.png

NOTA: Un cop trobeu l'enllaç de descàrrega, amb el botó dret podeu fer "Copia l'enllac" per copiar la URL al "portapapers"

I us baixeu la última versió (--acacha 09:55, 21 març 2010 (UTC)), us recomano que ho feu amb wget que és un gestor de descarregues per línia de comandes (recordeu que si instal·leu mediawiki en un entorn d'explotació de servidor no tindreu entorn gràfic i per tant no tindreu navegador web gràfic.)

A més amb wget podeu baixar-vos el paquet directament a la carpeta del sistema que us interessi. A on instal·larem l'aplicació web mediawiki? podríeu instal·lar-la a on volguéssiu sempre i quan tots els passos subsegüents fossin coherents. Ara bé, personalment us recomano seguir l'estàndard File Hierarchy System FHS, segons el qual a Linux cada cosa té una carpeta especifica segons la seva funcionalitat. La wiki, com aplicació que es pot compartir entre els diferents usuaris del sistema aniria a:

/usr/share/mediawiki

IMPORTANT: L'exemple següents està basat en la versió de wiki disponible a data --acacha 09:31, 23 març 2011 (UTC). Aneu a la web http://www.mediawiki.org/wiki/Download per tal d'obtenir l'última versió

Per tant feu el següent:

$ cd /usr/share      
$ sudo wget http://download.wikimedia.org/mediawiki/1.16/mediawiki-1.16.2.tar.gz

Ara ja teniu el fitxer comprimit en format tar.gz. Per descomprimir:

$ sudo tar xvzf mediawiki-1.16.2.tar.gz

Això us crearà la carpeta:

/usr/share/mediawiki-1.16.2

Us recomano que li canvieu el nom per mediawiki:

/usr/share/mediawiki

amb

$ sudo mv /usr/share/mediawiki-1.16.2 /usr/share/mediawiki

NOTA: De fet hem utilitzar la carpeta /usr/share/mediawiki per que és la carpeta que utilitzaria la instal·lació des dels repositoris. Consulteu la llista de fitxer del paquet mediawiki.

Ara només cal configurar Apache per tal que utilitzi els fitxers que acabem d'instal·lar. El nostre objectiu és aconseguir que la URL:

http://localhost/nomaplicacioweb

Mostri l'aplicació web en concret. Fixeu-vos que diem "aplicació web" en genèric, pel fet que, aquest pas que anem a fer ara, és equivalent per a qualsevol altre aplicació web que no sigui mediawiki. Aviat us adonareu que un cop instal·lada una aplicació web qualsevol, instal·lar-ne un altre és sempre molt similar.

En el nostre cas volem que la URL:

http://localhost/mediawiki

Mostri els fitxers de la carpeta:

/usr/share/mediawiki

Hi ha múltiples formes d'assolir aquest objectiu amb Apache, però segurament el més senzill és utilitzar la directiva Alias. Els passos a seguir per crear un lloc web a Apache són:

Definiu el lloc web com a lloc disponible:

$ sudo joe /etc/apache2/sites-available/mediawiki

I afegiu:

Alias /mediawiki /usr/share/mediawiki 

<Directory /usr/share/mediawiki >
        Options +FollowSymLinks
        AllowOverride All
        order allow,deny
        allow from all
</Directory>

# some directories must be protected
<Directory /usr/share/mediawiki/config>
        Options -FollowSymLinks
         AllowOverride None
 </Directory>
<Directory /usr/share/mediawiki/images>
        Options -FollowSymLinks
        AllowOverride None
</Directory>

NOTA: La carpeta config és la carpeta que s'utilitza durant la instal·lació i la carpeta images es on es guarden els fitxers que es carreguen a la mediawiki

Ara el lloc està només disponible! Per activar el lloc cal fer:

$ sudo a2ensite mediawiki
Enabling site mediawiki.
Run '/etc/init.d/apache2 reload' to activate new configuration!

NOTA: Podeu desactiva temporalment un lloc, sense perdre la configuració, amb l'ordre a2dissite. També cal recarregar Apache per desactivar el lloc.

Aquesta comanda l'únic que fa és crear un enllaç simbòlic del fitxer /etc/apache2/sites-available/mediawiki a /etc/apache2/sites-enabled/mediawiki:

$ ls -la /etc/apache2/sites-enabled/mediawiki 
lrwxrwxrwx 1 root root 28 2010-03-21 11:33 /etc/apache2/sites-enabled/mediawiki -> ../sites-available/mediawiki

Tal i com us diu per aplicar els canvis:

$ sudo /etc/init.d/apache2 reload

NOTA: Si consulteu Apache. Configuració d'un site podreu obtenir més detalls sobre com instal·lar un lloc web a Apache

Abans d'instal·lar la base de dades mitjançant l'assistent que proporciona mediawiki us recomanem que instal·leu phpmyadmin:

$ sudo apt-get install phpmyadmin

NOTA: Si us demana una paraula de pas és la que heu escollit per a l'usuari root de mysql durant la instal·lació de LAMP

Phpmyadmin és de fet una aplicació web, a la qual podeu accedir amb:

http://localhost/phpmyadmin

Per tal de poder accedir a la base de dades poseu l'usuari root i la paraula de pas que heu escollit durant la instal·lació de LAMP. Observeu que no hi ha cap base de dades instal·lada. Un cop hagin acabat la instal·lació veureu com l'instal·lador de mediawiki us ha creat una base de dades (normalment anomenada wikidb), us haurà creat les taules necessàries per a treballar i fins i tot l'usuari i els permisos necessàries per que mediawiki pugui accedir a aquesta base de dades.

Ara ja podeu accedir a:

http://localhost/mediawiki

Us apareixerà quelcom similar a:

InstalacioMediawiki1.png

Feu clic a "Setup de wiki". Segurament us indicarà que heu de modificar els permisos per tal de poder continuar:

Wiki sintesi14.png
cd /path/to/wiki
chmod a+w config

És a dir:

$ cd /usr/share/mediawiki
$ sudo chmod a+w config

Amb l'última comanda esteu donant permisos d'escriptura (w) a tothom (a) a la carpeta config. Torneu a la web i feu clic a setup. Ara us mostrarà el menú d'instal·lació. El primer que fa el menu és comprovar que teniu tot el necessari:

InstalacioMediawiki2.png

Ara heu d'omplir les dades de la vostra wiki. Poseu:

  • El nom que li voleu donar a la vostra wiki
  • Poseu el correu electrònic de l'administrador de la wiki
  • Escolliu l'idioma (per ex. català)
  • Escolliu una paraula de pas per a l'usuari administrador de la wiki (WikiSysop)
InstalacioMediawik3.png

Les opcions de cache les deixeu per defecte:

InstalacioMediawiki4.png

NOTA: La mediawiki pot utilitzar aplicacion de cache que fan més ràpida l'execució de la wiki. En aquest curs no ho utilitzarem

L'apartat:

E-mail, e-mail notification and authentication setup

També el deixeu amb les opcions per defecte. L'apartat important és:

Database config

Aquí cal que poseu (vegeu l'imatge de més avall):

  • Database host: És l'adreça on es troba el servidor de base de dades. Tot i que podria estar en una base de dades remota, el normal és que es trobi al mateix servidor que el servidor web. Per tant deixeu localhost.
  • Database name: L'opció wikidb és correcta. Normalment només es canvia si ja hi ha una base de dades amb aquest nom o si no podeu escollir aquest nom (per exemple en un proveïdor ISP que només us proporciona una base de dades i amb un nom concret)
  • DB username: Igual que l'anterior l'opció per defecte ja està bé
  • DB password: Heu de escollir una paraula de pas. Aquest paraula de pas només l'utilitzarà l'aplicació mediawiki per accedir a la base de dades. Heu de tenir en compte que aquesta paraula de pas es guarda a un fitxer (/usr/share/mediawiki/LocalSettings.php) i per tant tingueu en compte no posar cap paraula de pas important
  • DB password confirm: Torneu a escriure la paraula de pas

NOTA: Podeu utilitzar l'ordre mkpasswd per tal que us generi una paraula de pas:

InstalacioMediawiki5.png

IMPORTANT: No us deixeu de marca l'opció Superuser account. Si no la marqueu suposarà que el usuari de base de dades i la base de dades ja estan creades i no les intentarà crear!

  • Superuser account: Si disposeu de la paraula de pas de l'usuari root del servidor mysql marqueu aquesta opció.
  • Superuser name: Normalment és root
  • Superuser password: És la paraula de pas que heu escollit al instal·lar LAMP amb tasksel.

De les opcions:

MySQL specific options

No cal que canvieu res. Només a vegades cal posar un prefix a les taules si la base de dades es comparteix amb altres aplicacions. Aleshores se sol posar:

Database table prefix: mediawiki_

Ara ja podeu posar:

Install Mediawiki
InstalacioMediawik15.png

Si us surt un:

Installation Succesfull

en verd és que tot ha anat correctament. Ara només falta un últim pas:

$ sudo mv /usr/share/mediawiki/config/LocalSettings.php /usr/share/mediawiki

IMPORTANT: Ara cal canviar els permisos del fitxer per seguretat:

$ sudo chmod 660 /usr/share/mediawiki/LocalSettings.php 

I ja podeu fer clic al link que us proporcionant o anar a:

http://localhost/mediawiki

Ja teniu una mediawiki instal·lada. Si accediu a phpmyadmin:

http://localhost/phpmyadmin

Ara veureu que hi ha una base de dades anomenada wikidb, am bles taules corresponents:

BasedeDadesMediawiki.png

NOTA: No fa tant de temps, totes les passes de crear la base de dades, crear les taules, l'usuari, etc s'havia de fer manualment. Ara la majoria d'aplicacions web inclouen un instal·lador que ho fa tot automàticament.

Instal·lació des dels repositoris

El paquet mediawiki esta a Universe i per tant hem d'afegir aquest repositori al fitxer /etc/apt/sources.list:

Un cop canviat el fitxer cal no oblidar de fer un update

 $ sudo apt-get update

I ja podem instal·lar:

 $ sudo apt-get install mediawiki

Nota IMPORTANT

A Ubuntu Gutsy hi han noves versions de mediawiki. Podem instal·lar:

$ sudo apt-get install mediawiki1.10

També cal instal·lar mysql i php5-mysql si volem utilitzar Mysql en comptes de PostgreSQL:

$ sudo apt-get install mysql-server-5.0 php5-mysql

I un cop instal·lat cal modificar el fitxer /etc/mediawiki1.10/apache.conf:

$ sudo joe /etc/mediawiki1.10/apache.conf

I la línia:

#Alias /mediawiki /var/lib/mediawiki1.10

la descomentem:

Alias /mediawiki /var/lib/mediawiki1.10

I ara tornem a iniciar Apache.

$ sudo /etc/init.d/apache2 restart

Configuració

Un cop instal·lada la mediawiki cal executar el configurador. Obrim la url http://localhost/mediawiki a un navegador. Per exemple:

 $ mozilla-firefox http://localhost/mediawiki

i apareixera una web com la següent:

MediawikiInstalation1.png

Cal anar omplint els camps del configurador. Per exemple (tots els camps dels que no es diqui res especificament considerem els valors per defecte com correctes):

  • Site name: Nom que vulgueu posar a la wiki
  • Contact email: POdeu posar el vostre correu o deixar el valor per defecte.
  • Language: Podeu escollir català o castellà.
  • Password Sysop: establiu una contrasenya (cal escriurela dos cops)
  • Memory Caching: Les opcions per defecte son correctes.
  • Database config:
    • Establir password wikiuser
    • Prefix: mediawiki_
    • DB root password: Si acabem de instal·lar mysql-server deixem en blanc (password root mysql per defecte) o si no posem el que pertoqui.

MediawikiInstalation2.png

MediawikiInstalation3.png

Si tot es correcte al executar el formulari web tindrem una pàgina com aquesta:

MediawikiInstalation.png

Fixeu-vos que al final ens explica els últims passos que em de dur a terme. Traduits en comandes:

 $ sudo mv /var/lib/mediawiki/config/LocalSettings.php /etc/mediawiki/LocalSettings.php
 $ sudo chmod 600 /etc/mediawiki/LocalSettings.php
 $ sudo rm /var/lib/mediawiki/config

Clickem a l'enllaç i ja tenim una wiki instal·lada.