> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/fr/pam/deploy-operate/install-cluster.md).

# Installer un cluster à haute disponibilité

Ce dont se compose un déploiement à haute disponibilité, en quoi il diffère d'un nœud unique, les décisions à trancher avant le montage, et comment prouver que le cluster tolère réellement la perte d'

{% hint style="warning" %}
**Validez cette procédure face à la version que vous déployez.** La procédure d'installation change d'une version à l'autre, et les sources à partir desquelles cette page est construite n'indiquent pas pour quelle version elles ont été écrites.

**Le montage pas à pas du cluster est maintenu par DataDike et n'est pas documenté ici.** Le provisionnement des nœuds, la réplication de la base de données et de Redis, le stockage partagé des enregistrements et la configuration de l'adresse virtuelle dépendent tous de la version et se réalisent avec l'équipe de mise en œuvre. Ce qui suit décrit ce dont un cluster se compose, ce que vous devez décider avant le montage et comment vérifier le résultat. Ce n'est pas une procédure à suivre sans accompagnement.
{% endhint %}

## De quoi il s'agit et quand l'utiliser

Un cluster, ce sont plusieurs nœuds derrière une adresse virtuelle, avec les données répliquées entre eux, de sorte que la perte d'un nœud n'emporte pas l'accès à privilèges avec elle. Choisissez-le lorsqu'une indisponibilité de la plateforme signifie l'indisponibilité de votre capacité à administrer tout le reste.

