Archive:Installation 1.8.0 (fr)

Cette page décrit la façon d ' installer Semantic MediaWiki 1.8.0 après l'avoir téléchargé (voir le pied de page pour les autres versions). Les notes d'installation et de mise à jour évoluent d'une version à l'autre : le fichier INSTALL livré avec SMW contient les instructions concernant la version que vous avez téléchargée.

Pour mettre à jour un wiki tournant avec une version précédente de SMW, assurez-vous d'avoir bien lu la section concernée avant de commencer la mise à jour.

Pour l'installation de SMW, veuillez vérifier les exigences nécessaires et suivez attentivement les instructions. L'installation ne fait pas de changement irréversible sur votre base de donnée MediaWiki (elle ajoute simplement quelques tables supplémentaires qui peuvent être supprimées). Cependant, il n'y a actuellement aucun processus automatique de retrait des annotations provenant des textes d'articles au cas où Semantic MediaWiki devrait être désinstallé, mais on peut terminer le processus avec quelques scripts qui élimineraient les annotations sur les éditions.

Avertissement
Assurez-vous de bien comprendre les avertissements légaux dans le fichier COPYING.

Exigences

 * MediaWiki 1.17.0 ou ultérieur (MediaWiki 1.19.0 ou ultérieur recommandé)
 * L'extension Validator version 0.5.0 ou ultérieure
 * PHP 5.2 ou ultérieur installé et en fonction (exceptée la version 5.3.1)
 * MySQL >= 4.0.14 (version requise par MediaWiki, exceptées les versions 5.1.49 à 5.1.52)
 * ou PostgreSQL >= 8.3 (veuillez noter que le support à cette dernière est toujours préliminaire et requiert quelques étapes supplémentaires, voir PostgreSQL ((en anglais pour l'instant) pour plus de détails)


 * Notes
 * SMW utilise les fonctions multi-octets PHP mb_* comme mb_strpos dans l'extension php_mbstring.dll par exemple. Cela fait partie des standards mais ces fonctions sont quelquefois désactivées par défaut dans certaines distributions de PHP. Voir le manuel pour plus d'informations.
 * Pour l'installation et la mise à jour, SMW nécessite les droits pour créer des nouvelles tables (CREATE) et pour modifier les tables (ALTER TABLE). Les deux peuvent être ensuite retirés une fois SMW configuré. Le script SMW_setup.php peut utiliser les certificats DB de AdminSettings.php dans ce but, ce qui rend caduque le besoin de droits supplémentaires pour l'utilisateur DB du wiki.
 * Quand on utilise SMWSQLStore3 (stockage par défaut des données pour SMW), SMW crée et modifie des tables temporaires pour certaines requêtes sémantiques. Pour ce faire, votre user wikidb doit avoir les privilèges suffisants pour CRÉER DES TABLES TEMPORAIRES. Ces fonctions peuvent être désactivées en ajoutant les lignes suivantes au fichier Localsettings.php :
 * Quand on utilise SMWSparqlStore (connexion au diffuseur RDF), SMW utilise les fonction CURL de PHP. Ces fonctions sont peut-être à activer/installer pour être disponibles.

En règle générale, il n'est pas recommandé de faire tourner des versions anciennes de MediaWiki étant donné que chaque nouvelle version apporte aussi des résolutions de problèmes de sécurité. Si votre site utilise encore PHP4, il n'y a pas de support SWM. Il serait difficilement possible de transposer le code vers la vieille version de PHP. Si vous avez PHP5 mais une vieille version de MediaWiki, des patches/modifications supplémentaires peuvent être nécessaires. Téléchargez une version plus ancienne de SMW et regardez les instructions d'installations du fichier INSTALL embarqué pour voir les autres changements qui sont recommandés.
 * Fonctionnement de SMW sur des versions plus anciennes de MediaWiki

Installation
Si vous mettez à jour une installation existante de Semantic MediaWiki, lisez aussi les remarques dans la section Mise à jour d'installations existantes ci-dessous ! L'installation de SMW nécessite en gros trois (ou quatre) étapes faciles :

'''(1) Copiez les fichiers. ''' Faites l'extraction des archives téléchargées de Validator et de Semantic MediaWiki, ou vérifiez les versions actuelles depuis Git pour obtenir les répertoires « Validator » et « SemanticMediaWiki » qui contiennent tous les fichiers nécessaires. Copiez ces répertoires dans « [cheminwiki]/extensions/ » (ou faites l'extraction/télécharger les dans ce répertoire).

'(2) [optionnel]'' Ajustez les espaces de nom. ''' Si vous n'avez effectué aucun changement dans les espaces de nom de votre wiki, vous pouvez sauter cette étape. Si vous avez défini vos propres espaces de nom personnalisés, vous devez configurer le paramètre $smwgNamespaceIndex avant d'inclure SemanticMediaWiki.php. Semantic MediaWiki utilise des index d'espace de nom supplémentaires allant de 102 à 109. Notez que les index 104 et 105 ne sont nécessaires que si $smwgHistoricTypeNamespace est configuré. 106 et 107 sont réservés pour l'extension Formulaires sémantiques et ne sont pas utilisés par SMW. Voir la documentation dans SMW_Settings.php pour plus d'information. Si vous ajoutez des espaces de nom après avoir installé SMW, vous devez leur assigner un numéro d'index supérieur à ceux utilisés par Semantic MediaWiki.

Note: Semantic MediaWiki n'évalue les annotations sémantiques que dans certains espaces de nom. Par exemple, il ignore par défaut les annotations sémantiques dans les pages de discussion. Si vous souhaitez changer les espaces de nom avec les annotations (notamment quand vous avez ajouté vos espaces de nom personnalisés), vous devez alors ajouter la liste désirée dans le paramètre $smwgNamespacesWithSemanticLinks</tt> dans LocalSettings.php.

'''(3) Activez les extensions. ''' Insérez les lignes suivantes dans le fichier « [cheminwiki]/LocalSettings.php » où exemple.org devra être remplacé par le nom de votre serveur (ou son adresse IP). Ce champ est utilité seulement comme nom unique global pour l'identification des données exportées du wiki sur le web sémantique et mettre un nom valide pour le serveur facilite grandement la chose. Il n'y a aucune raison de s'inquiéter si un wiki a plus d'un nom de serveur – choisissez-en un.

'''(4) Configurez la base de données. ''' Dans votre wiki, connectez-vous en tant qu'utilisateur ayant un statut administrateur et allez à la page « Special:SMWAdmin » pour effectuer les dernières étapes de configuration. Deux étapes sont nécessaires : tout d'abord, activer la configuration de la base de données (« Initialiser ou mettre à niveau les tables »). Après cela, activez la mise à jour automatique des données (« Commencer la mise à jour des données »). Veuillez noter que la première étape nécessite d'avoir la permission de modifier/créer des tables de base de données, comme expliquée un peu plus haut. La seconde étape prend un certain temps ; allez sur Special:SMWAdmin pour en suivre la progression. SMW peut être utilisé avant la fin de cette étape mais n'aura pas encore accès à toutes les données (par exemple les pages catégorie).



Test de votre installation
Si vous n'êtes pas certain du bon déroulement des opérations, vous pouvez faire quelques tests pour vérifier que SMW fonctionne correctement :
 * 1) Allez sur la page spéciale version. Vous devriez voir Semantic MediaWiki (version 1.8.0) apparaitre dans liste des « Extensions sémantiques » en haut de page.
 * 2) Créez une page classique de wiki appelée « TestSMW » et tapez-y le texte wiki suivant : Property test:  testproperty::Dummypage Quand vous prévisualisez la page avant de sauvegarder, vous devriez voir la fenêtre de faits au pied de l'article qui affiche votre entrée. Après avoir sauvegardé la page, cliquez sur le lien « Chercher les propriétés » dans la barre d'outils à gauche. Cette vue devrait afficher Testproperty avec la valeur Dummypage.

