Agent trop ancien

Ce que veut dire « version trop ancienne »

La plateforme a une version minimale d'agent. Un agent qui a annoncé une version plus ancienne à sa dernière connexion est bloqué : la plateforme ne lui envoie plus aucun ordre, sauf la mise à jour automatique. La machine ne peut donc plus être sauvegardée ni restaurée tant que son agent n'est pas mis à jour.

BaaStide ne garantit pas qu'un agent plus ancien sauvegarde et restaure correctement. Le blocage évite une sauvegarde sur laquelle vous ne pourriez pas compter.

La version minimale actuelle est 0.6.1. Elle monte avec une version de la plateforme, jamais depuis le portail. Lisez toujours la valeur en vigueur dans le portail : chaque machine affiche sa version et la version minimale.

Prérequis

• Le rôle read pour lire l'état d'une machine et filtrer la liste des endpoints. Voir Rôles et droits.
• Le rôle operate pour relancer une sauvegarde après la mise à jour.
• Un accès root sur la machine Linux, ou un compte administrateur local sur la machine Windows, pour une mise à jour à la main.

Les trois états de version

Le portail et l'API donnent un état de version par machine.

État	Ce qu'il veut dire
supported	La version annoncée est égale ou plus récente que la version minimale. Le portail n'affiche aucun badge de version. Rien à faire.
too_old	La version annoncée est plus ancienne que la version minimale. La machine est bloquée. Le portail affiche le badge Version trop ancienne.
unknown	La machine ne s'est jamais connectée. Elle n'a donc annoncé aucune version. Elle n'est pas bloquée.

Une version de pré-publication est plus ancienne que sa version finale. Par exemple, 0.6.1-rc.2 est trop ancienne pour une version minimale de 0.6.1. Une version que la plateforme n'arrive pas à lire compte aussi comme trop ancienne.

Repérer les agents bloqués

1. Ouvrez le portail.
2. Ouvrez la page Endpoints.
3. Cliquez sur Filtres.
4. Cochez la case Version trop ancienne seulement. Le filtre s'applique tout de suite.
5. Fermez le panneau des filtres.
6. Lisez la liste. Elle ne garde que les machines bloquées.

Le filtre actif apparaît comme une étiquette Version trop ancienne au-dessus de la liste. Cliquez sur cette étiquette pour retirer le filtre.

La colonne Statut de chaque ligne porte alors deux badges : le statut de l'agent, et le badge rouge Version trop ancienne. Sous les badges, une ligne donne les deux versions : Agent <version>, minimum <minimum> : sauvegarde et restauration bloquées.

Le bouton Exporter en CSV de la page garde ce filtre. Vous obtenez donc la liste des machines bloquées dans un fichier.

Lire l'état d'une machine

1. Ouvrez la page Endpoints.
2. Cliquez sur le nom de la machine.
3. Lisez les badges sous le nom de la machine. Le badge Version trop ancienne signale le blocage.
4. Lisez le premier bloc de la page. Il donne le problème en clair : la version de l'agent, la version minimale, et la raison du blocage.
5. Suivez le lien Mettre à jour l'agent à la main (Linux et Windows) de ce bloc. Il ouvre la procédure publique dans un nouvel onglet.

L'onglet Paramètres de la machine donne aussi la version de l'agent, dans le champ Version.

Ce que la plateforme refuse

Un agent bloqué ne reçoit plus que la mise à jour automatique. Toutes les autres actions sont refusées, avant même d'être envoyées à la machine.

Action	Ce que vous voyez
Sauvegarder maintenant	Le bouton est gris. Sous le bouton : « La version de l'agent est trop ancienne. Mettez d'abord l'agent à jour. »
Restaurer des fichiers	Le bouton est gris, avec la même raison.
Sauvegarde planifiée	La tâche finit Échouée, avec la cause agent_too_old.
Restauration vers cette machine	Le portail refuse la cible : « L'agent de <machine> est trop ancien pour la restauration depuis le portail. »
Parcourir la machine pour choisir des dossiers	L'action est refusée : « La version de l'agent est trop ancienne pour cette action. Mettez l'agent à jour. »
Restauration d'une VM vers un hôte	L'hôte n'est pas proposé. La liste des hôtes donne la raison « agent trop ancien ».
Sauvegarde d'une VM ou d'un conteneur	L'ordre n'est pas envoyé. La tâche finit Échouée.
Sauvegarde ou restauration SQL Server	L'action est refusée.
Sauvegarde d'une sélection d'endpoints	La machine est ignorée. Le résultat dit « Ignorées : <nombre> avec un agent trop ancien ».
Clé API ou assistant IA	L'appel reçoit l'erreur agent_too_old, avec la version de l'agent, la version minimale et l'adresse de la procédure de mise à jour.

Une restauration lancée depuis la machine est refusée elle aussi. La commande écrit alors que la version de l'agent est trop ancienne pour la plateforme, et elle donne l'adresse de la procédure de mise à jour. Ce refus est le seul signal que la plateforme envoie à un agent bloqué.

