Guide de migration de Confluence vers XWiki : de l'exportation à la personnalisation

25 mai 2020 5 min read
Écrit par Stefana Nazare, Gestionnaire de compte

De nombreuses sociétés ont récemment choisi de migrer de Confluence à XWiki. D'après les retours les fonctionnalités d'organisation, les données structurées, les tarifs attractifs, le contrôle complet de vos données, l'extensibilité sont les facteurs de migration les plus cités.
Si vous envisagez vous aussi de quitter Confluence, mais que vous n'êtes pas encore tout à fait sûr de votre choix, vous pouvez consulter la page de comparatif entre les produits "XWiki vs Confluence" sur notre site.
Mais si vous êtes prêt à sauter le pas, voici la marche à suivre !

1. Prérequis

  • Une instance Confluence : Assurez-vous d'avoir le droit d'exporter des pages (Export Space) sur cette instance.
  • Une instance XWiki : Vous aurez besoin d'un serveur avec XWiki installé, et également de l'accès à ce serveur. Cela peut-être :
    • Une installation réalisée par vos soins, sur un serveur qui vous appartient. Pour en savoir plus et choisir la méthode d'installation qui vous convient, vous pouvez consulter le guide d'installation administrateur.
    • Une installation réalisée par des spécialistes d'XWiki, sur un serveur qui vous appartient. En effet si vous ne souhaitez pas vous charger de l'installation mais souhaitez tout de même disposer de vos données "on premise", les ingénieurs de XWiki SAS peuvent réaliser son installation et sa configuration pour vous.
    • Une installation cloud : Si votre instance est hébergée sur un cloud, vous devez contacter l'équipe de support qui pourra ajouter les fichiers exporter sur le serveur.

2. Préparez vos fichiers

  • Exportez le contenu de Confluence que vous souhaitez ensuite importer dans XWiki au format XML.
  • Uploadez le fichier zip obtenu sur le serveur XWiki. Assurez-vous qu'il est accessible à l'utilisateur qui a lancé le processus Java. Si votre instance est hébergée sur le cloud, comme dit précédemment l'équipe de support peut s'en charger pour vous.
  • Installez les extensions Confluence XML module et File Streams Converter Application sur votre instance XWiki en utilisant le Gestionnaire d'extension.
  • Si vous avez des Espaces dans votre instance Confluence, créez leur équivalent en sous-wiki dans votre instance XWiki.

3. Lancez la migration :

Après avoir installé les deux extensions ci-dessus, cliquez sur l'entrée "Filter Stream Converter" sur le menu d'Application XWiki.
Suivez les instructions comme indiquées dans la capture d'écran ci-dessous. Cette extension n'est pas traduite, mais nous allons vous guider ici, si besoin n'hésitez pas à traduire la documentation.

  • Choisissez l'input type "Confluence XML input stream (confluence+xml)"
  • Remplissez dans le champ Source "file:" suivi du chemin du fichier zip des données Confluence situé sur la machine sur laquelle XWiki est installé.
  • Choisissez l'output type "XWiki instance output stream (xwiki+instance)" pour importer le contenu du fichier dans XWiki.

Voici une page type prête à lancer une migration des données :

filterconverter.png

Après avoir terminé les trois points ci-dessus, cliquez sur le bouton "Convert". Vous verrez ensuite la progression de la conversion s'afficher.
Cela ressemblera à ceci :

file-streams-conversion-done.png

Après un rafraîchissement de la page, vous retrouverez votre contenu dans le panneau de navigation (par défaut sur la gauche de l'écran).

4. Organisez le nouveau contenu

Voici venu le moment idéal pour s'attarder un peu sur l'architecture d'XWIki. Une bonne organisation du contenu est un des pré-requis au succès de votre projet. Elle permet à vos utilisateurs de créer, trouver et partager l'information facilement. Vous pouvez présenter les sections principales de votre wiki, décider si vous allez par la suite utiliser des sous-wikis ou des espaces d'un même wikis, créer une application AppWithinMinutes, réfléchir aux liens entre vos documents, tags, hiérarchie des pages... Vous pouvez aussi en profiter pour éventuellement faire du nettoyage et archiver les documents qui n'ont pas été utilisés récemment.

Une fois mis en place la structure de vos pages sur l'instance XWiki, utilisez l'extension Nested Pages Migrator pour créer l'arborescence de vos pages. Certaines pages deviendront alors "pages parentes" (espaces) et auront des "pages enfant".

Enfin, faites un bilan rapide du résultat obtenu en parcourant le wiki et le contenu des pages.

5. Comment résoudre les éventuels problèmes ?

Dans XWiki et Confluence, vous avez la possibilité d'utiliser des macros. XWiki offre plus de 170 macros pour mettre en forme le contenu, afficher des données sous une certains forme, créer des tableaux de bord, entre autres. Certaines macros Confluence ont leur équivalent dans XWiki, d'autres non. Dans le cas des macros inexistantes dans XWiki, vous allez devoir créer des macros et faire la connexion, ou les re-créer dans XWiki.

Vous pouvez lancer une recherche Database Search pour vérifier combien de fois sont utilisées les macros que vous avez importé de Confluence. Cela pourra vous aider à choisir si vous devez les re-écrire ou non.

6. Gestion des utilisateurs et droits

Vous pouvez maintenant recréer les utilisateurs et le schéma des droits avec toute la finesse que permet le Système de gestion des droits XWiki. Cela signifie définir qui peut voir, commenter, modifier, écrire des scripts, supprimer, administrer ou programmer, par groupes ou par utilisateur. Et ce au niveau global, pour un sous-wiki, ou par espace, voire même pour chaque page.

Ensuite, vous pourrez mettre en place éventuellement une méthode d'authentification alternative comme l'Active Directory, le login par réseau social, un SSO ou autre authentificateur custom.

7. Encore besoin d'aide ?

Les architectes de XWiki SAS peuvent vous aider à migrer et organiser votre contenu Confluence dans votre nouvelle instance XWiki. De plus nous proposons des offres de consulting, développement ou design, à travers desquelles nous configurons et personnalisons votre instance de manière à répondre parfaitement à vos besoins.

Une fois que XWiki est en place, jetez un coup d’œil à nos offres de support qui vous apportent toute l'aide technique requise pour atteindre vos objectifs. Notre service de support vous garantie le bon fonctionnement de votre instance : L'équipe corrige les problèmes rencontrés, et peut vous assister dans l'utilisation de votre wiki.

Souhaitez-vous une évaluation de votre projet ?

PRENDRE UN RENDEZ-VOUS AVEC UN SPÉCIALISTE XWIKI

 

Articles similaires :