Mise à jour d'une installation existante
Avant de mettre à jour une installation existante, assurez-vous de faire une sauvegarde de votre base de données et de votre installation.

SMW 1.6.0 a introduit une nouvelle dépendence logicielle (qui s'applique aussi aux versions ultérieures) : l'extension Validator qui aide Semantic MediaWiki à valider les paramètres donnés par les utilisateurs. Il doit être installé pour que SMW puisse fonctionner correctement. Assurez-vous de configurer Validator avant l'inclusion de SMW dans votre fichier LocalSettings.php. Veuillez noter que Validator est livré avec les versions SMW depuis la 1.6.0. Si vous récupérez le code via Git, vous devrez en plus récupérer indépendamment Validator.

Les extensions prévues pour les versions 1.6.x et 1.7.x de SMW ne devraient pas fonctionner avec SMW 1.8.0. Toutes les extensions SMW devraient être mises à jour vers les versions qui sont compatibles avec SMW 1.8.0. De plus, certaines fonctions ont changé et les pages peuvent nécessiter des mises à jour (voir plus loin). Des remarques supplémentaires sur la mise à jour d'anciennes versions de SMW sont données plus loin.

Mise à jour de SMW 1.6.x et SMW 1.7.x
Les installations de SMW 1.6.x et SMW 1.7.x peuvent être mises à jour en remplaçant les fichiers et en suivant les étapes ci-dessous étant donné que SMW 1.8.0 introduit un nouveau schéma de base de données par défaut (SMWSQLStore3). Vous pouvez continuer à utiliser l'ancien schéma (SMWSQLStore2) afin d'assurer une transition, mais il est fortement conseillé de migrer vers le nouveau schéma pour les compatibilités à venir.

Avec un accès shell (ligne de commande)

 * 1) Pour utiliser en premier lieu l'ancien schéma, ajoutez   à votre fichier LocalSettings.php. Si vous utilisez déjà   vous devriez garder cette ligne et ajouter ce qui suit :
 * 2) Après avoir paramétré ceci, lancez le script   depuis votre ligne de commande :   Le wiki devrait maintenant fonctionner normalement, mais il utilise les anciennes structures de stockage.
 * 3) Pour migrer vers la nouvelle structure, vous devez faire un "rafraichissement total" pour la nouvelle structure. Pour ce faire, exécutez les deux commandes suivantes (les deux vont durer un certain temps).    Le wiki qui tourne ne sera pas affecté par ces commandes, mais l'opération pourrait affecter la vitesse du serveur. Voyez la page d'aide sur la réparation des données SMW pour plus de détails.
 * 4) Après avec migré avec succès, retirez les lignes avec 'SMWSQLStore2' de votre fichier LocalSettings.php pour utiliser la nouvelle structure. Vous pouvez toujours revenir sur l'ancienne structure en cas de problème. Si l'ancienne structure n'est plus nécessaire, elle peut être supprimée (et ainsi libérer de la mémoire) en lançant