Ce que la plateforme continue de faire

• Elle envoie la mise à jour automatique. C'est le seul ordre qu'un agent bloqué reçoit. Voir Mise à jour automatique de l'agent.
• Elle garde les données déjà sauvegardées. Rien n'est supprimé.
• Elle garde les politiques, les tags et l'historique de la machine.
• Elle ouvre une alerte pour cette machine, et elle la ferme après la mise à jour.

L'alerte « Version de l'agent trop ancienne »

La plateforme ouvre l'alerte dès qu'un agent passe sous la version minimale. Cette alerte est toujours active : aucune règle ne la coupe.

L'alerte part dans le résumé par email des alertes du MSP, sous le titre « Version de l'agent trop ancienne : agent bloqué, pas de sauvegarde ». Le résumé va aux utilisateurs qui gardent les emails d'alerte activés dans Mon compte.

L'alerte se ferme d'elle-même quand l'agent annonce une version prise en charge.

Une machine dont l'accès est révoqué ne reçoit pas cette alerte. Voir Rattacher un agent.

Débloquer une machine

Deux chemins mènent au déblocage. Le premier ne demande rien.

Attendre la mise à jour automatique

1. Vérifiez que la machine est en ligne. Un agent hors ligne ne reçoit pas de mise à jour.
2. Ouvrez l'onglet Activité de la machine.
3. Cherchez une tâche Mise à jour de l'agent dans la carte Tâches.
4. Attendez la fin de la tâche. Le détail de chaque étape est dans Mise à jour automatique de l'agent.
5. Rechargez la fiche de la machine. Le badge Version trop ancienne disparaît.

Mettre l'agent à jour à la main

Prenez ce chemin quand la machine reste bloquée, ou quand la mise à jour automatique échoue plusieurs fois.

1. Suivez Mettre un agent à jour à la main, pour Linux ou pour Windows.
2. Attendez que l'agent se reconnecte. Il annonce alors sa nouvelle version.
3. Rechargez la fiche de la machine. Le badge Version trop ancienne disparaît.
4. Lancez Sauvegarder maintenant pour contrôler que la machine sauvegarde de nouveau.

L'état de version suit la dernière connexion de l'agent. Une machine hors ligne garde donc son ancien état jusqu'à sa prochaine connexion.

Une version trop ancienne pour une seule fonction

Le même message peut apparaître sur une machine qui n'est pas bloquée. Certaines fonctions demandent une version d'agent plus récente que la version minimale de la plateforme.

Fonction	Première version d'agent qui la connaît
Parcourir la machine pour choisir les dossiers	0.4.0
Sauvegarder un partage réseau	0.5.0
Restaurer vers un partage réseau	0.5.0
Restaurer depuis le portail	0.6.1
Sauvegarder et restaurer SQL Server (Windows)	0.8.0-rc.1, donc toute version 0.8.0 ou plus récente

Dans ce cas, le portail écrit « La version de l'agent est trop ancienne pour cette action. Mettez l'agent à jour. » La machine garde ses sauvegardes planifiées et ses restaurations : seule cette fonction est refusée. La mise à jour de l'agent suffit à l'ouvrir.

Le formulaire d'une politique a son propre message pour le choix des dossiers : « Agent trop ancien. Cet agent ne sait pas lister les dossiers. Mettez-le à jour, ou tapez les chemins. »

Limites et précautions

• Vous ne pouvez pas déclarer une exception pour une machine. La version minimale vaut pour toute la plateforme.
• La version minimale ne se change pas depuis le portail. Elle est un réglage du serveur, choisi avec une version de la plateforme.
• Vous ne pouvez pas forcer une mise à jour depuis le portail, ni depuis une clé API, ni depuis un assistant IA. Attendez la mise à jour automatique, ou mettez l'agent à jour à la main.
• Avec le filtre Version trop ancienne seulement, la page Endpoints n'offre pas la sélection de toute la liste. Cochez les lignes dont vous avez besoin.
• Une machine qui ne s'est jamais connectée n'est pas bloquée, mais elle n'est pas sauvegardée non plus. Vérifiez d'abord son réseau et son service.
• La fiche d'une tâche échouée pour cette raison affiche le code agent_too_old, sans phrase d'explication. La cause est la version de l'agent, pas la machine.
• Le média de récupération bare metal suit la même règle. Un média plus ancien que l'agent 0.6.1 est refusé. Téléchargez l'ISO de récupération à jour.
• Sur une instance installée chez vous, le serveur sert les versions d'agent livrées avec sa propre version. Mettez l'instance à jour avant les agents.

Référence

• API : Endpoints, champs agent_version, min_agent_version et agent_version_state de GET /endpoints, et filtre too_old.
• Outils MCP : Lire, filtre too_old_only de list_endpoints.
• CLI de l'agent : baastide version.