Instal·lació i configuració de la Mediawiki, 1a part

De wikijoan
Salta a la navegació Salta a la cerca

Introducció

A classe hem explicat què són les wikis. Instal·laràs la Mediawiki, que és l'eina que va desenvolupar la Fundació Wikipèdia per fer la Wikipèdia. La Viquipèdia catalana ja té més de 20 anys.

En la teva empresa o organització pots implantar una wiki com a eina de documentació col·laborativa

Desenvolupament. Instal·lació

  • Descarreguem de www.mediawiki.org la última versió.
  • Llegim els fitxers INSTALL, README, etc.
  • Veiem que en el directori principal tenim el script index.php
  • Configurem el nostre servidor Apache per accedir a aquest recurs local.

Ja podem començar la instal·lació. Detecta que és la primera vegada (no troba el fitxer LocalSettings.php), i això significa que estem en la fase d'instal·lació.

En l'ordinador del professor l'únic requeriment que no es complia era:

You are missing a required extension to PHP that MediaWiki requires to run. Please install:

mbstring (more information)
$ sudo apt-cache search php | grep mbstring
php-mbstring - MBSTRING module for PHP [default]
php7.4-mbstring - MBSTRING module for PHP

$ sudo apt-get install php-mbstring

reiniciar apache

És possible que en els portàtils dels alumnes faltin alguns altres requeriments. Fins que no es compleixin, no es podrà seguir amb la instal·lació.

Mirem la funció phpinfo() de PHP, on podrem veure els mòduls que hi ha instal·lats. És tan fàcil com definir el script

phpinfo.php:

<?php
phpinfo();
?>

i comprova que ja tens el mòdul de mbstring habilitat. Comprova també que tens els mòduls de postgres per a PHP instal·lats (farem servir Postgres com a base de dadees).

Abans de continuar amb la instal·lació, ens assegurem de què el Postgres el tenim disponible:

$ psql -h localhost -p 5432 -U postgres -d postgres

En el procés d'instal·lació ens demanarà com es dirà la base de dades (my_wiki per defecte) i com es dirà l'esquema sobre el qual s'instal·laran les taules (mediawiki per defecte). Aquesta base de dades no cal instal·lar-la prèviament. Es crea en el procés d'instal·lació.

  • nom de la wiki: wikibalmes
  • nom usuari: joan (usuari de la wiki, no de la base de dades)
  • password: ***** (usuari de la wiki, no de la base de dades)

I s'executen tots els scripts d'instal·lació. Si tot va bé, ja tenim la base de dades creada. S'ha creat el fitxer LocalSettings.php. Aquest fitxer el descarreguem i l'hem de copiar en el directori arrel de la wiki.

La base de dades

Comprovem que ens podem connectar a la wiki:

$ psql -h localhost -p 5432 -U postgres -d my_wiki
Password for user postgres: 
psql (12.4 (Ubuntu 12.4-0ubuntu0.20.04.1))
SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, bits: 256, compression: off)
Type "help" for help.

my_wiki=# 

Per veure totes les taules:

my_wiki=# \dt mediawiki.*

Són 52 taules

On són els scripts que s'han executat per crear la base de dades?

$ cd ~/M09_IAW_2021/UF2/mediawiki-1.35.1/

$ find . -type f -print | xargs egrep -i "CREATE DATABASE"
...
./includes/installer/DatabaseInstaller.php:	 * Create database tables from scratch.
...
./includes/installer/PostgresInstaller.php:			$conn->query( "CREATE DATABASE $safedb", __METHOD__ );
...

fitxers importants:

  • ./includes/installer/DatabaseInstaller.php
  • ./includes/installer/PostgresInstaller.php
  • ./maintenance/postgres/archives/tables.sql


Entrega

Entregaràs la pràctica al Classroom. Només se't demana que demostris que has fet una instal·lació correcta de la Mediawiki, i que has solucionat els possibles problemes. Recorda que estem instal·lant la Mediawiki al Postgres, no al MySQL (que era una altra possibilitat). Encara hi ha una 3a possibilitat: SQLite.


creat per Joan Quintana Compte, abril 2021