Manual:Installing MediaWiki/fr

MediaWiki s'installe en utilisant un script d'installation interactif avec une interface web. Avant de pouvoir lancer le script, vous devez effectuer quelques opérations. D'abord soyez sûr que vous avez installé Apache, PHP et MySQL. Ensuite vous devez obtenir une copie du logiciel et la télécharger sur votre serveur. Vous pourriez avoir besoin de créer une base de données pour le wiki. Si nécessaire, créez un compte sur votre serveur web en suivant les instructions données sur Manual:Installation/Creating system accounts.

Pour les informations de dépannage, voir Manual:Errors and Symptoms.

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

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

Décompressez les fichiers localement ou sur votre serveur web. Ceci est généralement fait grâce à des logiciels comme 7-Zip (open source), WinZip, WinRAR ou IZArc sur Windows. Sur Linux, vous pouvez utiliser la commande suivante :

tar xvzf mediawiki-*.tar.gz

Si vous n'avez pas encore téléchargé les fichiers sur le serveur, c'est le moment de le faire. 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.