Migrez depuis Confluence sans aucune perte de données

Le plus souvent, les organisations planifient leur migration par équipe ou par service.

Par exemple, pendant la première semaine, les espaces Confluence utilisés par le service commercial sont passés en lecture seule, exportés depuis Confluence, puis migrés vers XWiki.

L’équipe commerciale bascule ensuite sur XWiki pour l’édition et la création de nouvelles pages. En meme temps, ses espaces Confluence restent en lecture seule à titre de référence. Selon la taille de votre instance Confluence, il est également possible d’effectuer la migration en une seule fois à l’aide de l’export de sauvegarde.

La migration se déroule généralement comme suit :

Export depuis Confluence : Utilisez les mécanismes d’export natifs de Confluence : espace par espace (XML) ou sauvegarde XML complète du site. Il n’est pas nécessaire d’arrêter Confluence pour créer ces exports.

Import dans XWiki : Installez le kit de migration Confluence sur XWiki. Accédez à l’interface du migrateur Confluence et importez l’export XML, ou sélectionnez-le directement depuis votre serveur. Lancez la migration par espace, par lots, ou sur l’ensemble de la sauvegarde. Le migrateur importe les pages, pièces jointes, commentaires, utilisateurs, groupes, permissions, et bien plus encore, selon les paramètres définis.

Étapes post-migration : Une fois l’import terminé, l’outil génère un rapport détaillant tout ce qui a été importé ainsi que les éventuels problèmes identifiés (macros sans équivalent, liens cassés, etc.). La plupart du contenu standard est migré sans difficulté. Cela est possible, car le kit couvre l’historique, les pièces jointes, les étiquettes, les utilisateurs, les groupes, les permissions et de nombreuses macros.

L’approche recommandée est itérative : Exportez un espace ou un ensemble d’espaces, importez-les dans XWiki, procédez à une vérification, puis planifiez la migration définitive. XWiki peut gérer des imports de très grande ampleur. Des migrations portant sur plusieurs téraoctets de données ont déjà été réalisées avec succès. Les principaux points de vigilance concernent la mémoire, les paramètres de délai d’exécution (timeout), et la bonne configuration de l’environnement.

La plupart des équipes regroupent plusieurs espaces Confluence au sein d’un même wiki. Les sous-wikis sont des « compartiments » à utiliser lorsqu’une séparation plus forte est nécessaire. Il s'agit généralement d'un nombre restreint, aligné sur des frontières réelles comme un service, une unité commerciale, une région ou un domaine de sécurité. Créer un sous-wiki par espace Confluence n’a que rarement de sens à grande échelle.

Il est également tout à fait possible de migrer l’ensemble des espaces Confluence vers le wiki principal de XWiki. Le choix entre « uniquement un wiki principal » et « quelques sous-wikis en guise de compartiments » dépend du type de contenu migré et du niveau de séparation nécessaire au quotidien.

Nous recommandons vivement de bien comprendre les workflows et les usages actuels de Confluence avant de démarrer la migration des données. Voici une liste synthétique des points à considérer :

• Décidez des métadonnées et des éléments de page à conserver (historique, pièces jointes, créateur).
• Décidez si vous allez migrer les utilisateurs et planifiez leur migration.
• Décidez du mode d’authentification pour le nouveau système wiki.
• Passez en revue les macros que vous utilisez et vérifiez lesquelles sont disponibles dans XWiki.
• Configurez une instance XWiki disposant de ressources suffisantes pour exécuter la migration.
• Cessez d’utiliser l’instance Confluence pendant la migration, afin d’éviter d’avoir à la relancer plusieurs fois sur un même espace.
• Migrez par lots, par équipe, et effectuez des migrations de test avant de valider la migration définitive en production.
• Faites basculer les équipes vers XWiki de manière progressive, en commençant par les utilisateurs avancés. Vous pourrez ainsi recueillir des retours et créer des supports de formation qui faciliteront la transition pour reste des utilisateurs.

