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.

Téléversez les fichiers sur le répertoire web de votre serveur web soit en : Si vous avez installé apache, le dossier correct se trouve dans votre fichier  (il s'agit généralement de  ).
 * 1) copiant directement le fichier compressé, soit
 * 2) en utilisant un client FTP comme  FileZilla (logiciel Open Source, Windows, OSX et Linux) ou Cyberduck (OSX).

Si vous utilisez un serveur Linux ou 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.

Renommez le répertoire téléversé selon le nom que vous voulez avoir dans l'URL. Si votre serveur web fonctionne selon le  par exemple, le renommer   voudrait dire que vous accèderiez à votre wiki avec. N'utilisez pas  si vous souhaitez l'utiliser comme URL courte.

On se référera au répertoire (renommé) sous le nom de.

= == Préparer les dossiers == =

MediaWiki 1.16 et les versions précédentes ont besoin de pouvoir écrire dans le dossier  lorsqu'ils démarrent leur script d'installation. Cela n'est plus nécessaire.

Suivant la configuration du serveur, vous devrez dans certains cas cocher toutes les cases (777) dans FileZilla, afin de pouvoir lancer l'installateur. Sur Unix ou Linux, si vous avez les droits d'admin, vous pouvez taper la ligne de commande  dans votre répertoire.

= == 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.

Si vous utilisez un serveur web nginx avec spawn-fcgi et obtenez l'erreur suivante :

Error starting session: session_start: open(/var/lib/php/session/sess_xxxxxxxxxxxx, O_RDWR) failed: Permission denied (13)

Vous devrez taper la ligne qui suit :

Et si ça ne marche toujours pas, tapez :

MediaWiki devrait être installé dans un sous-répertoire de votre dossier racine et non directement dans le dossier racine. Cela veut dire que, si votre domaine  contient par exemple un dossier racine intitulé , alors MediaWiki devrait être installé dans un répertoire nommé   ou équivalent. MediaWiki deviendra disponible sur. Ceci est particulièrement important si vous compter utiliser les URL courtes.

Créer une base de données
Si vous disposez déjà d'une base de données et connaissez le mot de passe pour y accéder, le script d'installation de MediaWiki peut créer une nouvelle base de données pour vous. Si c'est le cas, vous pouvez passer à la section lancer le script d'installation ci-dessous. Si vous ne connaissez pas le mot de passe root, par exemple si vous vous trouvez sur un serveur hébergé, vous aurez à créer une nouvelle base de données dès maintenant. En ce moment, vous devrez utiliser SQLite, MySQL ou Postgres pour stocker le contenu actuel de votre wiki.

SQLite
MediaWiki supporte SQLite depuis la version 1.13, cependant, il est hautement recommandé de disposer au moins de la version 1.16. SQLite est une bibliothèque de bases de donnée standalone qui stocke le contenu de la base de données en un simple fichier. Si PHP dispose du module pdo-sqlite, il n'y a pas besoin de réglage supplémentaire.

Sur la page d'installation, vous aurez besoin de choisir un nom de base de donnée (c'est vous qui voyez) et le répertoire de la base de données SQLite. Pour le répertoire de la base de données, l'installateur tentera d'utiliser un sous-répertoire en dehors du dossier racine et le crée si nécessaire. Si ce répertoire n'est pas sûr (par exemple, lisible sur le web), modifiez le à la main pour empêcher qu'il soit accessible à tout le monde sur le web.

= ===MySQL=== =

MediaWiki vous demandera une base de données et un nom d'utilisateur et tentera de les créer s'ils n'existent pas déjà. Si en faisant cela depuis MediaWiki s'avère impossible, vous pouvez le faire en utilisant différents panneaux de contrôle comme PhpMyAdmin, qui est souvent disponible sur les hébergeurs partagés, ou vous pouvez utiliser ssh pour vous connecter sur votre hébergeur et taper les commandes dans un invite MySQL. Voir la documentation associée. Autrement, contactez votre fournisseur d'hébergement pour leur demander de créer un compte pour vous.

