Manual:Running MediaWiki on GNU/Linux/fr

Dans la version 1.2.0, il était possible d'installer et de configurer MediaWiki directement à l'endroit voulu, du moment que les logiciels requis étaient disponibles. Depuis la 1.3.0, l'installeur en ligne de commande a disparu.

Pré-requis

edit

Les logiciels pré-requis sont :

  • Serveur Web (comme Apache) avec PHP 4.1.2 au moins (4.3.x est la version conseillée) : voir www.php.net/manual/en/install.unix.php
  • Un serveur MySQL : 4.0.x est la version conseillée, mais 3.2.x devrait également marcher. Voir dev.mysql.com/doc/mysql/en/Installing.html.
  • PHP ne devrait pas être configuré comme un serveur CGI, mais comme un module Apache. L'option safe_mode n'est pas testée et n'est pas supposée fonctionner.
  • Apache, PHP et MySQL doivent avoir été configurés.

Important : avant une mise à jour, effectuez une sauvegarde de la base de données !

Installation "en place"

edit
  Avertissement : La méthode décrite autorise tout les utilisateurs du système à modifier la configuration du wiki, ce qui est dangereux.
  1. Décompressez l'archive soit sur le serveur, soit sur la machine à partir de laquelle vous allez télécharger le site.
  2. Renommez le dossier "mediawiki-1.x.x" en quelque chose comme "wiki" (c'est ce qui apparaîtra dans l'URL).
  3. Autorisez l'écriture dans le dossier "config" avec la commande chmod a+w config
  4. Pointez votre navigateur sur le dossier wiki, qui vous emmènera dans le dossier "config". Remplissez le formulaire, en vous rappelant que vous n'utilisez sûrement pas une connexion cryptée !
  5. Si tout va bien, le logiciel devrait vous dire que la configuration est terminée, et un fichier "LocalSettings.php" devrait être présent dans le dossier "config" : déplacez-le dans le dossier principal, et le site devrait fonctionner.
  6. Une fois le wiki configuré, effacez le dossier "config", ou au moins mettez-le en lecture seule.

Configuration

edit
  1. Téléchargez MediaWiki : Download/fr ou allez voir Download from SVN/fr
  2. Si vous téléchargez un fichier gzippé, décompressez les fichiers sources dans un répertoire : tar zxvf mediawiki-x.y.z.tar.gz.

(Si vous n'êtes pas un vrai Linux Guru et que vous avez WinRAR (comme WinZip mais fonctionne sur des fichiers gzippés) sur votre système Windows, vous pouvez tricher un peu ici. Vous pouvez télécharger le fichier sur votre machine Windows, utiliser WinRAR pour décompresser le fichier gzippé dans un répertoire de Windows et ensuite utiliser un programme FTP comme WS_FTP Pro pour transférer le répertoire entier du wiki.)

  1. La nouvelle installation par le Web n'a normalement pas besoin d'un accès root. Si vous utiliser l'ancienne installation, vous pouvez avoir besoin d'utiliser des commandes comme : su - and mv /path_to_mediawiki_unzip_dir/. À cette étape de l'installlation, vous devriez avoir lu le README, RELEASE-NOTES et INSTALL du répertoire mediawiki-x.y.z. Cependant, gardez à l'esprit que ces fichiers ou ce guide peuvent ne plus être valides, auquel cas nous apprécierons vos mises à jour de cette page. :)
  2. Déplacez le dossier dans votre répertoire Web: e.g. mv mediawiki-x.y.z /usr/local/apache/htdocs/wiki ou mv mediawiki-x.y.z public_html/wiki ou utilisez votre client FTP pour le faire à votre place.
  3. Vous devez configurer votre base de données (database) dans laquelle vous stockerez votre wiki. Dans Cpanel, vous pouvez cliquer sur Base de données MySQL (MySQL Databases). Vous aurez besoin d'Ajouter une Database avec le nom de la base de données voulue, Ajouter un Utilisateur pour créer un utilisateur avec un accès à la base de données, puis Ajouter un Utilisateur à la Base Pour connecter cet utilisteur à la database. Rappelez-vous de ces informations car vous en aurez besoin au lancement du script d'installation du wiki. Finally click on phpMyAdmin at the bottom of the MySQL Account Maintenance page in Cpanel to check your information and get MySQL running.
  4. To run the install script, you'll need to temporarily make the 'config' subdirectory writable by the web server. The simplest way to do this on a Unix/Linux system is to make it world-writable by typing: chmod -R a+w config in the directory you intend to install MediaWiki in. To do this you will need a telnet client like PuTTY on your system.
  5. If you run the script and you get an error saying the script is unable to write to the tmp directory you may need to change the permissions for the tmp directory in your root. If you are installing on a new system you may need to change this. Often this directory will be already set up with write permission granted, so you can skip this step and come back if you run into a problem. To change the permissions for the tmp directory go into the root directory and type: chmod -R a+w tmp You typically must have root access in order to change the permissions to this directory. If you get an error message and you don't have root access then you will need to contact your service provider.
  6. At this point you should have Apache and MySQL running (this varies between distributions and setups, see their documentations for specifics). If you follow the steps above you really don't need to worry about this as they will be running automatically. Anyway, the install worked for me.
  7. Go to your browser and surf into the wiki directory. It'll direct you into the config script (if it doesn't, just load up the mediawiki-1.3.0beta4/config/index.php file). Fill out the form...remember you're probably not on an encrypted connection. Gaaah! :)
  8. If all goes well, you should soon be told that it's set up your wiki database and written a configuration file. There should now be a 'LocalSettings.php' in the config directory; move it back up to the main wiki directory, and the wiki should now be working.
  9. Once the wiki is set up, you should remove the config directory, or at least make it not world-writable (though it will refuse to config again if the wiki is set up) using again chmod -R a-w config. If you changed the tmp directory you can probably leave this as is so you can install other software on your system.

Utilisation d'un PHP Accelerator ?

edit

Dans quelques cas, si vous utilisez la version 1.2.4, vous pourriez rencontrer des problèmes pendant l'installation. Si cela arrive, essayez de désactiver phpa en plaçant php_value phpa Off dans le fichier .htaccess du répertoire racine de votre installation.

Instructions spécifiques aux plates-formes

edit
Debian GNU/Linux
Manual:Running MediaWiki on Debian GNU/Linux
Gentoo Linux
Manual:Running MediaWiki on Gentoo Linux
Mandrake Linux
Manual:Running MediaWiki on Mandrake
Red Hat Linux
Manual:Running MediaWiki on Red Hat Linux
Slackware Linux
Manual:Running MediaWiki on Slackware Linux
SuSE Linux 9.3
Manual:Running MediaWiki on SuSE Linux 9.3
Ubuntu
Manual:Running MediaWiki on Ubuntu/fr

Voir aussi

edit

Références

edit

Fichier INSTALL de mediawiki-1.3.2.tar.gz