---
title: "Haute disponibilité MySQL avec SafeKit : installer le module mysql.safe pour le basculement"
canonical: "https://safekit.eviden.com/fr/quick-install/safekit-quick-installation-guide-with-mysql/"
description: "Déployez le module mysql.safe pour SafeKit afin d’activer la réplication synchrone en temps réel et le basculement automatique de MySQL sous Windows et Linux. Ce guide vous explique comment configurer un cluster SANless à 2 nœuds pour des applications critiques sans stockage partagé."
category: "quick-install"
lang: "fr"
topics: "Guide d’installation rapide de la haute disponibilité pour MySQL, Limitations de la haute disponibilité SafeKit, Présentation de la solution SafeKit/MySQL, Installation de la solution SafeKit/MySQL sous Windows et Linux (mysql.safe), Configuration pas à pas de la solution SafeKit / serveur MySQL, Démonstration de la solution mirror SafeKit"
translation: "translate_md 2026-11-08.15 | glossaire 2026-11-09.11 | Translation LLM | 38 expressions"
---
# Haute disponibilité MySQL avec SafeKit : installer le module mysql.safe pour le basculement {#mysql-high-availability-with-safekit-install-the-mysqlsafe-module-for-failover}
## Guide d’installation rapide de la haute disponibilité pour MySQL {#quick-guide}
Ce guide explique comment configurer un **cluster mirror** pour MySQL à l’aide de SafeKit, assurant un basculement automatique et une réplication synchrone sans avoir besoin d’un stockage partagé.
Pour obtenir de l’aide, vous pouvez utiliser [SafeKit AI 🤖](https://safekit.eviden.com/fr/resources/safekit-support/).
### 1. Vue d’ensemble {#1-overview}
* **Architecture :** utilise un système à deux nœuds (principal/secondaire).
* **Protection des données :** implémente la réplication synchrone en temps réel pour **une perte de données nulle** (RPO = 0).
### 2. Installation {#2-installation}
* **Logiciel :** Installez le moteur SafeKit sur les deux serveurs.
* **Module :** Téléchargez le module d’application `mysql.safe` préconfiguré.
### 3. Configuration {#3-configuration}
* **Console Web :** configurez les dossiers spécifiques contenant les fichiers MySQL.
* **Surveillance :** Commencez à surveiller et à protéger l’application MySQL.
## Limitations de la haute disponibilité SafeKit {#safekit-ha-limitations}
Limite / Exigence | Raison et impact | Alternative recommandée
---|---|---
Taille de la réplication : quelques To | Temps de resynchronisation après une défaillance ([étape 3](https://safekit.eviden.com/fr/architectures/file-replication-byte-level-with-failover-mirror-cluster/#safekit-mirror-cluster)) :
• Réseau à 1 Gb/s ≈ 3 heures/To
• Réseau 10 Gb/s ≈ 1 heure/To (selon les performances d’écriture du disque) | • Utiliser [un stockage partagé externe](https://safekit.eviden.com/fr/best-practises/san-vs-nas-shared-storage-for-a-failover-cluster/) (plus coûteux, plus complexe).
Nombre de fichiers : < 1 000 000 | • Performance du temps de resynchronisation après une panne ([étape 3](https://safekit.eviden.com/fr/architectures/file-replication-byte-level-with-failover-mirror-cluster/#safekit-mirror-cluster)).
• Temps nécessaire pour comparer chaque fichier entre les deux nœuds. | • Placez les nombreux fichiers à répliquer dans un disque dur virtuel/une machine virtuelle.
• Dans ce cas, seuls les fichiers représentant le disque dur virtuel ou la machine virtuelle seront répliqués et resynchronisés.
Capacité de basculement : ≤ 32 machines virtuelles | • Chaque machine virtuelle s’exécute dans un module mirror indépendant.
• Maximum de 32 modules mirror fonctionnant sur le même cluster. | • Utiliser un stockage partagé externe et une autre solution de clustering de machines virtuelles (plus coûteuse et plus complexe).
Architecture réseau : réseau LAN/VLAN entre sites distants | • Basculement automatique de l’[adresse IP virtuelle](https://safekit.eviden.com/fr/best-practises/how-a-virtual-ip-address-works/) avec 2 nœuds dans le même sous-réseau.
• Bonne bande passante pour la resynchronisation ([étape 3](https://safekit.eviden.com/fr/architectures/file-replication-byte-level-with-failover-mirror-cluster/#safekit-mirror-cluster)).
• Faible latence pour [la réplication synchrone](https://safekit.eviden.com/fr/best-practises/synchronous-replication-vs-asynchronous-replication/) : généralement < 5 ms RTT ; les valeurs plus élevées doivent être validées par rapport au taux d’écriture de l’application. | • Si les deux nœuds se trouvent dans des sous-réseaux différents (ce qui est courant dans le cloud), utilisez [d’autres options de réacheminement](https://safekit.eviden.com/fr/best-practises/how-a-virtual-ip-address-works/#safekit-virtual-ip-implementation) : un équilibreur de charge, des CLI de fournisseur de cloud, BGP ou une redirection DNS.
• Utilisez des solutions de sauvegarde avec réplication asynchrone pour les réseaux à latence élevée.
## Présentation de la solution SafeKit/MySQL {#overview-of-the-safekit--mysql-solution}
La solution est décrite ici : **💡 [La haute disponibilité MySQL la plus simple : réplication synchrone et basculement à 2 nœuds]()**.
## Installation de la solution SafeKit/MySQL sous Windows et Linux (mysql.safe) {#installation-of-the-safekit--mysql-solution-on-windows-and-linux-mysqlsafe}
### Prérequis {#prerequisites}
* Vous devez avoir MySQL installé sur 2 nœuds (machines virtuelles ou serveurs physiques).
### Installation du paquet sous Windows {#package-installation-on-windows}
* Téléchargez et installez la version gratuite de SafeKit sur 2 nœuds Windows.
Remarque : la version gratuite inclut toutes les fonctionnalités SafeKit. À la fin de la période d’essai, vous pouvez activer des clés de licence permanentes sans désinstaller le package.
* Une fois l’installation du package terminée, sélectionnez **Définir les informations d’identification de la console et les règles du pare-feu maintenant** et configurez un mot de passe pour l’utilisateur **admin** de la console SafeKit.
**Définissez le même mot de passe sur tous les nœuds.**
* Excluez de l’analyse antivirus **C:/safekit/** (le répertoire d’installation par défaut) et **tous les dossiers répliqués** que vous allez définir.
Les antivirus peuvent rencontrer des difficultés de détection avec SafeKit en raison de son intégration étroite avec le système d’exploitation, des mécanismes d’IP virtuelle, de la réplication en temps réel et du redémarrage des services critiques.
Télécharger SafeKit (Windows) >
### Installation du module sous Windows {#module-installation-on-windows}
* Téléchargez le module mysql.safe. Le module est gratuit. Il contient les fichiers userconfig.xml et les scripts de redémarrage.
* Placez **mysql.safe** dans **C:/safekit/Application_Modules/generic**.
Télécharger mysql.safe (Windows) >
### Installation de paquets sous Linux {#package-installation-on-linux}
* Installez la version gratuite de SafeKit sur 2 nœuds Linux. Remarque : la version d’essai gratuite inclut toutes les fonctionnalités SafeKit. À la fin de la période d’essai, vous pouvez activer des clés de licence permanentes sans désinstaller le package.
* Après le téléchargement du paquet safekit_xx.bin, exécutez-le pour extraire le rpm et le script safekitinstall, puis exécutez le script **safekitinstall**
* Répondez **oui** à la configuration automatique du pare-feu
* Définissez le mot de passe de la console Web et de l’utilisateur **admin** par défaut. **Définissez le même mot de passe sur tous les nœuds.**
Télécharger SafeKit (Linux) >
### Installation du module sous Linux {#module-installation-on-linux}
* Téléchargez le module mysql.safe.
Le module est gratuit. Il contient les fichiers userconfig.xml et les scripts de redémarrage.
* Placez **mysql.safe** dans **/opt/safekit/Application_Modules/generic/**.
Télécharger mysql.safe (Linux) >
## Configuration pas à pas de la solution SafeKit / serveur MySQL {#step-by-step-configuration-of-the-safekit--mysql-server-solution}
### Prérequis {#prerequisites}
* MySQL installée sur 2 nœuds.
* Les données répliquées sont limitées à quelques téraoctets. Au-delà, le temps de resynchronisation devient important.
* Interconnexion d’au moins 1 Gb/s entre les nœuds (10 Gb/s recommandé pour une resynchronisation plus rapide).
* Le basculement IP nécessite que les deux nœuds soient sur le même LAN ou LAN étendu (L2) — les réseaux L3 routés ne sont pas pris en charge (sauf avec les équilibreurs de charge 🛠️ [cloud](https://safekit.eviden.com/fr/resources/safekit-user-guide-82/#Cloud)).
### 1. Lancez la console SafeKit {#1-launch-the-safekit-console}
* Lancez la console web dans un navigateur sur un nœud du cluster en vous connectant à `http://localhost:9010`.
* Saisissez `admin` comme nom d’utilisateur et le mot de passe défini lors de l’installation.
Vous pouvez également exécuter la console dans un navigateur sur un poste de travail externe au cluster.
⚠️ La configuration de SafeKit s’effectue sur les deux nœuds à partir d’un seul navigateur.
ℹ️ Pour sécuriser la console web, consultez 🛠️ [11. Sécuriser le service web SafeKit](https://safekit.eviden.com/fr/resources/safekit-user-guide-82/#https) dans le Guide de l’utilisateur.
### 2. Configurer les adresses des nœuds {#2-configure-node-addresses}
* Entrez les adresses IP des nœuds, appuyez sur la `Tab key` pour vérifier la connectivité et remplissez les noms des nœuds. Si node1 ou node2 est de couleur rouge, vérifiez la connectivité du navigateur aux deux nœuds et vérifiez le pare-feu sur les deux nœuds pour [le dépannage](https://safekit.eviden.com/fr/resources/safekit-user-guide-82/#Troubleshooting) 🛠️.
* Cliquez ensuite sur `Save and apply` pour sauvegarder la configuration.
* Vérifiez le message `Success` ✅ sur les deux nœuds.
* Si l’ `Failure` de configuration ❌ se produit sur un nœud, ouvrez l’accordéon ▼ pour ce nœud et consultez les messages. Notez que vous pouvez utiliser l’IA SafeKit 🤖 pour obtenir de l’aide.
ℹ️ Si vous le souhaitez, vous pouvez ajouter un nouveau `LAN and nodes` (premier ➕) pour créer un deuxième heartbeat et un réseau de réplication dédié.
ℹ️ Si vous cliquez sur `Advanced configuration`, le fichier `cluster.xml` s’affiche. Ce fichier est automatiquement renseigné par la console et déployé sur les nœuds.
### 3. Sélectionnez un module {#3-select-a-module}
* Dans `New module`, cliquez sur le module `mysql.safe`.
ℹ️ Dans la bannière bleue en haut, le nœud 🛜 `node1` représente le nœud de connexion de la console. Ce nœud relaie les requêtes vers le `node2` si nécessaire.
ℹ️ La console recherche `xxx.safe` dans le répertoire `Application_Modules/generic/` sur le nœud de connexion (`node1`) si vous y avez placé un module lors de l’installation.
### 4. Configurer le module {#4-configure-the-module}
* Dans `Module startup at boot`, choisissez un démarrage automatique du module au démarrage sans délai.
* Dans `Macros`/`SERVICES`, saisissez les noms des services de votre application, dans l’ordre de démarrage, séparés par des virgules. Consultez cette capture d’écran pour un exemple visuel des [services Milestone XProtect 🖼️](https://safekit.eviden.com/wp-content/uploads/2025/05/milestone-services.png).
* Dans `Heartbeat networks`, vous devez avoir un seul réseau de pulsation sur lequel la réplication est effectuée. Si vous avez ajouté un LAN local privé à l’étape 2, vous pouvez configurer deux pulsations avec le flux de réplication sur le LAN local privé.
* Dans `Virtual IP addresses`, entrez une adresse IP virtuelle. Une adresse IP virtuelle est une adresse IP standard dans le même réseau IP (même sous-réseau) que les adresses IP des deux nœuds.
Les clients d’application doivent être configurés avec l’adresse IP virtuelle (ou le nom DNS associé à l’adresse IP virtuelle).
L’adresse IP virtuelle est automatiquement commutée en cas de défaillance.
* Dans `Replicated directories`, définissez les chemins d’accès des répertoires à répliquer. Vérifiez qu’ils existent sur les deux nœuds et qu’ils contiennent les données de l’application.
La réplication des données et des journaux est essentielle pour une base de données.
Vous pouvez créer des répertoires répliqués supplémentaires selon vos besoins.
Consultez cette capture d’écran pour un exemple visuel de [la réplication SQL Milestone XProtect 🖼️](https://safekit.eviden.com/wp-content/uploads/2025/05/milestone-replication.png).
* Dans `Checkers`, vous pourrez configurer des vérificateurs si nécessaire, tels que la surveillance des processus, les vérificateurs personnalisés, TCP, ping ou les vérificateurs de scission du cerveau.
Par exemple, si un nom de processus est affiché dans `Monitored processes/services`, il sera surveillé avec une action de redémarrage en cas de défaillance. La configuration d’un nom de processus incorrect entraînera l’arrêt du module juste après son démarrage.
ℹ️ Si vous cliquez sur `Advanced configuration`, le fichier `userconfig.xml` s’affiche. Ce fichier est automatiquement renseigné par la console et déployé sur les nœuds avec les scripts de redémarrage.
ℹ️ Dans un déploiement cloud, vous n’avez pas besoin de configurer une adresse IP virtuelle dans SafeKit. L’IP virtuelle est gérée au niveau de l’équilibreur de charge du 🛠️ [cloud](https://safekit.eviden.com/fr/resources/safekit-user-guide-82/#Cloud).
ℹ️ Lorsque vous appliquez la configuration SafeKit, le `startup type` des services est automatiquement défini sur `Manual` dans les services Windows. Cela garantit que les services ne démarrent pas automatiquement au démarrage du système, mais qu’ils ne sont démarrés que lorsque le module lui-même est démarré (il en va de même sous Linux).
### 5. Modifier les scripts (facultatif) {#5-edit-scripts-optional}
* Cette étape est facultative et peut être ignorée dans la plupart des cas, car les scripts de redémarrage sont déjà préconfigurés pour redémarrer les services définis à l’étape précédente.
* Cliquez donc directement sur `Next step`.
* `start_prim.ps1` démarre tous les services dans l’ordre spécifié dans la liste `SERVICES`, tandis que `stop_prim.ps1` arrête tous les services dans l’ordre inverse.
* De plus, `start_prim.ps1` vérifie le démarrage de chaque service et arrête le module si un service ne démarre pas correctement.
### 6. Chiffrement des communications (facultatif) {#6-communication-encryption-optional}
* Conservez le chiffrement des communications entre les nœuds.
### 7. Enregistrer et appliquer {#7-save-and-apply}
* `Save and apply` la configuration et les scripts sur les deux nœuds.
### 8. Vérifier la réussite de la configuration {#8-verify-successful-configuration}
* Vérifiez le message `Success` ✅ sur les deux nœuds et cliquez sur `Monitor modules`.
* Si l’ `Failure` de configuration ❌ se produit sur un nœud, ouvrez l’accordéon ▼ pour ce nœud et consultez les messages. Notez que vous pouvez utiliser l’IA SafeKit 🤖 pour obtenir de l’aide.
⚠️ Sous Linux, vous pouvez obtenir une erreur à cette étape si les répertoires répliqués sont des points de montage. 🛠️ [Consultez SK-0030 pour résoudre le problème](https://github.com/FR-LES-SAFEKIT-DEV/safekit-packages/releases/download/v8.2/SafeKit_8.2_Knowledge_Base.pdf).
### 9. Démarrer le nœud avec des données à jour {#9-start-the-node-with-up-to-date-data}
* Si le nœud 1 possède les répertoires répliqués à jour, sélectionnez-le et ⋯ `Force start` ▶ `As primary`.
Lorsque le nœud 2 sera démarré, toutes les données seront copiées du nœud 1 vers le nœud 2.
⚠️ Si vous faites le mauvais choix, vous risquez de synchroniser des données obsolètes sur les deux nœuds.
⚠️ Il est également supposé que l’application MySQL est arrêtée sur le nœud 1 afin que SafeKit installe les mécanismes de réplication, puis démarre l’application dans le script `start_prim`.
⚠️ Utilisez `Start` pour les démarrages suivants : SafeKit conserve le serveur le plus à jour. Démarrer `As primary` est un démarrage spécial la première fois ou lors d’opérations exceptionnelles.
### 10. Attendez la transition vers ALONE (vert) {#10-wait-for-the-transition-to-alone-green}
* Le nœud 1 doit atteindre l’état ALONE (vert), ce qui signifie que l’IP virtuelle est définie et que le script `start_prim` a été exécuté sur le nœud 1.
⚠️ Si ALONE (vert) n’est pas atteint ou si l’application n’est pas démarrée, analysez la raison avec le [journal du module 🖼️](https://safekit.eviden.com/wp-content/uploads/2024/03/24-module-log-script.png) du nœud 1.
* Cliquez sur l’icône **de journal** 🔍 du `node1` pour ouvrir le journal du module et recherchez les messages d’erreur, tels qu’un vérificateur détectant une erreur et arrêtant le module.
* Cliquez sur `start_prim` dans le journal : les messages de sortie du script sont affichés à droite et les erreurs peuvent être détectées, comme un service mal démarré.
* Utilisez l’IA SafeKit 🤖 pour obtenir de l’aide concernant les messages du journal.
⚠️ Si le cluster est dans l’état `WAIT (red) not uptodate, STOP (red) not uptodate`, arrêtez le nœud WAIT et [forcez son démarrage en tant que primaire 🖼️](https://safekit.eviden.com/wp-content/uploads/2024/03/10-monitoring-mirror-stop-stop-prim.png).
### 11. Démarrer le nœud 2 {#11-start-node-2}
* ⋯ `Start` le nœud 2 avec son menu contextuel.
* Attendez le SECOND état (vert).
ℹ️ Le nœud 2 reste dans le SECOND état (orange) pendant la resynchronisation des répertoires répliqués (copie du nœud 1 vers le nœud 2).
* Cette opération peut prendre un certain temps en fonction de la taille des fichiers à resynchroniser dans les répertoires répliqués et de la bande passante du réseau.
* Pour voir la progression de la copie, consultez le [journal du module 🖼️](https://safekit.eviden.com/wp-content/uploads/2024/03/27-module-log-reintegration.png) et les [ressources de réplication 🖼️](https://safekit.eviden.com/wp-content/uploads/2024/03/26-replication-resources-reintegration.png) du nœud 2. Utilisez l’IA SafeKit 🤖 pour obtenir de l’aide concernant les messages du journal.
### 12. Vérifiez que le cluster est opérationnel {#12-verify-that-the-cluster-is-operational}
* Vérifiez que le cluster est vert/vert, que les services MySQL s’exécutent sur le nœud PRIM et qu’ils ne s’exécutent pas sur le nœud SECOND.
Dans cet état, seules les modifications apportées aux fichiers sont répliquées en temps réel.
⚠️ Les composants qui sont des clients des services MySQL doivent être configurés avec l’adresse IP virtuelle. La configuration peut être effectuée avec un nom DNS (si un nom DNS a été créé et associé à l’adresse IP virtuelle).
### 13. Tests {#13-testing}
* Arrêtez le nœud PRIM en faisant défiler son menu contextuel vers le bas et en cliquant sur `Stop`.
* Vérifiez qu’il y a un basculement sur le SECOND nœud qui devrait devenir ALONE (vert).
* Et avec la console d’administration Microsoft (MMC) sous Windows ou avec des lignes de commande sur Linux, vérifiez le basculement des services MySQL (arrêtés sur le nœud 1 dans le script `stop_prim` et démarrés sur le nœud 2 dans le script `start_prim`).
⚠️ Si ALONE (vert) n’est pas atteint sur node2 ou si l’application n’est pas démarrée, analysez la raison avec le [journal du module 🖼️](https://safekit.eviden.com/wp-content/uploads/2024/03/38-module-log-script-second.png) du nœud 2.
* Cliquez sur l’icône **de journal** 🔍 du `node2` pour ouvrir le journal du module et recherchez les messages d’erreur, tels qu’un vérificateur détectant une erreur et arrêtant le module.
* Cliquez sur `start_prim` dans le journal : les messages de sortie du script sont affichés à droite et les erreurs peuvent être détectées, comme un service mal démarré.
* Utilisez l’IA SafeKit 🤖 pour obtenir de l’aide concernant les messages du journal.
⚠️
* Si tout est correct, lancez une synchronisation sur node1, ce qui resynchronisera les répertoires répliqués à partir node2.
* Si les choses tournent mal, arrêtez node2 et [forcez le nœud 1 à démarrer en tant que primaire 🖼️](https://safekit.eviden.com/wp-content/uploads/2024/03/10-monitoring-mirror-stop-stop-prim.png), qui redémarrera avec ses données localement saines au moment de l’arrêt.
ℹ️ Retrouvez plus de détails, ainsi que des vidéos, dans la [formation en ligne SafeKit](https://safekit.eviden.com/fr/resources/safekit-on-line-training/).
### 14. Assistance {#14-support}
* Pour obtenir de l’aide, prenez 2 `Snapshots` SafeKit (2 fichiers .zip), un pour chaque nœud.
ℹ️ [Plus d’informations sur l’assistance ici](https://safekit.eviden.com/fr/resources/safekit-support/).
## Démonstration de la solution mirror SafeKit {#demonstration-of-the-safekit-mirror-solution}
### Vidéo SafeKit : Clustering au niveau de l’application (8:47) {#demo-mirror-ha-cluster}
Dans cette vidéo, découvrez comment SafeKit implémente un **cluster HA mirror** sans la complexité d’un SAN. Bien que cette démonstration utilise Microsoft SQL Server, la solution fonctionne de manière identique pour d’autres bases de données et applications.
### Chapitres {#chapters}
1. 🎬 [2 nœuds avec SQL Server](https://www.youtube.com/watch?v=mGwEguDnnH0&t=0s) (0:32)
2. 🎬 [Configurer le cluster et le module mirror.safe](https://www.youtube.com/watch?v=mGwEguDnnH0&t=32s) (3:58)
3. 🎬 [Démarrer et tester la réplication, la migration et le basculement SQL en cas de panne](https://www.youtube.com/watch?v=mGwEguDnnH0&t=270s) (4:17)
### Mise en œuvre étape par étape {#step-by-step-implementation}
* 🛠️ [Lisez le guide sur la configuration d’un cluster mirror sous Windows](https://safekit.eviden.com/fr/quick-install/safekit-quick-installation-guide-for-a-new-windows-application-with-real-time-replication-and-failover/)
* 🛠️ [Lisez le guide sur la configuration d’un cluster mirror sous Linux](https://safekit.eviden.com/fr/quick-install/safekit-quick-installation-guide-for-a-new-linux-application-with-real-time-replication-and-failover/)