diff --git a/HowtoMySQL/Orchestrator.md b/HowtoMySQL/Orchestrator.md
index 8fa90b75..ef09ac70 100644
--- a/HowtoMySQL/Orchestrator.md
+++ b/HowtoMySQL/Orchestrator.md
@@ -195,3 +195,43 @@ Voici la configuration de base pour la détection de panne :
 * Orchestrator récupérera automatiquement les pannes principales intermédiaire pour tous les clusters.
 * Orchestrator récupérera automatiquement les défaillances  pour tous les clusters, les primaire des autres cluster ne récupéreront pas automatiquement. Un humain pourra initier des récupérations.
 * Une fois qu'un cluster a connu une récupération, Orchestrator bloque les récupérations automatiques pendant 3 600 secondes (1 heure). C'est un mécanisme anti-flap.
+
+### Promotion de primaire
+
+A des fins de maintenance ou autre, on peux remplacer un primaire existant par un autre, il s'agit d'une promotion en douceur , cela fait une rotation des rôles, un secondaire existant devient un primaire, l'ancien primaire devient un secondaire.
+
+Voici en détail comment la bascule se passe :
+
+* L'utilisateur ou Orchestrator choisit un réplica existant comme nouveau primaire désigné. 
+* Orchestrator s'assure que le réplica désigné prend le relais avec les autres réplica.
+* Orchestrator transforme le primaire en `read-only`
+* Orchestrator s'assure que votre serveur désigné est rattrapé par la réplication.
+* Orchestrator promeut votre serveur désigné en tant que nouveau primaire.
+* Orchestrator rend le serveur promu accessible en écriture.
+* Orchestrator rétrograde l'ancien primaire et le place comme réplique directe du nouveau primaire.
+    * si possible, Orchestrator définit l'utilisateur/le mot de passe de réplication pour le primaire rétrogradé.
+
+L'opération peut prendre quelques secondes, pendant lesquelles votre application est censée retournée des erreurs, car le primaire est en lecture seule.
+
+On peux faire une bascule soit :
+
+* En ligne de commande :
+
+~~~
+# orchestrator-client -c graceful-master-takeover -alias mycluster -d primaire.à.promouvoir:3306
+~~~
+
+Passe le réplica indiqué a promouvoir en primaire, ne démarre pas la réplication sur le primaire rétrogradé en réplica.
+
+~~~
+# orchestrator-client -c graceful-master-takeover-auto -alias mycluster -d primaire.à.promouvoir:3306
+~~~
+
+Passe le réplica indiqué a promouvoir en primaire, démarre la réplication automatiquement sur le primaire rétrogradé en réplica.
+
+* Via l'API Web :
+   * `/api/graceful-master-takeover/:clusterHint/:designatedHost/:designatedPort` : Passe le réplica indiqué a promouvoir en primaire, ne démarre pas la réplication sur le primaire rétrogradé en réplica.
+   * `/api/graceful-master-takeover/:clusterHint` : Passe le réplica indiqué a promouvoir en primaire, démarre la réplication automatiquement sur le primaire rétrogradé en réplica.
+
+* On peux faire les bascules également depuis l'interface web.
+