Manual:Installing MediaWiki/fr

MediaWiki s'installe automatiquement en utilisant un script d'installation interactif dôté d'une interface web. Avant de pouvoir lancer le script, vous devez effectuer deux ou trois choses. Premièrement, assurez-vous de bien avoir installé les prérequis (Apache/IIS, MySQL4 ou ultérieur (5 ou ultérieur pour la version 1.19) et PHP 5). Ensuite vous devez obtenir le package logiciel MediaWiki et le télécharger sur votre serveur. Vous aurez peut-être besoin de créer une nouvelle base de données pour votre wiki. Si nécessaire, créez un compte sur votre serveur web en suivant les instructions données sur la création de comptes système.

MediaWiki peut sembler difficile à installer pour un utilisateur d'ordinateur lambda qui n'a pas l'expérience d'Apache, PHP et MySQL. La majeure partie des utilisateurs qui souhaitent utiliser le logiciel wiki pourraient plutôt tirer profit à utiliser un hébergeur wiki gratuit (Voir une liste des hébergeurs wiki sur Wikibooks) ou par un installateur logiciel.

Pour les informations de dépannage, voir la page sur les erreurs d'installation.

= == Télécharger MediaWiki == =

Téléchargez MediaWiki depuis la page de téléchargement officielle ou depuis Git.

Par exemple, pour télécharger MediaWiki, qui est la dernière version, vers une machine *nix, vous pouvez utiliser la commande suivante : wget http://download.wikimedia.org/mediawiki//mediawiki-.tar.gz Si vous souhaitez utiliser cURL : curl -O http://dumps.wikimedia.org/mediawiki//mediawiki-.tar.gz

Les fichiers téléchargés sont au format  et ils auront besoin d'être décompressés avant d'être utilisés. Ceci peut être fait localement (puis téléversé par FTP) ou directement sur votre serveur. Ceci est habituellement fait avec un logiciel du type 7-Zip (libre), WinZip, WinRAR ou IZArc (libre) sur Windows. Sur Linux et Mac OS X, vous pouvez décompresser le fichier en utilisant cette commande :

tar xvzf mediawiki-*.tar.gz

