Migration de Mirth Connect vers Open Integration Engine (OIE)

Introduction

Mirth Connect est une solution d’intégration de données largement utilisée dans le domaine de la santé et au-delà.

Depuis la version 4.5.2, Mirth COnnect est devenu close source, un fork a été initié et est devenu le projet Open Integration Engine (OIE), une version open source maintenue par la communauté.

Ce guide vous accompagne pas à pas pour migrer votre instance Mirth Connect vers OIE, en garantissant la sauvegarde et la restauration de vos canaux, utilisateurs et configurations.

Prérequis

• Accès administrateur à l’instance Mirth Connect existante
• Environnement compatible avec OIE (Java 17+, base de données supportée)
• Droits d’installation sur le serveur cible
• Sauvegarde complète de la base de données et des fichiers de configuration

Étape 1 : Mise à jour de Mirth Connect vers la version 4.5.2

Avant de migrer, il est recommandé de mettre à jour votre instance Mirth Connect vers la dernière version open source (4.5.2). Cela facilite la compatibilité avec OIE et réduit les risques d’incompatibilité.

Procédure de mise à jour

1. Télécharger Mirth Connect 4.5.2 Récupérez l’archive depuis le dépôt officiel.

2. Arrêter le service Mirth Connect

   sudo systemctl stop mirthconnect

3. Sauvegarder l’installation actuelle Copiez le répertoire d’installation et la base de données :

   cp -r /opt/mirthconnect /opt/mirthconnect_backup

4. Extraire et installer la nouvelle version Remplacez les fichiers par ceux de la version 4.5.2, en conservant vos fichiers de configuration (mirth.properties, mirth.db, etc.).

5. Redémarrer le service

   sudo systemctl start mirthconnect

6. Vérifier la version Connectez-vous à l’interface d’administration et vérifiez que la version affichée est bien 4.5.2.

Étape 2 : Sauvegarde des channels, utilisateurs et configurations

Avant toute migration, il est impératif de sauvegarder l’ensemble des données et configurations.

Sauvegarde via l’interface

1. Exporter les canaux

   • Allez dans Channels > Sélectionnez tous les Channels > Export (format XML). Il est possible d'exporter les channels par groupe
   • Enregistrez le fichier sur votre machine.

2. Exporter les utilisateurs et rôles

   • Allez dans Users > Sélectionnez chaque utilisateur > Export (format XML).
   • Notez les mots de passe (ils ne sont pas exportés, il faudra les recréer manuellement).

3. Exporter les configurations globales

   • Allez dans Settings > Export Configuration (fichier XML).

4. Sauvegarder la base de données

   • Si vous utilisez MySQL/PostgreSQL, faites un dump complet :

     mysqldump -u [user] -p mirthdb > mirth_db_backup.sql

INFO

Une autre façon est d'utiliser le client mirth en ligne de commande

---

Étape 3 : Installation d’Open Integration Engine 4.5.2

Téléchargement et installation

1. Télécharger OIE 4.5.2 Récupérez la dernière version depuis le dépôt GitHub officiel.

2. Extraire l’archive

   tar -xzvf open-integration-engine-4.5.2.tar.gz -C /opt/

3. Configurer la base de données

   • Copiez votre fichier de configuration de base de données (mirth.db) depuis la sauvegarde.
   • Adaptez les paramètres de connexion dans mirth.properties.

4. Installer les dépendances Java OIE nécessite Java 17 ou supérieur. Installez-le si ce n’est pas déjà fait:

   sudo apt install openjdk-11-jdk

5. Lancer OIE

   cd /opt/open-integration-engine-4.5.2
   ./mcservice start

6. Vérifier l’accès Ouvrez un navigateur et connectez-vous à http://localhost:8080.

Étape 4 : Restauration des paramètres et configurations

Restauration via l’interface

1. Importer les canaux

   • Allez dans Channels > Import > Sélectionnez le fichier XML exporté précédemment.
   • Il est possible de d'importer le fichier de groupe à la place.

2. Recréer les utilisateurs

   • Allez dans Users > Add User et recréez chaque utilisateur avec ses rôles et mots de passe.

3. Importer la configuration globale

   • Allez dans Settings > Import Configuration > Sélectionnez le fichier XML.

4. Redémarrer le service

   ./mcservice restart

Étape 5 : Tests et validation

1. Vérifier le statut des canaux

   • Tous les canaux doivent apparaître dans la liste et être au statut Deployed ou Stopped selon leur configuration initiale.

2. Tester un échange de données

   • Envoyez un message test via un canal et vérifiez qu’il est bien traité.

3. Vérifier les logs

   • Consultez les logs pour détecter d’éventuelles erreurs :

     tail -f logs/wrapper.log

   • Double cliquer sur un Channel, pour vérifier l'état des traitements et les éventuelles erreurs

Bonnes pratiques et recommandations

• Documenter chaque étape : Notez les versions, les paramètres modifiés et les éventuels problèmes rencontrés.
• Tester en environnement de staging : Effectuez la migration sur une copie de votre environnement de production avant de basculer définitivement.
• Surveiller les performances : Après migration, surveillez la charge CPU, mémoire et base de données pour détecter d’éventuels goulots d’étranglement.
• Mettre à jour régulièrement : OIE est maintenu par la communauté, pensez à suivre les mises à jour de sécurité et de fonctionnalités.

Conclusion

La migration de Mirth Connect vers Open Integration Engine est un processus structuré qui, s’il est bien préparé, se déroule sans encombre. En suivant ce guide, vous garantissez la continuité de vos flux d’intégration tout en bénéficiant des avantages d’une solution open source active et maintenue.

Prochaine étape : Explorez les nouvelles fonctionnalités d’OIE et participez à la communauté pour contribuer à son évolution !

Besoin d'assistance? Vous souhaitez migrer vers OIE, déployer une nouvelle solution d’intégration, ou optimiser votre infrastructure existante ?

Notre équipe est à votre disposition pour discuter de vos besoins et vous proposer une solution adaptée.

ne pas remplir si vous êtes un humain: