> 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/upgrade.md).

# Mise à niveau

Ce qui est établi au sujet de la mise à niveau de la solution, la préparation qui vous incombe avant celle-ci, les pièges propres à certaines versions qui sont consignés, et comment vérifier une mise

{% hint style="warning" %}
**La procédure de mise à niveau doit être validée face aux deux versions concernées : celle installée et celle vers laquelle vous allez.** Aucune séquence unique d'étapes ne s'applique à tous les couples de versions : au moins une release exige un redémarrage, et une plage de releases a supprimé une capacité qu'une release ultérieure a rétablie. Établissez d'abord les deux numéros de version, lisez les notes de version de tout ce qui se trouve entre les deux, et confirmez la procédure auprès du support de mise en œuvre DataDike avant de commencer.
{% endhint %}

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

Cette page couvre ce qui se passe autour d'une mise à niveau : la préparation qui vous revient, les faits propres à certaines versions qui sont consignés, et les contrôles qui vous disent que la mise à niveau a pris.

Elle ne donne pas de séquence de commandes de mise à niveau, car il n'en existe aucune qui puisse être donnée honnêtement.

{% hint style="danger" %}
**Le matériau source de ce wiki ne contient aucune procédure de mise à niveau pas à pas.** Il décrit le *modèle* de mise à niveau et consigne des changements propres à certaines versions, mais ni les commandes, ni l'ordre des opérations, ni le chemin de retour arrière. Ces éléments doivent venir du support de mise en œuvre DataDike ou de votre revendeur, pour votre installation et votre couple de versions précis. N'assemblez pas une procédure à partir de fragments : une mise à niveau lancée depuis une séquence devinée est un événement de perte de données, non un changement raté.
{% endhint %}

## Ce qui est établi au sujet des mises à niveau

| Fait                                                                                                                                                                                                                                                                                              | Conséquence pour vous                                                                                                                                                                                                       |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Dans le modèle SaaS, l'hébergement, l'infrastructure et l'exploitation relèvent de DataDike, et la licence par abonnement inclut des mises à jour de version continues (correctifs et nouvelles fonctions) sans coût supplémentaire pendant la durée du contrat, avec un support éditeur 24x7x365 | Vous n'exécutez pas la mise à niveau. Confirmez la fenêtre et lisez les notes de version                                                                                                                                    |
| Les composants peuvent être mis à jour individuellement, sans arrêter le produit                                                                                                                                                                                                                  | C'est énoncé comme une capacité de l'architecture, non comme une procédure. Cela ne signifie pas qu'une mise à niveau donnée soit non perturbante : ce sont les notes de version qui indiquent si un redémarrage est en jeu |
| Les installations on-premises fonctionnent en actif/actif                                                                                                                                                                                                                                         | Un nœud peut être hors service pendant le changement sans que le service s'arrête, mais uniquement si le changement est réellement appliqué nœud par nœud                                                                   |
| Les correctifs et mises à jour du système d'exploitation sont publiés et signés par DataDike et appliqués de façon contrôlée, avec la compatibilité de la plateforme préservée à chaque mise à jour et un cycle de vie géré qui évite les composants en fin de vie                                | Le système d'exploitation et l'application sont mis à jour par le canal de DataDike, et non depuis les dépôts amont de la distribution                                                                                      |
| La console de l'appliance propose **Reboot** et **Shutdown**                                                                                                                                                                                                                                      | Utilisez ces options plutôt que d'improviser un arrêt de l'appliance                                                                                                                                                        |

## Avant de commencer

Tout ce qui suit relève de votre préparation, quelle que soit la partie qui exécute la mise à niveau.

1. **Notez la version installée et la version cible.** Chaque fait de cette page et des notes de version est conditionné à ces deux numéros. Sans les deux, rien ici ne peut être appliqué.
2. **Lisez les notes de chaque version intermédiaire**, pas seulement celles de la cible. Listez chaque élément qui exige un redémarrage, modifie une valeur par défaut, ou supprime ou rétablit une capacité. Voir [Notes de version](https://wiki.datadike.com/fr/pam/release-notes.md).
3. **Faites une sauvegarde et restaurez-la quelque part.** Une sauvegarde non testée n'est pas un plan de retour arrière. Voir [Sauvegarde et restauration](https://wiki.datadike.com/fr/pam/deploy-operate/backup-and-restore.md).
4. **Confirmez la validité de la licence pour la fenêtre.** Toutes les fonctions restent désactivées tant qu'une licence n'est pas importée, et une licence expirée laisse un délai de grâce de sept jours pour importer la nouvelle. Une fenêtre de mise à niveau est un mauvais moment pour découvrir que la licence a expiré.
5. **Planifiez en dehors du nettoyage nocturne.** Les tâches de maintenance et de nettoyage s'exécutent au petit matin : la source cite 02:00 pour les travaux quotidiens de nettoyage et recommande de tenir les mises à jour système et les redémarrages de worker hors de la plage 02:00-04:00, afin que les tâches automatisées ne soient pas interrompues en pleine exécution.
6. **Convenez de qui exécute le changement** et ouvrez la demande auprès du support en indiquant les deux numéros de version.
7. **Consignez à quoi ressemble un système sain maintenant**, avant le changement, pour que « était-ce déjà comme ça avant ? » ait une réponse ensuite : la réponse actuelle de `/api/health/`, la liste des composants avec tous leurs états, et les deux workers de tâches **En ligne**. Voir [Supervision et santé](https://wiki.datadike.com/fr/pam/deploy-operate/monitoring.md).

## Faits propres à certaines versions, consignés

Ils proviennent des notes de version et justifient l'avertissement en tête de cette page. Ils ne s'appliquent qu'aux versions nommées.

| Version ou plage     | Ce qui change                                                                                                                                                                                                                                              | Ce que cela signifie pour vous                                                                                        |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| 5.0.1                | Impose désormais une communication TLS 1.3 entre la VM Gateway et le serveur                                                                                                                                                                               | La note de version indique qu'un redémarrage est requis                                                               |
| De la 5.0 à la 5.0.9 | La modification d'un actif pour lui donner un nom convivial personnalisé a été supprimée par erreur                                                                                                                                                        | Si vous êtes dans cette plage, la capacité est absente. C'est une régression connue, pas un problème de configuration |
| 5.1.0 (18 août 2026) | La modification du nom convivial est réintroduite. Les environnements qui avaient déjà des renommages individuels ne perdent pas la personnalisation                                                                                                       | Le correctif de la plage ci-dessus                                                                                    |
| Note du 04 mai 2026  | Améliorations de fiabilité et de stabilité du processus de mise à niveau de la VM gateway, avec une interruption réduite entre versions. Le titre de la note dit Broker VM alors que son corps dit Gateway VM : considérez le composant comme non confirmé | Les VM broker et gateway suivent leur propre chemin de mise à niveau, distinct de celui de la plateforme              |

{% hint style="warning" %}
**Une capacité absente après une mise à niveau n'est pas toujours une erreur de configuration.** La régression du nom convivial de la 5.0 à la 5.0.9 est le cas documenté : le réglage avait disparu de la console, et aucun travail sur les permissions ou les politiques ne l'aurait ramené. Avant de chercher la panne d'une fonction absente, vérifiez si les notes de version la consignent comme supprimée.
{% endhint %}

## Étapes

L'exécution appartient au support. Le changement qui l'entoure vous appartient, et il a une forme :

1. Établissez les versions installée et cible.
2. Lisez toutes les notes de version intermédiaires et notez les éléments qui exigent un redémarrage ou modifient le comportement.
3. Sauvegardez, et prouvez la sauvegarde en la restaurant dans une instance de test.
4. Capturez la référence de santé antérieure au changement décrite sous **Avant de commencer**.
5. Ouvrez le changement auprès du support, en indiquant les deux versions et les éléments repérés à l'étape 2.
6. Convenez d'une fenêtre en dehors des heures de nettoyage nocturne.
7. Exécutez la mise à niveau avec le support.
8. Vérifiez, à l'aide des contrôles ci-dessous, avant de déclarer la fenêtre close.

Ne compressez pas les étapes 3 et 4. Ce sont elles qui font la différence entre un retour arrière et un incident.

## Comment vérifier que cela a fonctionné

Une mise à niveau qui rend une page de connexion n'a presque rien prouvé. Progressez depuis les dépendances vers l'extérieur :

1. **`/api/health/`** renvoie `status`, `db_status` et `redis_status` tous vrais. Sur un cluster, interrogez l'adresse virtuelle **et chaque nœud individuellement** : un nœud laissé sur l'ancienne version, ou oublié lors du redémarrage, reste invisible derrière l'adresse virtuelle.
2. **Paramètres système › Composants** affiche chaque composant en **Normal** et aucun **Hors ligne**. Comparez à la référence que vous avez capturée : un composant présent, qui était Normal auparavant et se trouve maintenant en High load, est un constat à traiter.
3. **Le moteur de tâches tourne.** Depuis **Paramètres système › Opérations**, ouvrez **Surveillance** : les deux workers, celui de maintenance et celui d'automatisation, **En ligne**, et les files sans arriéré de messages en attente. Vérifiez ensuite, dans la liste des opérations, que la **date de dernière publication** d'une tâche à cycle court progresse après la mise à niveau. Un worker revenu mais qui ne consomme rien ressemble en tous points à un worker sain tant que ce contrôle n'est pas fait.
4. **Une session réelle par protocole que vous utilisez réellement** (terminal, graphique, base de données), ouverte de bout en bout et non simplement lancée. Confirmez que chacune apparaît dans la piste d'audit et que son enregistrement se rejoue. Les connecteurs de protocole sont des composants distincts ; le fait que l'un d'eux ne revienne pas est le symptôme le plus courant d'une mise à niveau partielle.
5. **Une automatisation aboutit.** Laissez s'exécuter une rotation d'identifiant ou un test de connectivité, et confirmez le succès dans son historique d'exécution. Cela éprouve à la fois le worker d'automatisation et les actifs.
6. **Connectez-vous via votre fournisseur d'identité, avec MFA.** Le fonctionnement de la connexion locale prouve moins qu'il n'y paraît.
7. **Confirmez la date et l'heure du serveur.** Si l'horloge est fausse, les codes OTP sont rejetés et la connexion avec MFA échoue : la source désigne une date et une heure serveur incorrectes comme cause de l'erreur d'OTP invalide. Un redémarrage pendant une mise à niveau est précisément le moment où une horloge dérive.
8. **Ouvrez la console par son nom HTTPS** et confirmez que le certificat est toujours servi correctement. Voir [Certificats et HTTPS](https://wiki.datadike.com/fr/pam/deploy-operate/certificates.md).

## Erreurs fréquentes

| Symptôme                                                                            | Cause                                                                                                                                                                      | Correction                                                                                                 |
| ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| Une capacité qui fonctionnait auparavant a disparu                                  | Régression connue dans la version vers laquelle vous êtes passé. Le cas documenté est celui des noms conviviaux personnalisés d'actifs, supprimés entre la 5.0 et la 5.0.9 | Consultez les notes de version de la plage avant de chercher la panne. Pour ce cas, la 5.1.0 la rétablit   |
| Codes MFA ou OTP rejetés juste après la mise à niveau                               | Date et heure du serveur incorrectes après le redémarrage                                                                                                                  | Corrigez l'horloge du serveur ; la source documente cela comme cause de l'erreur d'OTP invalide            |
| Un nœud du cluster se comporte différemment des autres                              | Tous les nœuds n'ont pas été mis à jour ou redémarrés                                                                                                                      | Interrogez `/api/health/` sur chaque nœud en plus de l'adresse virtuelle, et comparez                      |
| Toutes les tâches automatiques se sont arrêtées après la mise à niveau              | Un worker de tâches n'est pas revenu                                                                                                                                       | **Opérations › Surveillance**, onglet des workers ; le service de tâches de ce serveur doit être redémarré |
| Un réglage modifié dans le fichier de configuration de l'appliance reste sans effet | La configuration contenue dans le `config.txt` de l'appliance est lue au démarrage du service                                                                              | Les services doivent être redémarrés après la modification du fichier                                      |
| Les connexions gateway échouent après le passage en 5.0.1                           | Cette release impose TLS 1.3 entre la VM Gateway et le serveur, et indique qu'un redémarrage est requis                                                                    | Redémarrez comme l'exige la note de version ; confirmez que le côté gateway prend en charge TLS 1.3        |
| Les sessions s'ouvrent mais rien n'est enregistré                                   | Le composant d'enregistrement ou de traitement vidéo est hors ligne, ou le backend de stockage est injoignable                                                             | Contrôlez **Composants**, ainsi que la notification **Stockage : Connectivité**                            |

## Pages associées

* [Notes de version](https://wiki.datadike.com/fr/pam/release-notes.md)
* [Sauvegarde et restauration](https://wiki.datadike.com/fr/pam/deploy-operate/backup-and-restore.md)
* [Supervision et santé](https://wiki.datadike.com/fr/pam/deploy-operate/monitoring.md)
* [Certificats et HTTPS](https://wiki.datadike.com/fr/pam/deploy-operate/certificates.md)
