Help:Installation 1.9.0 - 1.9.2 (fr)

From semantic-mediawiki.org
Jump to: navigation, search
Manuel admin SMW
Téléchargement
Installation
Configuration
Cache des Concepts
Belles URI
Utilisation des magasins SPARQL et RDF
Résolution de problèmes
Réparation des données SMW
Extensions
Extensions de base

Extensions sémantiques

Manuel utilisateur SMW

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.

NoteNote: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.

NoteNote: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 à Semantic MediaWiki, comme par exemple Semantic Result Formats (en anglais), peuvent nécessiter d'autres prérequis.
  • Les extensions indépendantes à 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 (CREATE) et modifier les tables existantes (ALTER TABLE). 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" :
$smwgQSubcategoryDepth = 0;
$smwgQPropertyDepth    = 0;
$smwgQFeatures         = SMW_ANY_QUERY & ~SMW_DISJUNCTION_QUERY;
$smwgQConceptFeatures  = SMW_ANY_QUERY & ~SMW_DISJUNCTION_QUERY & ~SMW_CONCEPT_QUERY;


  • 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[1] depuis le répertoire racine[2] de votre installation MediaWiki :[3]
    php composer.phar require mediawiki/semantic-media-wiki "~2.1"
    
  3. Lancez le script de mise au point depuis le répertoire racine[2] de votre installation MediaWiki :
    php maintenance/update.php
    
  4. Ajoutez un appel vers enableSemantics() à la fin du fichier "LocalSettings.php". enableSemantics() récupère le nom de domaine du wiki ; un wiki situé sur "exemple.org" par exemple devrait avoir cet appel :
    enableSemantics( 'exemple.org' );
    
    Les appels require_once … n'ont pas besoin d'être rajoutés pour Semantic MediaWiki et Validator étant donné que Composer charge ces extensions automatiquement.
  5. Ajoutez en dessous de l'appel enableSemantics() tous les réglages optionnels[4] (à une exception près[5]) dans le fichier de configuration "LocalSettings.php".
  6. 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 require_once … associée à l'extension dans votre fichier de configuration "LocalSettings.php" bien en dessous de l'appel enableSemantics().
  7. Testez votre installation comme décrit dans la page d'aide sur la manière de tester SMW.
  8. Et voilà, c'est terminé !
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 …/extensions/ExtensionInstaller/.[6]
    "mediawiki/semantic-media-wiki": "~2.1"
    
  3. Lancez le script d'installation depuis le répertoire …/extensions/ExtensionInstaller/ :[3]
    php composer.phar install
    
  4. Lancez le script de mise au point depuis le répertoire racine[2] de votre installation MediaWiki :
    php maintenance/update.php
    
  5. Ajoutez un appel vers enableSemantics() à la fin du fichier "LocalSettings.php". enableSemantics() récupère le nom de domaine du wiki ; un wiki situé sur "exemple.org" par exemple devrait avoir cet appel :
    enableSemantics( 'exemple.org' );
    
    Les appels require_once … n'ont pas besoin d'être rajoutés pour Semantic MediaWiki et Validator étant donné que Composer charge ces extensions automatiquement.
  6. Ajoutez en dessous de l'appel enableSemantics() tous les réglages optionnels[4] (à une exception près[5]) dans le fichier de configuration "LocalSettings.php".
  7. 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 require_once … associée à l'extension dans votre fichier de configuration "LocalSettings.php" bien en dessous de l'appel enableSemantics().
  8. Testez votre installation comme décrit dans la page d'aide sur la manière de tester SMW.
  9. 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 …/extensions/ExtensionInstaller/[7]
    "mediawiki/semantic-media-wiki": "~1.9"
    
    par
    "mediawiki/semantic-media-wiki": "~2.0"
    
    à
    "mediawiki/semantic-media-wiki": "~2.1"
    
  3. Lancez le script de mise à jour suivant depuis le répertoire de base[2] de votre installation MediaWiki :[3]
    php composer.phar update
    
  4. Vérifiez la page "Spécial:Version" de votre wiki pour constater que l'extension a bien été mise à jour.
  5. Lancez le script de paramétrage depuis le répertoire de base[2] de votre installation MediaWiki :
    php maintenance/update.php
    
  6. Lancez le script de rafraichissement de la base de données depuis le répertoire de base[2] de votre installation MediaWiki :[8]
    php extensions/SemanticMediaWiki/maintenance/SMW_refreshData.php -d 50 -v
    
  7. 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[2] de votre installation MediaWiki :[3]
    php composer.phar require mediawiki/semantic-media-wiki:~2.1 --update-with-dependencies
    
  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[2] de votre installation MediaWiki :
    php maintenance/update.php
    
  5. Lancez le script de rafraichissement de la base de données depuis le répertoire de base[2] de votre installation MediaWiki :[8]
    php extensions/SemanticMediaWiki/maintenance/SMW_refreshData.php -d 50 -v
    
  6. 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 SemanticMediaWiki/ et Validator/ du répertoire …/extensions/.
  3. Supprimez les appels auparavant obligatoires de "Semantic MediaWiki" et de "Validator" du fichier "LocalSettings.php", c'est-à-dire les lignes suivantes :
    require_once "$IP/extensions/Validator/Validator.php";
    
    require_once "$IP/extensions/SemanticMediaWiki/SemanticMediaWiki.php";
    
  4. Réinstallez Semantic MediaWiki en suivant la procédure de la section Installation en fonction de votre configuration.[9]
  5. Lancez le script de rafraichissement de la base de données depuis le répertoire de base[2] de votre installation MediaWiki :[8]
    php extensions/SemanticMediaWiki/maintenance/SMW_refreshData.php -d 50 -v
    
  6. 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 existente.

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[2] de votre installation MediaWiki :[3]
    php composer.phar update
    
  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[2] de votre installation MediaWiki :
    php maintenance/update.php
    
  5. Lancez le script de rafraichissement de la base de données depuis le répertoire de base[2] de votre installation MediaWiki :[8]
    php extensions/SemanticMediaWiki/maintenance/SMW_refreshData.php -d 50 -v
    
  6. 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…/extensions/ExtensionInstaller/ de votre installation MediaWiki :[3]
    php composer.phar update
    
  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[2] de votre installation MediaWiki :
    php maintenance/update.php
    
  5. Lancez le script de rafraichissement de la base de données depuis le répertoire de base[2] de votre installation MediaWiki :[8]
    php extensions/SemanticMediaWiki/maintenance/SMW_refreshData.php -d 50 -v
    
  6. 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…/extensions/ExtensionInstaller/ vers le répertoire de base[2] de votre installation MediaWiki.
  3. Supprimez aussi les répertoires SemanticMediaWiki/, Validator/ et vendor/ du répertoire …/extensions/ 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[2] de votre installation MediaWiki :[3]
    php composer.phar update
    
  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 ExtensionInstaller/ du répertoire …/extensions/.
  7. Enlevez la ligne suivante du fichier "LocalSettings.php" :
    require_once "$IP/extensions/ExtensionInstaller/ExtensionInstaller.php";
    
  8. Et voilà, c'est terminé !

