---
url: /res/oie/migration.md
description: Procédure de migration de Mirth Connect vers Open Integration Engine
---

# 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](https://github.com/nextgenhealthcare/connect/releases).

2. **Arrêter le service Mirth Connect**
   ```bash
   sudo systemctl stop mirthconnect
   ```

3. **Sauvegarder l’installation actuelle**
   Copiez le répertoire d’installation et la base de données :
   ```bash
   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**
   ```bash
   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 :
     ```bash
     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](https://github.com/OpenIntegrationEngine/engine/releases).

2. **Extraire l’archive**
   ```bash
   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:
   ```bash
   sudo apt install openjdk-11-jdk
   ```

5. **Lancer OIE**
   ```bash
   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**
   ```bash
   ./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 :
     ```bash
     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.

[Contactez-nous](https://www.mirounga.eu/contactus)