Help:Installation 1.9.0 - 1.9.2 (fr)

Cette page décrit comment installer Semantic MediaWiki 2.0 et 2.1 sur un serveur à base Linux à partir duquel vous disposez d'un accès ligne de commande (shell). Il existe aussi une page d'aide pour l'installer sur un serveur à base Windows (en anglais). Cette méthode d'installation est fortement recommandée. Si vous ne disposez pas d'accès ligne de commande, c'est-à-dire que vous ne pouvez pas utiliser Composer pour l'installation et la mise à jour, vous devrez installer la version du fichier comme décrit sur cette page d'aide avec l'installation de la version de fichier de SMW (en anglais). Veuillez bien vérifier les prérequis et suivre attentivement les instructions. Assurez-vous de bien comprendre les avertissement légaux sur le fichier COPYING (en anglais) avant de poursuivre.

Pour mettre à jour un wiki tournant sur une version plus ancienne de SMW, assurez-vous de bien lire la section appropriée avant de commencer la mise à jour.

''Les instructions d'installation ou de mise à jour de Semantic MediaWiki ne s'appliquent pas au Semantic Bundle qui utilise aussi Semantic MediaWiki. Voir la page d'aide Semantic Bundle pour la procédure à suivre.''

'''Si vous utilisez MediaWiki 1.23 et ultérieur et/ou PHP 5.4 et ultérieur, il est fortement recommandé d'installer ou de mettre à jour vers Semantic MediaWiki 2.0 ou ultérieur. Les versions 1.9 et antérieures de SMW sont déconseillées pour un usage en production.

Prérequis
Les informations de compatibilité et les exigences minimum requises pour Semantic MediaWiki sont énumérées dans le document de compatiblité (en anglais). Assurez-vous de bien satisfaire au prérequis avant d'installer Semantic MediaWiki.

Notes générales

 * Semantic MediaWiki a des dépendances qui seront rendues disponibles durant l'installation.
 * Les extensions (en anglais) indépendantes de Semantic MediaWiki, comme par exemple Semantic Result Formats (en anglais), peuvent nécessiter d'autres prérequis.
 * Les extensions indépendantes de Semantic MediaWiki peuvent ne pas être compatibles (à l'heure actuelle) avec cette version. Veuillez vous renseigner sur les pages de documentation de ces extensions ou bien contacter leurs développeurs respectifs pour plus de précision.
 * SMW utilise les fonctions multioctets PHP mb_* comme mb_strpos dans l'extension php_mbstring.dll. C'est un standard, mais cette extension n'est pas activée par défaut sur certaines distributions de PHP. Voir le manuel PHP pour plus de détails.
 * Lors de l'installation et de la mise à jour, SMW a besoin de disposer des droits nécessaires pour créer de nouvelles tables et modifier les tables existantes . Vous pouvez retirer ces droits une fois SMW installé et fonctionnel. Le script "setupStore.php" peut utiliser les références DB de "LocalSettings.php" pour atteindre le même objectif, évitant ainsi le besoin de droits spécifiques pour l'utilisateur DB du wiki.
 * Lorsqu'il utilise le backend SQL (le magasin de données par défaut de SMW), SMW crée et modifie des tables temporaires pour certaines requêtes sémantiques. Afin de permettre cela, le compte utilisateur de la base de données du wiki doit disposer des privilèges pour CRÉER et JETER DES TABLES TEMPORAIRES. Si vous ne voulez pas autoriser de tels privilèges, vouis pouvez désactiver ces fonctionnalités de requêtes spécifiques en ajoutant ce qui suit dans "LocalSettings.php" :
 * Lors de l'utilisation d'un backend SPARQL, SMW utilise les fonction CURL de PHP. Ces fonctions ont peut-être besoin d'être activées/installées pour être disponibles.

Installation

 * MediaWiki 1.22 et ultérieur (support natif de Composer)
 * 1) Installez Composer - veuillez suivre les instructions d'installation de Composer pour y arriver.
 * 2) Lancez le script d'installation depuis le répertoire racine de votre installation MediaWiki :
 * 3) Lancez le script de mise au point depuis le répertoire racine de votre installation MediaWiki :
 * 4) Ajoutez un appel vers   à la fin du fichier "LocalSettings.php".   récupère le nom de domaine du wiki ; un wiki situé sur "exemple.org" par exemple devrait avoir cet appel :
 * Les appels  n'ont pas besoin d'être rajoutés pour Semantic MediaWiki et Validator étant donné que Composer charge ces extensions automatiquement.
 * 1) Ajoutez en dessous de l'appel   tous les réglages optionnels (à une exception près ) dans le fichier de configuration "LocalSettings.php".
 * 2) Au cas où vous souhaitez utiliser des extensions sémantiques qui ne sont pas installées via Composer (comme Semantic Drilldown) vous devez toujours les invoquer en rajoutant la ligne associée   associée à l'extension dans votre fichier de configuration "LocalSettings.php" bien en dessous de l'appel.
 * 3) Affichez la page "Special:Version" sur votre wiki pour vérifier que l'extension est installée correctement.
 * 4) Testez votre installation comme décrit dans la page d'aide sur la manière de tester SMW.
 * 5) Et voilà, c'est terminé !
 * 1) Affichez la page "Special:Version" sur votre wiki pour vérifier que l'extension est installée correctement.
 * 2) Testez votre installation comme décrit dans la page d'aide sur la manière de tester SMW.
 * 3) Et voilà, c'est terminé !


 * MediaWiki 1.22-alpha
 * Cette version comporte un fichier "composer.json" défectueux et ne devrait pas être utilisée avec SMW 1.9+. Si vous utilisez MW 1.22-alpha, vous devriez d'abord mettre à jour MediaWiki avant de faire la suite.


 * MédiaWiki des versions 1.19.x à 1.21.x (support non natif de Composer)
 * 1) Installez l'extension "Extension Installer" - voir la page d'installation de l'extension pour la marche à suivre.
 * 2) Ajouter la ligne suivante dans la section "require" du fichier "composer.json" situé dans le répertoire.
 * 3) Lancez le script d'installation depuis le répertoire   :
 * 4) Lancez le script de mise au point depuis le répertoire racine de votre installation MediaWiki :
 * 5) Ajoutez un appel vers   à la fin du fichier "LocalSettings.php".   récupère le nom de domaine du wiki ; un wiki situé sur "exemple.org" par exemple devrait avoir cet appel :
 * Les appels  n'ont pas besoin d'être rajoutés pour Semantic MediaWiki et Validator étant donné que Composer charge ces extensions automatiquement.
 * 1) Ajoutez en dessous de l'appel   tous les réglages optionnels (à une exception près ) dans le fichier de configuration "LocalSettings.php".
 * 2) Au cas où vous souhaitez utiliser des extensions sémantiques qui ne sont pas installées via Composer (comme Semantic Drilldown) vous devez toujours les invoquer en rajoutant la ligne associée   associée à l'extension dans votre fichier de configuration "LocalSettings.php" bien en dessous de l'appel.
 * 3) Affichez la page "Special:Version" sur votre wiki pour vérifier que l'extension est installée correctement.
 * 4) Testez votre installation comme décrit dans la page d'aide sur la manière de tester SMW.
 * 5) Et voilà, c'est terminé !
 * 1) Au cas où vous souhaitez utiliser des extensions sémantiques qui ne sont pas installées via Composer (comme Semantic Drilldown) vous devez toujours les invoquer en rajoutant la ligne associée   associée à l'extension dans votre fichier de configuration "LocalSettings.php" bien en dessous de l'appel.
 * 2) Affichez la page "Special:Version" sur votre wiki pour vérifier que l'extension est installée correctement.
 * 3) Testez votre installation comme décrit dans la page d'aide sur la manière de tester SMW.
 * 4) Et voilà, c'est terminé !

Mise à jour
Suivez les instructions qui suivent pour mettre à jour une installation SMW existante.


 * Mise à jour depuis une version SMW 1.9.x ou 2.0 (MediaWiki versions 1.19.x à 1.21.x, support non natif de Composer)
 * 1) Faites une sauvegarde de votre base de données et de votre installation.
 * 2) Modifiez la ligne suivante en fonction de la version que vous avez utilisé auparavant dans la section "require" du fichier "composer.json" situé dans le répertoire
 * par à
 * 1) Lancez le script de mise à jour suivant depuis le répertoire de base de votre installation MediaWiki :
 * 2) Vérifiez la page "Spécial:Version" de votre wiki pour constater que l'extension a bien été mise à jour.
 * 3) Lancez le script de paramétrage depuis le répertoire de base de votre installation MediaWiki :
 * 4) Lancez le script de rafraichissement de la base de données depuis le répertoire de base de votre installation MediaWiki :
 * 5) Et voilà, c'est terminé !
 * 1) Lancez le script de rafraichissement de la base de données depuis le répertoire de base de votre installation MediaWiki :
 * 2) Et voilà, c'est terminé !
 * 1) Et voilà, c'est terminé !


 * Mise à jour depuis une version SMW 1.9.x ou 2.0(MediaWiki versions 1.22 et ultérieures, support natif de Composer)
 * 1) Faites une sauvegarde de votre base de données et de votre installation.
 * 2) Lancez le script de mise à jour suivant depuis le répertoire de base de votre installation MediaWiki :
 * 3) Vérifiez la page "Spécial:Version" de votre wiki pour constater que l'extension a bien été mise à jour.
 * 4) Lancez le script de paramétrage depuis le répertoire de base de votre installation MediaWiki :
 * 5) Lancez le script de rafraichissement de la base de données depuis le répertoire de base de votre installation MediaWiki :
 * 6) Et voilà, c'est terminé !
 * 1) Lancez le script de rafraichissement de la base de données depuis le répertoire de base de votre installation MediaWiki :
 * 2) Et voilà, c'est terminé !
 * 1) Et voilà, c'est terminé !


 * Mise à jour depuis une version SMW 1.8.x
 * 1) Faites une sauvegarde de votre base de données et de votre installation.
 * 2) Supprimez les répertoires   et   du répertoire.
 * 3) Supprimez les appels auparavant obligatoires de "Semantic MediaWiki" et de "Validator" du fichier "LocalSettings.php", c'est-à-dire les lignes suivantes :
 * 4) Réinstallez Semantic MediaWiki en suivant la procédure de la section Installation en fonction de votre configuration.
 * 5) Lancez le script de rafraichissement de la base de données depuis le répertoire de base de votre installation MediaWiki :
 * 6) Et voilà, c'est terminé !
 * 1) Lancez le script de rafraichissement de la base de données depuis le répertoire de base de votre installation MediaWiki :
 * 2) Et voilà, c'est terminé !
 * 1) Et voilà, c'est terminé !


 * Mise à jour depuis une version SMW 1.7.x ou antérieure

Veuillez tout d'abord mettre à jour vers la version 1.8.0.5, comme décrit sur la page d'aide dans la section Mise à jour d'une installation existante.

Mise à jour
Suivez ces instruction pour mettre à jour une installation 2.1 existante.


 * MediaWiki 1.22 ou ultérieur (support natif de Composer)
 * 1) Faites une sauvegarde de votre base de données et de votre installation.
 * 2) Lancez le script de mise à jour suivant depuis le répertoire de base de votre installation MediaWiki :
 * 3) Vérifiez la page "Spécial:Version" de votre wiki pour constater que l'extension a bien été mise à jour.
 * 4) Lancez le script de paramétrage depuis le répertoire de base de votre installation MediaWiki :
 * 5) Lancez le script de rafraichissement de la base de données depuis le répertoire de base de votre installation MediaWiki :
 * 6) Et voilà, c'est terminé !
 * 1) Lancez le script de rafraichissement de la base de données depuis le répertoire de base de votre installation MediaWiki :
 * 2) Et voilà, c'est terminé !
 * 1) Et voilà, c'est terminé !


 * MediaWiki 1.19.x à 1.21.x (support non natif de Composer)
 * 1) Faites une sauvegarde de votre base de données et de votre installation.
 * 2) Lancez le script de mise à jour suivant depuis le répertoire  de votre installation MediaWiki :
 * 3) Vérifiez la page "Spécial:Version" de votre wiki pour constater que l'extension a bien été mise à jour.
 * 4) Lancez le script de paramétrage depuis le répertoire de base de votre installation MediaWiki :
 * 5) Lancez le script de rafraichissement de la base de données depuis le répertoire de base de votre installation MediaWiki :
 * 6) Et voilà, c'est terminé !
 * 1) Lancez le script de rafraichissement de la base de données depuis le répertoire de base de votre installation MediaWiki :
 * 2) Et voilà, c'est terminé !
 * 1) Et voilà, c'est terminé !

Passage au support natif de Composer
Comme précisé dans la section des prérequis plus haut, l'extension "Extension Installer" n'est nécessaire que pour les version de MediaWiki comprises entre 1.19.x et 1.21.x qui ne supportent pas Composer nativement. De ce fait, vous devrez vous adapter à l'évolution et donc mettre à jour Semantic MediaWiki une fois la mise à jour vers MediaWiki 1.22+ effectuée :


 * 1) Faites une sauvegarde de votre base de données et de votre installation.
 * 2) Déplacez le fichier "composer.json" du répertoire  vers le répertoire de base de votre installation MediaWiki.
 * 3) Supprimez aussi les répertoires ,   et   du répertoire   ainsi que les répertoires des extensions qui ont été installées à l'aide de l'extension "Extension Installer" comme par exemple Semantic Results Formats si nécessaire. Voir le fichier "composer.json" pour avoir la liste de ces extensions.
 * 4) Lancez le script de mise à jour suivant depuis le répertoire de base de votre installation MediaWiki :
 * 5) Vérifiez la page "Spécial:Version" de votre wiki pour constater que la ou les extensions ont bien été correctement installées.
 * 6) Supprimez le répertoire   du répertoire.
 * 7) Enlevez la ligne suivante du fichier "LocalSettings.php" :
 * 8) Et voilà, c'est terminé !
 * 1) Et voilà, c'est terminé !

Ces instructions font délibérément abstraction d'une mise à jour éventuelle de Semantic MediaWiki. Dans le cas où une nouvelle version serait sortie entre temps, suivez les étapes précédentes puis effectuez une mise à jour.

Résolution des problèmes
Après la mise à jour d'une installation existante de SMW, les messages suivants peuvent apparaitre. Ils sont directements liés à la manière dont est configuré le fichier "LocalSettings.php" :


 * Warning&#58; Class '…' not found in …
 * Ce genre de message apparait si l'extension Validator est toujours invoquée de manière explicite. Pour résoudre ce problème, la ligne suivant doit être enlevée du fichier :


 * Notice&#58; Use of undefined constant …
 * Ce genre de message apparait parce que les constantes d'espace de nom de SMW (,  et  ) sont retardées à cause du paramètre   devenu un prérequis et que son initialisation doit être effectuée avant d'être utilisé. Pour résoudre ce problèmes, vous devez ajouter   avant tout autre paramètre SMW (e.g. $wgContentNamespaces, $wgNamespacesToBeSearchedDefault et $wgNamespaceProtection par exemple) faisant référence à ces constantes d'espace de nom. Dans le cas où vous choisissez de définir manuellement   avec une valeur autre que celle par défaut qui est  , vous devez impérativement le faire avant l'appel vers enableSemantics.


 * Fatal&#58; Call to undefined function enableSemantics …
 * Ce genre de message apparait sur les version MW antérieures à 1.21.x si l'extension Extension Installer est incluse après l'appel vers enableSemantics (voir plus hautj). Assurez-vous que l'appel vers Extension Installer est bien placé en premier.

Après une mise à jour d'une installation SMW 1.9.0 existante, le message suivant peut s'afficher :
 * Database error&#58; A database query error has occurred. This may indicate a bug in the software.
 * Cette erreur apparait après une mise à jour de SMW 1.9.0 ou 1.9.1 lorsque vous déplacez une page que vous n'avez pas mise à jour dans le magasin sémantique. Pour résoudre ce problème, lancez le script de réglage depuis le répertoire de base de votre installation MediaWiki :

Tutoriel vidéo
Ce tutoriel en anglais s'applique aussi à SMW 2.0. et 2.1