NOTE : si vous décomprimez l'archive en tant que root, vous devrez probablement passer l'option --owner=votre_userid pour la décompression (ou changer l'affectation après coup avec chown). Autrement, les fichiers seront détenus par l'utilisateur # 1000, qui peut ou être votre compte utilisateur.

Fichiers téléversés
Si vous n'avez pas encore téléchargé les fichiers sur le serveur, c'est le moment de le faire.

Assurez-vous que l'option "Change file names to lowercase" (passer les noms de fichier en minuscule) pour le téléversement est bien désactivée.

Utilisez pour cela un client FTP comme FileZilla (Open Source, Windows) ou Cyberduck (OSX). Si vous avez installé apache, le dossier correct se trouve dans votre fichier. Si vous êtes sur Linux/Unix vous pouvez aussi les mettre dans n'importe quel dossier sur le serveur et créer un lien symbolique pour ce dossier depuis le répertoire web du serveur.

= == Préparer les dossiers == =

MediaWiki doit être capable d'écrire dans le dossier  quand le script d'installation s'exécute. Si vous ne l'avez pas encore fait, vous devez changer les permissions pour le dossier  dans le dossier de MediaWiki.

= == Créer une base de données == =

Si vous connaissez le mot de passe de l'utilisateur racine, le script d'installation peut créer la base de données pour vous. Si c'est le cas, vous pouvez aller directement à la section Lancer le script d'installation ci-dessous. Si vous ne le connaissez pas, par exemple si vous êtes sur un hébergement partagé, vous devez créer une nouvelle base de données maintenant pour le wiki. Vous devez utiliser soit MySQL soit Postgres pour stocker le contenu du wiki.

= ===MySQL=== =


 * Vous devez créer une base de données MySQL et un utilisateur avant d'installer MediaWiki. Vous pouvez le faire en utilisant différents logiciels comme PhpMyAdmin qui sont souvent disponible chez les hébergeurs partagés ou alors utiliser ssh pour vous connecter au serveur ou une ligne de commandes MySQL, voir la documentation correspondante. Sinon contactez votre hébergeur pour qu'il vous crée un compte.
 * Téléchargez et installez MySQL 5.0, il devrait se mettre dans /usr/local/mysql.
 * Vérifiez que le serveur de base de données fonctionne ("/usr/local/mysql/bin/mysqladmin status"). Sinon, sudo /usr/local/mysql/bin/safe_mysqld &. (Pour Fedora Core 5, utilisez /usr/bin/mysqld_safe)
 * Une autre manière pour démarrer le serveur MySQL est de lancer le script configure disponible dans la racine de l'installation. Il crée les tables initiales et démarre automatiquement le démon mysql
 * Définissez un mot de passe pour le compte "root" dans votre serveur de base de données. /usr/local/mysql/bin/mysqladmin -u root password yourpassword
 * Créez un utilisateur dans MySQL pour votre wiki, faites ceci dans un terminal /usr/local/mysql/bin/mysql -u root -p mysql
 * Ceci démarre le client de ligne de commandes de MySQL, faites ceci dans le terminal :

create database wikidb; grant create, select, insert, update, delete, alter, lock tables on wikidb.* to 'wikiuser'@'localhost' identified by 'password'; flush privileges; \q

Si le serveur de base de données ne se trouve pas sur le même serveur que le serveur web, vous devez indiquer le nom du serveur (mediawiki.example.com dans l'exemple suivant), comme suit : grant create, select, insert, update, delete, alter, lock tables on wikidb.* to 'wikiuser'@'mediawiki.example.com' identified by 'password';

= === Postgres === =

Si vous utilisez Postgres, vous aurez besoin soit de vous faire créer un utilisateur et une base de données ou simplement de donner le nom d'un utilisateur avec les privilèges "superuser" au script d'installation. L'utilisateur avec ces privilèges s'appelle souvent postgres.

La base de données que MediaWiki va utiliser doit avoir plpgsql et tsearch2 installés. Le script d'installation va essayer de trouver et installer plpgsql, mais vous pourrez avoir besoin d'installer tsearch2 vous même (tsearch2 est utilisé pour rechercher le texte de votre wiki). Ici est décrit une manière de faire la majeure partie de l'installation. Elle est faite pour un environnement Unix et présume que vous avez déjà installé les modules plpgsql et tsearch2. Dans cet exemple nous allons créer une base de données nommée wikidb détenue par un utilisateur nommé wikiuser. Depuis la ligne de commande en tant qu'utilisateur postgres, suivez les étapes suivantes :

createuser -S -D -R -P -E wikiuser (entrez ensuite le mot de passe) createdb -O wikiuser wikidb createlang plpgsql wikidb

Ajouter tsearch2 à la base de données n'est pas une chose facile mais heureusement il va être fait par n'importer quel paquet qui a installé le module tsearch2. Dans n'importe quel cas, le script d'installation vous dira s'il n'arrive pas à trouver le module tsearch2.

Les étapes ci-dessus ne sont pas toutes nécessaires parce que le script d'installation va le faire pour vous si vous lui avez donnée le nom et le mot de passe du super utilisateur.

Pour installer tsearch2 à la base de données wikidb sous Windows, faites les étapes suivantes :

C'est fait.
 * 1) cherchez tsearch2.sql (probablement à .\PostgreSQL\8.x\share\contrib) et copiez le dans le dosssier postgresql\8.x\bin
 * 2) depuis une ligne de commande dans le dossier postgresql\8.x\bin, tapez "psql wikidb < tsearch2.sql -U wikiuser";
 * 3) on va vous demander le mot de passe de wikiuser

Le point 2 ne semble marcher que sous Windows parce que sous Debian Linux 4.0 (etch) seulement posgres est autorisé à utiliser le langage c. il doit donc être appelé par :

su - postgres -c psql wikidb < tsearch2.sql

après quoi vous devez donner les droits select à wikiuser pour la table tsearch et insert à locale.

su - postgres psql -d wikidb -c "grant select on pg_ts_cfg to wikiuser;" psql -d wikidb -c "grant select on pg_ts_cfgmap to wikiuser;" psql -d wikidb -c "grant select on pg_ts_dict to wikiuser;" psql -d wikidb -c "grant select on pg_ts_parser to wikiuser;" psql -d wikidb -c "update pg_ts_cfg set locale = current_setting('lc_collate') where ts_name = 'default' and prs_name='default';"

Si vous recevez une erreur similaire à "ERROR: relation "pg_ts_cfg" does not exist" quand vous exécutez la commande ci-dessus, essayez de réinstaller tsearch2 à la base de données wikidb mais en le faisant en deux étapes (et réessayez ensuite de donner les permissions) :

1) su - postgres 2) psql wikidb -f tsearch2.sql

= == Lancer le script d'installation == =

Quand tout ce qui est ci-dessus est fait, vous pouvez continuer l'installation depuis votre navigateur web. Voir Manual:Config script/fr pour plus de détails.