Écrit par
Lorina Balan
, Spécialiste en marketing digital
Le 28 novembre, nous avons organisé notre webinaire intitulé « Un guide pratique pour migrer depuis Confluence et pourquoi c'est plus qu'un simple changement technique », où les participants ont acquis des stratégies pratiques pour la transition de leur base de connaissances vers XWiki. Dirigée par Ștefana Nazare, responsable produit des applications Pro et experte chevronnée de la migration depuis Confluence, la session a fourni aux participants des outils et des informations essentiels pour assurer une migration en douceur.
Lors de ce webinaire, nous avons présenté des approches pratiques et des conseils concrets pour rendre les migrations efficaces et sans stress. Voici un résumé des sujets traités :
- Un aperçu du processus de migration, y compris les attentes pour chaque étape ;
- Comment planifier efficacement votre migration en hiérarchisant le contenu et en définissant les objectifs ;
- Des conseils pour gérer les éléments problématiques tels que les macros, les autorisations et les structures de données uniques ;
- Les stratégies pour minimiser les perturbations, réduire les temps d'arrêt et préserver les flux de travail pendant la transition ;
- Une démonstration en direct du migrateur Confluence (Pro), montrant son potentiel pour simplifier le processus ;
- Les avis de notre experte en migrations lors de la séance de questions-réponses, portant sur des cas d'utilisation et des défis spécifiques.
Vous trouverez ci-dessous plus d'informations sur les principaux points à retenir, l'enregistrement et la transcription de la session de questions-réponses.
Points clés à retenir
La migration de Confluence vers XWiki est un processus à multiples facettes, mais avec les bons outils et les bonnes stratégies, elle peut être l'occasion de débloquer de nouvelles possibilités pour votre entreprise. Pendant le webinaire, nous avons exploré non seulement le comment, mais aussi le pourquoi d'une migration réussie. Voici les points les plus marquants :
#1 Planifier à l'avance pour réussir. Qu'il s'agisse de décider des environnements de déploiement ou d'aborder la question des macros, des autorisations et des plugins, une préparation réfléchie garantit un processus plus harmonieux. Par exemple, revoir l'utilisation des macros dans Confluence permet d'éviter les surprises et de préparer le terrain pour une transition réussie.
#2 Le kit de migration Confluence simplifie même les migrations les plus difficiles, en offrant des fonctionnalités telles que le mappage des liens, la migration par lots pour les instances de grande taille, et la prise en charge des autorisations et des pièces jointes. Ces outils sont équipés pour tout gérer, des petits wikis aux installations de plusieurs téraoctets.
#3 S'adapter aux défis avec flexibilité. La migration n'est pas un processus universel. Qu'il s'agisse de gérer des plugins compliqués ou des macros qui ne sont pas prises en charge, XWiki offre à la fois des solutions intégrées et la flexibilité nécessaire pour s'adapter à vos besoins spécifiques.
#4 Construire pour le long terme. Avec XWiki, vous investissez dans une plateforme open-source qui évolue avec votre organisation. Pas d'enfermement propriétaire, pas de changements surprises — juste la liberté d'évoluer, de personnaliser et d'innover au fur et à mesure de la croissance de votre entreprise.
Grâce à ces informations, votre migration peut être plus qu'un simple transfert de données – c'est l'occasion de construire une meilleure plateforme de collaboration, encore plus flexible.
Pour ceux qui souhaitent aller encore plus loin, XWiki propose une multitude de ressources pour vous aider dans votre démarche de migration. Que vous commenciez à peine ou que vous cherchiez à optimiser votre processus, nous vous recommandons d'explorer ces outils :
- Le migrateur Confluence (Pro)
- La liste des macros compatibles
- Ressources et services sur Confluence
- Package macros Pro
Séance de questions-réponses
Q1 : Nous quittons Jira en même temps que Confluence. Prévoyez-vous d'offrir des macros/plugins pour des systèmes alternatifs, en particulier OpenProject ?
Oui, nous prévoyons une intégration avec OpenProject. Nous en avons discuté tout au long de l'année et le développement devrait commencer en décembre ou janvier. L'intégration offrira un moyen de gérer les macros et les liens entre XWiki et OpenProject, similaire à la fonctionnalité Jira-Confluence. Cependant, la migration de Jira vers OpenProject peut encore impliquer de recréer des filtres ou des champs personnalisés, car une migration identique complète est complexe. Une fois la migration terminée, nous publierons des recommandations.
Q2 : Je sais comment voir quelles macros sont disponibles dans mon instance de Confluence. Existe-t-il un moyen de voir quelles macros sont réellement utilisées ?
Oui, cela peut généralement être fait via la section « Macro Usage » dans les paramètres d'administration de Confluence. Cette fonctionnalité liste toutes les macros utilisées, le nombre de fois qu'elles apparaissent, et les pages spécifiques où elles sont utilisées. Cette liste est particulièrement utile lors de la planification d'une migration, car elle permet d'identifier les macros qui fonctionneront dans XWiki et celles qui nécessiteront des solutions personnalisées.
Q3 : Mon serveur Confluence est tombé en panne. C'est un petit wiki, 50 pages, mises à jour Windows. J'ai pu le restaurer et le faire fonctionner, mais Confluence ne fonctionne plus. Que dois-je faire ?
Pour ce type de problème, nous vous recommandons de nous contacter directement à l'adresse contact@xwiki.com. Notre équipe aura besoin de plus de détails pour enquêter et vous aider, car le problème peut nécessiter l'examen de journaux ou de configurations spécifiques.
Q4 : L'essai du kit de migration Confluence est-il valable un mois ? Est-ce qu'il fonctionne avec toutes les options ?
Oui, la version d'essai dure un mois et donne accès à la plupart des fonctionnalités. Cependant, le migrateur Confluence Pro est limité à la migration d'un maximum de 30 pages par exécution. Si vous essayez de migrer un espace contenant plus de 30 pages, seules les 30 premières pages seront migrées. Vous pouvez effectuer plusieurs migrations pour tester la pertinence de l'outil.
Q5 : Pouvons-nous commencer par le niveau Gold et passer ensuite au niveau Silver une fois la migration terminée ?
Bien qu'il soit techniquement possible de passer de Gold à Silver, cela n'est pas recommandé pour les instances qui impliquent une migration depuis Confluence. Après la migration, les instances XWiki ont tendance à être plus complexes en raison des macros de pont et des plugins importés. Le niveau de support Gold garantit que ces complexités sont prises en charge, alors que le niveau Silver ne couvre pas les problèmes liés à la migration, tels que les problèmes avec les macros de pont ou les plugins personnalisés.
Q6 : Quelle est la taille maximale du fichier d'importation ?
Il n'y a pas de restriction spécifique concernant la taille maximale des fichiers d'importation. Par défaut, les pièces jointes sont plafonnées à 100 Go, mais cette limite peut être ajustée dans les paramètres d'administration de l'instance XWiki. Pour les migrations plus importantes, nous recommandons d'assurer une mémoire et un stockage suffisants. Dans les instances cloud, des augmentations temporaires de ressources peuvent être demandées pendant le processus de migration. Les installations sur place devraient allouer au moins trois fois la taille de l'exportation dans le stockage et ajuster la mémoire de la JVM en conséquence.
Q7 : Nous dépendons fortement des liens bidirectionnels entre les pages Confluence et les tâches Jira. Existe-t-il un moyen de migrer ces liens ?
- Liens existants : Les liens absolus vers les tâches Jira dans les pages Confluence seront migrés tels quels et resteront cliquables.
- Macros Jira : Les liens créés à l'aide de macros Jira ne sont actuellement pas conservés, mais ils peuvent être convertis en références textuelles lors de la migration.
- Alternatives : XWiki propose une macro Jira qui permet d'intégrer et d'afficher des données Jira, telles que des listes de tâches ou des statuts, dans les pages XWiki. De plus, nous travaillons à l'intégration d'OpenProject, qui offrira des possibilités similaires de liens et de suivi des incidents.
Q8 : Je suis actuellement en phase de migration avec des licences d'essai. Le problème est que je ne peux plus ouvrir ou importer des fichiers PDF ou des fichiers open text. Quelles sont les extensions nécessaires pour que cela fonctionne ?
Si vous utilisez des macros Confluence telles que « view PDF », elles doivent être converties en fonctionnalité « view file » dans XWiki. Pour les pièces jointes, assurez-vous de les importer avec le contenu. Si vous ne pouvez pas accéder aux PDF, vérifiez que vous utilisez l'extension Pro Macros, car elle gère la fonctionnalité de visualisation des PDF.
Q9 : Comment puis-je évaluer si toutes mes données Confluence sont compatibles avec XWiki ?
Le contenu standard tel que le texte, les titres et les macros couramment utilisées (par exemple, info ou avertissement) est généralement compatible et sera migré sans problème. Cependant, des problèmes de compatibilité peuvent survenir avec des plugins et des macros de tierces parties. La documentation publique du kit de migration Confluence comprend une liste détaillée des macros prises en charge et des suggestions pour gérer les macros qui ne le sont pas.
Q10 : Quelles sont les erreurs les plus courantes lors de la migration de Confluence vers XWiki, et comment les éviter ?
Les problèmes les plus courants sont les liens brisés lors de la migration de contenu par lots, qui peuvent être corrigés à l'aide de scripts. Les plugins, en particulier les plugins tiers tels que les macros « Scroll Versions “ et ” Content Formatting », peuvent également être à l'origine de ces problèmes. Pour éviter cela, nous vous recommandons d'examiner minutieusement vos macros et vos plugins à l'avance, de suivre un plan de migration détaillé et de recourir à des outils tels que la fonction de mappage des URL pour garantir la continuité des liens.
Q11 : Peut-on migrer les synchronisations de contenu live de Confluence ? Qu'en est-il de la compatibilité avec les plugins ?
XWiki dispose d'une application de réplication qui permet de synchroniser le contenu entre les instances de XWiki. Bien qu'elle ne soit pas identique aux capacités de synchronisation de Confluence, elle offre une alternative viable. La compatibilité des plugins dépend du plugin en question. De nombreuses macros de Confluence ont des équivalents dans XWiki, mais certains plugins tiers peuvent nécessiter des solutions personnalisées.
Q12 : Les liens Jira et le contenu dynamique comme le suivi des incidents peuvent-ils être conservés dans XWiki ? Quelles sont les alternatives ?
Les liens Jira peuvent être migrés, mais XWiki ne supporte pas les macros Jira de la même manière que Confluence. Si vous abandonnez Jira, nous vous recommandons de passer à OpenProject, pour lequel nous prévoyons de développer une intégration permettant de créer des liens plus efficaces.
Q13 : Quelle est l'estimation de la complexité et de la durée de la migration ?
Les délais de migration varient en fonction de la taille et de la complexité de l'instance Confluence. Par exemple :
- Les petites instances (par exemple, 10 Go) peuvent prendre quelques jours.
- Les grandes instances avec des plugins et du travail sur mesure (par exemple, 2 To) peuvent prendre des mois. Les facteurs clés sont le nombre d'espaces, d'utilisateurs, de pages et les plugins/macros impliqués.
Q14 : Comment puis-je vérifier que toutes les données ont été migrées avec succès ? Existe-t-il des journaux ou des rapports permettant d'identifier les pages ou les pièces jointes problématiques en vue d'une migration manuelle ?
XWiki génère des journaux détaillés et des rapports de migration. Ces journaux répertorient les erreurs, telles que les problèmes liés à des pages spécifiques, les utilisateurs manquants ou les liens brisés. Les pages comportant des erreurs ou des éléments manquants peuvent être identifiées et traitées manuellement. En plus, la conservation de l'historique vous permet d'annuler les changements ou de réessayer la migration pour des espaces spécifiques.
