ADAM Manager 6.6 : zoom sur le suivi des migrations

Avec la version 2026.2 d’ADAM Manager (Manager 6.6), une nouvelle fonctionnalité permet de suivre l’exécution des migrations nécessaires lors des montées de version.

L’objectif : permettre aux administrateurs d’identifier immédiatement les migrations restant à effectuer et éviter que leur absence ne soit découverte tardivement.

Pourquoi mettre en place un suivi des migrations ?

Au cours du cycle de vie d’ADAM Manager, certaines montées de version nécessitent l’exécution manuelle de scripts de migration par les équipes DSI.

Les migrations à réaliser sont indiquées dans la documentation, au sein du changelog de chaque version. Jusqu’à présent, ADAM Manager ne disposait cependant d’aucun mécanisme permettant de vérifier directement si ces migrations avaient bien été appliquées.

Une migration manquante pouvait ainsi n’être détectée qu’ultérieurement, rendant le diagnostic et la résolution du problème plus complexes.

La version 2026.2 introduit donc un nouveau mécanisme de contrôle.

Un contrôle automatique des migrations à effectuer

ADAM Manager trace désormais l’exécution des Web Services de migration.

Lorsqu’une migration reste à effectuer, un bandeau rouge apparaît directement sur la page d’accueil des administrateurs afin de les en informer.

Un bandeau d'alerte informe l'administrateur lorsqu'une ou plusieurs migrations restent à exécuter.

Cette alerte permet ainsi d’identifier la situation dès l’accès à ADAM Manager, sans attendre l’apparition d’un éventuel dysfonctionnement.

Consulter les migrations en attente

Depuis le bandeau d’alerte, l’administrateur peut cliquer sur « View pending migrations » pour afficher une nouvelle fenêtre recensant les migrations restant à exécuter.

Celles-ci sont présentées dans leur ordre d’application, des versions les plus anciennes aux plus récentes.

La fenêtre « Pending migrations » permet d'identifier les migrations restant à appliquer et leur ordre d'exécution.

Depuis cette fenêtre, l’administrateur bénéficie également d’un accès direct à l’Help API. Une fois l’ensemble des migrations appliquées, l’application est automatiquement rechargée.

Que se passe-t-il pour les autres utilisateurs ?

Afin d’éviter l’utilisation d’ADAM Manager dans un état où les migrations requises n’auraient pas encore été réalisées, les utilisateurs standard ne peuvent plus accéder à l’application tant que les migrations nécessaires n’ont pas été exécutées.

L'accès des utilisateurs standard à ADAM Manager est temporairement bloqué lorsqu'une migration reste à effectuer.

Une fois les migrations réalisées, l’application peut de nouveau être utilisée normalement.

De nouveaux Web Services pour faciliter le diagnostic

La version 2026.2 introduit également de nouveaux Web Services dans la catégorie « Maintainer ».

Ils sont notamment destinés à faciliter l’analyse par le Support 4D CONCEPT lorsqu’un problème survient pendant une migration ou au cours du processus d’exécution.

Deux nouveaux Web Services sont disponibles :

GET /ws/v1/migrations/history

Ce Web Service permet de consulter l’historique des migrations exécutées ainsi que leur état d’exécution. Des paramètres permettent de filtrer les résultats selon la version cible, une migration particulière ou un statut.

GET /ws/v1/migrations/health

Ce Web Service permet d’obtenir un état des lieux des migrations exécutées, organisées par version, ainsi que leur dernier statut.

Ces informations peuvent être particulièrement utiles pour accompagner le diagnostic en cas de problème lors d’une montée de version.

Et demain ?

Cette nouvelle fonctionnalité constitue une première étape dans l’amélioration de la gestion des migrations d’ADAM Manager.

À terme, l’objectif envisagé est d’aller vers une exécution automatique des migrations, associée à une interface de monitoring permettant de suivre leur progression en temps réel et de limiter davantage les interventions manuelles des équipes DSI.

À retenir

Avec le nouveau suivi des migrations, ADAM Manager 6.6 permet aux administrateurs d’identifier immédiatement les migrations restant à effectuer lors d’une montée de version.

Le bandeau d’alerte, la liste des migrations en attente, le blocage temporaire de l’accès des utilisateurs standard et les nouveaux Web Services de diagnostic permettent de mieux sécuriser et suivre le processus de migration.

En cas de difficulté lors de l’exécution d’une migration, contactez le Support 4D CONCEPT.