Sans accès shell (ligne de commande)
<!--
 * 1) Ajoutez le code suivant dans votre fichier LocalSettings.php pour désactiver l'édition :
 * 2) Remplacez les fichiers de Semantic MediaWiki, Validator et les autres extensions sémantiques qui nécessitent une mise à jour dans le répertoire des extensions.
 * 3) Allez sur la page spéciale "Special:SMW-Admin" et cliquez sur le bouton "Initialiser et mettre à niveau les tables".
 * 4) Après la création des nouvelles tables, retournez sur "Special:SMW-Admin" et cliquez sur le bouton "Commencer la mise à jour des données".
 * 5) Dès que le rafraichissement des données est démarré, ajoutez   dans votre fichier LocalSettings.php juste sous la ligne   afin de basculer sur l'ancien mode SMWSQLStore2 durant le rafraichissement des données pour SMWSQLStore3.
 * 6) Passez la ligne   en commantaire afin de rendre à nouveau le wiki éditable. Le wiki devrait fonctionner comme d'habitude, mais en utilisant l'ancienne structure de stockage.
 * 7) Une fois le rafraichissement des données effectué, remettre la ligne   dans votre fichier LocalSettings.php.
 * 8) Mettez la ligne   en commentaire dans votre fichier LocalSettings.php pour le basculer vers SMWSQLStore3.
 * 9) Refaites l'étape quatre : retournez dans "Special:SMW-Admin" et cliquez sur le bouton "Commencer la mise à jour des données" pour démarrer le deuxième rafraichissement des données pour SMWSQLStore3.
 * 10) Refaites l'étape cinq :


 * 1) Do step five again: Add   to your LocalSettings.php below the line   to switch to the old SMWSQLStore2 during the data refresh for SMWSQLStore3.
 * 2) Remove   to make the wiki editable again. The wiki should now work as normal, but using the old storage structures.
 * 3) After the second data refresh is done, remove   from your LocalSettings.php to switch to SMWSQLStore3.
 * 4) In case annotations ore changes to them were done during the refresh of SMWSQLStore3 return to to "Special:SMW-Admin" and click on the "Start updating data" button to start a third data refresh for SMWSQLStore3.

Mise à jour depuis SMW 1.5.x
N'oubliez donc pas tout d'abord d'installer l'extension Validator et de l'inclure dans LocalSettings.php avant SMW avec la ligne de code suivante. Cela effectué, vous pourrez continuer le processus de mise à jour de SMW.

<br style="clear:both;" clear="all" />