Tout ce qui figure dans [Installer un nœud unique](https://wiki.datadike.com/fr/pam/deploy-operate/install-single-node.md) reste valable : licence, DNS, certificat, sources d'authentification, rétention. Cette page ne couvre que ce qui change.

## En quoi un cluster diffère d'un nœud unique

|                              | Nœud unique                                        | Cluster                                                                                                                                         |
| ---------------------------- | -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| Point d'entrée client        | L'adresse du nœud lui-même                         | Une **adresse virtuelle unique** (keepalived). Pointez les utilisateurs, le DNS et les intégrations sur l'adresse virtuelle, jamais sur un nœud |
| Adresses des nœuds           | L'adresse unique                                   | Chaque nœud répond aussi directement sur sa propre adresse, ce qui rend la supervision par nœud possible                                        |
| Données                      | Locales au nœud                                    | Répliquées entre les nœuds                                                                                                                      |
| Charge de sessions           | Sur le nœud                                        | Répartie entre les nœuds, et redistribuée quand l'un d'eux est perdu                                                                            |
| Stockage des enregistrements | Le disque local est la valeur installée par défaut | Le disque local laisse chaque enregistrement sur le nœud qui l'a produit. Le stockage objet externe est de fait obligatoire                     |
| Composants                   | S'enregistrent une fois                            | Les composants de chaque nœud s'enregistrent eux-mêmes et apparaissent dans la console avec l'adresse de ce nœud                                |

Trois topologies sont proposées : **actif-actif**, **actif-passif**, et un cluster de **réplique de PRA**. La documentation de disponibilité énonce des objectifs de conception de **RTO ≤ 1 heure** et **RPO ≤ 15 minutes** pour l'architecture actif/actif, ainsi que la redondance des composants de coffre-fort, d'intermédiation des sessions et de console d'administration, afin qu'aucun d'eux ne constitue un point de défaillance unique.

## Avant de commencer

* **Dimensionnement par nœud.** Les chiffres publiés couvrent une instance ; voir [Prérequis système](https://wiki.datadike.com/fr/pam/deploy-operate/requirements.md). Confirmez auprès de DataDike si chaque nœud porte la même spécification et ce dont la couche de stockage partagé a besoin.
* **L'adresse virtuelle** et le nom DNS qui pointe dessus. Le nom qu'utilisent vos utilisateurs et vos intégrations doit se résoudre vers l'adresse virtuelle, pas vers un nœud.
* **Un stockage objet externe pour les enregistrements**, configuré comme backend par défaut dès le premier jour. L'ajouter après coup laisse des enregistrements échoués sur des nœuds isolés.
* **Les règles de pare-feu**, y compris les ports utilisés entre les nœuds pour la réplication. Obtenez-les auprès de DataDike avant de placer les nœuds dans des segments différents. Voir [Prérequis réseau et connectivité](https://wiki.datadike.com/fr/pam/deploy-operate/network-requirements.md).
* **Les licences supplémentaires** que la documentation de disponibilité dit nécessaires à la haute disponibilité on-premises « selon le dimensionnement ». Elle cite en exemple les licences de base de données et de Windows RDS ainsi que les licences HA, sans liste définitive. Réglez la question sur le plan commercial avant le montage.

## Comment le cluster se compose

La plateforme est un ensemble de microservices qui **s'enregistrent eux-mêmes** auprès du core une fois installés et configurés, et c'est ainsi qu'un cluster s'assemble : les connecteurs terminal, graphique, base de données et applications virtuelles de chaque nœud, son service de tâches et ses services d'enregistrement apparaissent dans la console comme des composants enregistrés distincts, chacun affichant l'adresse du nœud sur lequel il tourne.

{% hint style="warning" %}
L'enregistrement est activé par défaut et, tant qu'il l'est, **tout composant connaissant l'adresse de la plateforme peut s'enregistrer de lui-même**. Dès que les composants de tous les nœuds sont présents, décochez **Registration** dans **Paramètres système › Composants › Basique**, et ne le réactivez que le temps d'ajouter un nœud ou un connecteur.
{% endhint %}

L'accès inverse par un [broker](https://wiki.datadike.com/fr/pam/administration/connectivity/broker.md) est redondant par conception : le composant qui appelle le broker s'exécute en **une instance par nœud du cluster**, chacune avec sa propre identité, son enrôlement automatique et sa reprise autonome. Perdre un nœud de la plateforme n'interrompt pas l'accès inverse, et perdre un nœud de broker non plus : les autres continuent de servir.

## Si la plateforme est livrée en SaaS

La modalité hébergée par DataDike est proposée avec un **connecteur local redondant** dans votre environnement, afin que l'accès continue de fonctionner de façon transparente si le lien avec le cloud tombe. La synchronisation entre les composants des deux sites est automatique et en temps réel : si les composants d'un site deviennent indisponibles, l'autre site reprend les services sans perte de données. Les connexions sont **unidirectionnelles**, de votre environnement vers le cloud de DataDike, jamais l'inverse.

## Ce que vous devez observer

L'adresse virtuelle répond, et chaque nœud répond également sur la sienne. **Paramètres système › Composants** liste les composants de chaque nœud, chacun avec sa propre **Adresse distante** et un **Load status** à **Normal**. Un nœud qui ne s'est jamais enregistré se manifeste par une absence dans cette liste, ce qui échappe plus facilement qu'une panne. Comptez les nœuds.

## Comment vérifier que cela a fonctionné

Un cluster dont on n'a jamais provoqué la bascule n'est pas un cluster vérifié.

1. **Interrogez `/api/health/` sur l'adresse virtuelle**, puis sur **chaque nœud directement**. L'endpoint ne demande aucune authentification et renvoie `status`, `db_status`, `db_time`, `redis_status`, `redis_time` et `time` : il prouve donc l'accès de ce nœud à la base de données et à Redis, et pas seulement que nginx a répondu. Laissez les interrogations par nœud en permanence dans votre supervision : un cluster masque un nœud malade unique derrière l'adresse virtuelle, et c'est ce contrôle qui le révèle.
2. **Comptez les composants.** Les connecteurs de chaque nœud présents dans **Paramètres système › Composants**, tous en **Normal**, chacun avec l'**Adresse distante** attendue.
3. **Confirmez que les enregistrements ne sont pas locaux au nœud.** Ouvrez une session sur un nœud, puis rejouez son enregistrement via l'adresse virtuelle jusqu'à tomber sur un autre nœud. Si la lecture dépend du nœud qui répond, les enregistrements sont encore sur disque local.
4. **Faites tomber un nœud volontairement**, dans une fenêtre de maintenance et avec les conseils de DataDike. L'adresse virtuelle doit continuer de répondre, une nouvelle session doit continuer de s'établir, et la piste d'audit doit continuer de la montrer. Remettez ensuite le nœud en service et confirmez qu'il rejoint le cluster : c'est dans la liste des composants que vous le voyez revenir.
5. **Vérifiez ce qu'il est advenu des sessions en cours** pendant ce test. Les sources affirment que l'accès reste disponible et que la charge de sessions est redistribuée ; elles n'affirment pas que les sessions déjà ouvertes survivent à la panne d'un nœud. Mesurez-le dans votre propre déploiement.

## Erreurs fréquentes

| Symptôme                                                                               | Cause                                                                                                                    | Correction                                                                                                                   |
| -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------- |
| La panne d'un nœud laisse parfois les utilisateurs indemnes et les coupe d'autres fois | Les clients, le DNS ou une intégration pointent sur l'adresse propre d'un nœud au lieu de l'adresse virtuelle            | Pointez tout sur l'adresse virtuelle ; réservez les adresses de nœud à la supervision et à l'administration                  |
| Un enregistrement se lit parfois et renvoie 404 d'autres fois                          | Les enregistrements sont sur le backend local **Serveur** : chaque fichier n'existe donc que sur le nœud qui l'a produit | Configurez un stockage objet externe et faites-en le backend par défaut                                                      |
| Un nœud est en service mais ses sessions échouent                                      | L'un des connecteurs de ce nœud est **Hors ligne** alors que l'adresse virtuelle continue de lui envoyer du trafic       | Contrôlez la liste des composants nœud par nœud, et supervisez `/api/health/` par nœud plutôt que la seule adresse virtuelle |
| Un composant inattendu apparaît dans la liste                                          | L'enregistrement a été laissé activé après le montage                                                                    | Décochez **Registration**, et vérifiez ce qui s'est enregistré tout seul et depuis quelle adresse                            |
| Les mots de passe à usage unique échouent sur un seul nœud                             | L'horloge de ce nœud a dérivé ; le TOTP est validé à la seconde                                                          | Synchronisez l'horloge sur chaque nœud, pas seulement sur celui que vous avez monté en premier                               |

## Pages associées

* [Installer un nœud unique](https://wiki.datadike.com/fr/pam/deploy-operate/install-single-node.md)
* [Prérequis système](https://wiki.datadike.com/fr/pam/deploy-operate/requirements.md)
* [Prérequis réseau et connectivité](https://wiki.datadike.com/fr/pam/deploy-operate/network-requirements.md)
* [Broker](https://wiki.datadike.com/fr/pam/administration/connectivity/broker.md)
* [Gateways](https://wiki.datadike.com/fr/pam/administration/connectivity/gateways.md)