Installation sur Linux/Unix

 * Téléchargez et installez MySQL - MediaWiki supporte les versions 5.0.2 ou ultérieures. MySQL s'installe typiquement dans /usr/local/mysql. (Si vous utilisez votre gestionnaire de packages de votre distribution Linux pour installer MySQL, les commandes suivantes peuvent se trouver dans un autre répertoire ; essayez de les taper sans le préfixe de chemin /usr/local/mysql/bin/.)
 * Vérifiez et voyez si le serveur de bases de données tourne ; par exemple lancez /usr/local/mysql/bin/mysqladmin status . Si cela ne marche pas, lancez mysqld_safe pour le démarrer : sudo /usr/local/mysql/bin/mysqld_safe &.
 * Un autre moyen de faire un premier démarrage du serveur MySQL est de lancer le script configure disponible à 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 votremotdepasse
 * Lancez le client de ligne de commande MySQL : /usr/local/mysql/bin/mysql -u root -p
 * Cela vous amènera directement à la ligne de commande pour entrer le mot de passe de la base de donnée "root" que vous venez juste de définir, puis connectez-vous sur le serveur MySQL. Maintenant, continuez avec les commandes MySQL ci-dessous.

Installation sur Windows

 * Téléchargez un msi MySQL (mysql-5.2.22-winx64.msi par exemple).
 * Lancez le fichier msi et acceptez les options par défaut. Au moment de créer le compte initial, utilisez un mot de passe dont vous vous souviendrez.
 * Dans le menu démarrer, faites Demarrer->Tous les programmes->MySQL->MySQL server->MySQL Command Line Client.
 * Entrez le mot de passe initial que vous venez juste de créer.
 * Maintenant, poursuivez l'installation en reprenant les instructions ci-dessous.

Poursuite de l'installation
create database wikidb; grant index, create, select, insert, update, delete, alter, lock tables on wikidb.* to 'wikiuser'@'localhost' identified by 'motdepasse';

Si votre base de données ne s'exécute pas sur le même serveur que votre serveur web, vous devez indiquer le nom d'hôte du serveur web approprié (mediawiki.exemple.com dans l'exemple suivant) comme suit : grant index, create, select, insert, update, delete, alter, lock tables on wikidb.* to 'wikiuser'@'mediawiki.exemple.com' identified by 'motdepasse';

= === 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 pourriez avoir besoin d'installer tsearch2 vous même (tsearch2 est utilisé pour rechercher le texte de votre wiki). Voici un moyen de faire la majeure partie de l'installation. Elle est faite pour un environnement de type Unix et suppose 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 (puis entrez le mot de passe) createdb -O wikiuser wikidb

Ou bien en tant que superutilisateur (par defaut postgres) exécutez les lignes de commande suivantes à l'invite de la base de données :

CREATE USER wikiuser WITH NOCREATEDB NOCREATEROLE NOSUPERUSER ENCRYPTED PASSWORD 'password'; CREATE DATABASE wikidb WITH OWNER wikiuser;

Si vous utilisez PostgreSQL 9.0 ou supérieur, vous n'avez pas besoin d'ajouter pl/pgsql car il est installé par défaut.

Ajout de tsearch2
Si vous utilisez PostgreSQL 8.3.x, vous n'avez pas besoin d'exécuter les étapes suivantes pour installer tsearch2 étant donné qu'il a été intégré dans le noyau.

Ajouter tsearch2 à la base de données n'est pas une chose facile mais heureusement cela sera fait par n'importe quel processus de package qui demande l'installation du module tsearch2. Dans tous les 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 tout !
 * 1) cherchez tsearch2.sql (probablement à .\PostgreSQL\8.x\share\contrib) et copiez le dans le dosssier postgresql\8.x\bin
 * 2) depuis un invite 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 pour 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

Sélection des droits d'accès
Ensuite vous devez donner les droits à wikiuser pour les tables tsearch et insérer la bonne localisation.

PostgreSQL 8.2 et antérieur
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 message du type "ERROR: relation "pg_ts_cfg" does not exist" quand vous exécutez la commande ci-dessus, essayez de réinstaller tsearch2 dans 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

PostgreSQL 8.3 et supérieur
su - postgres psql -d wikidb -c "grant select on pg_ts_config to wikiuser;" psql -d wikidb -c "grant select on pg_ts_config_map 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;"

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

Une fois toutes les étapes ci-dessus achevées, vous pouvez terminer l'installation depuis un navigateur web. Voir le manuel du script de configuration pour plus de détails.

Si besoin, vous pouvez lancer l'installateur en ligne de commande ou CLI :.

Maintenez-vous à jour !
Souscrivez à notre liste des sorties de mises à jour.

Une fois installé, assurez-vous de rester à jour avec les nouvelles versions et gardez votre serveur sûr !

Assistance à l'installation

 * FAQ: Installation et configuration
 * mediawiki-l (Liste courriel) est la liste courriel à trafic élevé pour appeler à l'aide
 * MediaWiki Users (Forum) est un forum de support utilisateur à utilisateur