Les extensions de SMW jusqu'à la 1.5.x ne sont pas sensées fonctionner normalement avec SMW 1.6.0 prêt à l'emploi. Toutes les extensions SMW devront être mises à jour avec les versions qui sont compatibles SMW 1.6. De plus certaines fonctions ont changé et les pages peuvent nécessiter des mises à jour (voir plus bas). Des remarques supplémentaires sur la mise à jour depuis des versions plus anciennes sont données plus bas.

Si cela n'est pas déjà fait, il est suggéré de changer l'inclusion de SMW dans LocalSettings.php par les lignes suivantes comme décrit dans les instructions d'installation précédentes :

<br style="clear:both;" clear="all" />

L'inclusion de SMW_Settings.php comme cela se faisait dans les premières version ne fonctionnera plus.

Changements dans les options de configuration
Certaines options de configuration (utilisées dans LocalSettings.php) ont changé depuis SMW 1.0. Tous les réglages sont documentés en détail dans le fichier SMW_Settings.php</tt>. La liste suivante donne la version dans laquelle une option de configuration apparait pour la première fois, ce qui veut dire qu'elle peut être ignorée si vous faites tourner cette version ou une version plus récente.


 * [1.4] Jusqu'à la version 1.4, la valeur par défaut pour le paramètre $smwgQComparators</tt> était '<|>|!'</tt>. Il est maintenant changé en '<|>|!|~'</tt> ce qui veut dire que le comparateur « like » (comme) ~</tt> est activé par défaut.
 * [1.4] La version 1.4 supportait un paramètre $smwgSMWBetaCompatible</tt> pour activer la vieille syntaxe de requête et l'espace de nom Relation. Cette compatibilité rétroactive a maintenant été abandonnée et ce paramètre n'est plus utilisé. Veuillez donc mettre à jour votre wiki afin de ne plus utiliser cette caractéristique obsolète (et maintenant non documentée).
 * [1.3] Depuis SMW 1.3, la boite de faits est masquée par défaut et n'apparaitra que dans les pages de prévisualisation. Pour compenser cela, la boite à outils (généralement à gauche sous le champ de recherche) affiche un lien vers Special:Browse. Pour que la boite de faits s'affiche comme elle le faisait avant la SMW 1.3, paramétrez de la façon suivante $smwgShowFactbox = SMW_FACTBOX_NONEMPTY;</tt> Le nouveau lien et la boite de fait durant l'édition peuvent aussi être configurés. Voir SMW_Settings.php</tt> pour plus de détails.
 * [1.2.1] SMW ne supportera plus la syntaxe de liens imbriqués dans les valeurs de propriété par défaut, cette option étant source de problèmes. Pour la réactiver, paramétrez $smwgLinksInValues = true;</tt>
 * [1.2] Si votre wiki utilise la syntaxe  </tt> ou l'espace de nom Relation:</tt>, vous voudriez peut-être paramétrer $smwgSMWBetaCompatible = true;</tt> avant la ligne incluant SemanticMediaWiki.php (anciennement SMW_Settings.php) dans LocalSettings.php. Il est préférable de changer  </tt> en #ask</tt> afin de pouvoir lâcher la compatiblité beta SMW.
 * [1.2] Si vous avez le paramètre $smwgQDisjunctionSupport = false;</tt> vous aurez besoin de paramétrer de la façon suivante dans votre <tt>LocalSettings.php</tt>:
 * [1.0] <tt>$smwgQEqualitySupport</tt> fait partie de <tt>SMW_EQ_NONE, SMW_EQ_SOME, SMW_EQ_FULL</tt> (il pouvait prendre les valeurs <tt>true</tt> ou <tt>false</tt> jusqu'à SMW 1.0 RC1-3).
 * [1.0] <tt>$smwgQDefaultNamespaces</tt> est maintenant <tt>NULL</tt> par défaut, ce qui veut dire que tous les espaces de nom peuvent faire partie d'une requête. La valeur par défaut dans SMW RC 1-3 était '<tt>array(NS_MAIN, NS_IMAGE)</tt>'.
 * [1.0] <tt>$smwgQDefaultLinking</tt> a maintenant comme valeur par défaut '<tt>all</tt>' de telle façon que tous les résultats de requêtes sont liés. Il n'y a plus maintenant de problème de performance. La valeur par défaut jusqu'à la SMW RC 1-3 était '<tt>subject</tt>'.

Si vous mettez actuellemnt à jour ces paramètres dans votre <tt>LocalSettings.php</tt>, vous devez mettre à jour ce fichier. Voyez <tt>SMW_Settings.php</tt> pour plus d'informations sur les paramètres disponibles.

Voir aussi
-->
 * Installation de MediaWiki