NoteNote: 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: 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é du fichier :
require_once "$IP/extensions/Validator/Validator.php";
Notice: Use of undefined constant …
Ce genre de message apparait parce que les constantes d'espace de nom de SMW (SMW_NS_PROPERTY, SMW_NS_TYPE et SMW_NS_CONCEPT) sont retardées à cause du paramètre $smwgNamespaceIndex 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
enableSemantics( 'exemple.org' );
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 $smwgNamespaceIndex avec une valeur autre que celle par défaut qui est 102, vous devez impérativement le faire avant l'appel vers enableSemantics().
Fatal: 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: 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[2] de votre installation MediaWiki :
php maintenance/update.php

Notes

  1. Veuillez noter que si vous avez installé Git, il est recommandé d'installer Composer avec le flag "--prefer-source" afin que Composer utilise Git pour télécharger le code. En d'autres termes, au lieu d'appeler "composer install" ou "php composer.phar install" comme la page le précise, vous devriez appeler "composer install --prefer-source" ou bien "php composer.phar install --prefer-source".
  2. 2.00 2.01 2.02 2.03 2.04 2.05 2.06 2.07 2.08 2.09 2.10 2.11 2.12 2.13 2.14 2.15 2.16 2.17 Il s'agit du répertoire qui contient le fichier "LocalSettings.php".
  3. 3.0 3.1 3.2 3.3 3.4 3.5 3.6 Dans le cas où vous auriez installé "globalement" Composer sur votre serveur, vous devrez alors balancer les particules php et .phar depuis la commande.
  4. 4.0 4.1 Voir la page d'aide sur la façon de configurer SMW. Généralement, seuls quelques paramètres ont besoins d'être adaptés aux besoins.
  5. 5.0 5.1 Si vous configurez manuellement $smwgNamespaceIndex à une valeur autre que la valeur par défaut 100, vous devez le faire avant la ligne enableSemantics(). Assurez-vous que la valeur est bien supérieure ou égale à 100 et que ce soit un nombre pair.
  6. Voir aussi l'exemple fichier "composer.json", qui contient déjà la ligne qui doit être ajoutée
  7. Voir aussi l'exemple de fichier "composer.json" qui contient également la ligne qui doit être ajoutées.
  8. 8.0 8.1 8.2 8.3 8.4 Il s'agit d'une étape optionnelle destinée à s'assurer que le magasin sémantique est bien valide et à jour.
  9. Veuillez vous référer à la section appropriée, soit "avec accès shell / sans accès shell"

Tutoriel vidéo

NoteNote: Ce tutoriel en anglais s'applique aussi à SMW 2.0. et 2.1

Cette page de documentation concerne toutes les versions de SMW depuis la 1.9.0 jusqu'à la 1.9.2.
Autres versions : ≥ 2.01.8.0 – 1.8.01.7.1 – 1.7.1       Autres langues : en

Help:Installation fr 1.9.0 1.9.2