Plusieurs variables peuvent rendre une migration complexe. Les plus courantes sont :

• Le nombre de macros utilisées

• Le nombre de versions de pages

• Les plugins tiers utilisés

• L'utilisation de macros personnalisées

• Le nombre d'utilisateurs et la configuration des permissions

XWiki SAS propose une offre complète de services professionnels pour les migrations. Cela va de l’installation et de la configuration à la formation. L'offre inclut aussi le conseil, l’exécution de la migration et le support technique à long terme. Le plus souvent, les organisations préfèrent effectuer elles-mêmes la migration, selon leur propre calendrier. Les architectes de XWiki SAS ou les partenaires apportent leur assistance pour la configuration initiale et le conseil pendant la migration. Ils assurent aussi le support technique à long terme une fois la migration terminée.

Nous encourageons les organisations à créer une démo cloud gratuite afin d’effectuer des migrations de test. N’hésitez pas à nous contacter à contact@xwiki.com pour toute question relative à vos projets de migration.

Oui, mais nous recommandons vivement de l'utiliser dans le cadre du kit de migration Confluence. Celui-ci qui regroupe toutes les applications (y compris les macros) et services nécessaires pour transférer rapidement vos données et bénéficier d'un support technique à long terme. Voici ce que comprend le kit :

• Le migrateur Confluence (Pro) pour une migration fluide

• Des macros de transition spécifiques à Confluence

• Le gestionnaire de tâches (Pro) pour conserver vos actions et votre productivité quotidienne immédiatement après la migration

• Un support technique à long terme couvrant le produit principal, les applications Pro, les extensions recommandées et les extensions communautaires

Les liens pointant vers du contenu pas encore importé ne fonctionneront pas tant que la page cible n’aura pas été créée dans XWiki. Toutefois, ce problème ne persistera pas une fois l’ensemble des données migré. Si certains liens restent cassés après la migration complète du contenu, vous pouvez les corriger. L’outil de migration inclut des « corrections post-migration » dédiées à cet effet.

Ce n’est pas nécessaire, car les permissions peuvent être migrées indépendamment des utilisateurs. Une fois vos pages migrées, vous pouvez lancer une migration distincte pour les utilisateurs et/ou les permissions (via les paramètres avancés de la migration), et les droits d’accès seront appliqués correctement. Vous pouvez même migrer les permissions sans que les utilisateurs soient encore présents sur le wiki. Elles s’appliqueront dès que ces utilisateurs seront créés dans XWiki.

Un import complètement basé sur l'API REST n'est pas recommandé. Certaines ressources ne sont pas facilement accessibles et des problèmes de compatibilité peuvent survenir selon la version de Confluence. Vous pouvez toutefois créer des scripts pour exporter les espaces Confluence les uns après les autres et les organiser en lots. Ensuite, vous pouvez utiliser le migrateur Confluence (Pro) pour configurer des migrations par lots.

Ainsi, les migrations s'exécuteront les unes après les autres, et vous pourrez consulter les rapports au fur et à mesure de leur progression. Cette méthode garantit également des ressources suffisantes et produit un rapport permettant de corriger les pages défectueuses après l'import.

Oui, vous pouvez organiser vos exports d'espaces en lots, ce qui déclenchera la migration de chaque espace les uns après les autres. Par ailleurs, si votre instance est relativement petite, vous pouvez utiliser l'export de sauvegarde de Confluence. Cela vous permet d'exporter l'intégralité du site Confluence et migrer le site complet en une seule opération dans XWiki. Ces trois options (espace individuel, lot, et sauvegarde complète) sont toutes disponibles dans le migrateur Confluence (Pro).

Oui, vous pouvez relancer la migration sur le même espace si une nouvelle version du contenu est disponible. Les pages inchangées seront ignorées, tandis que les pages comportant des mises à jour seront importées. Vous pouvez également exécuter des migrations par lots et transférer une équipe ou un service à la fois.