Versions d'agent minimales par fonction

Ce que dit cette page

BaaStide refuse un agent trop ancien. Il y a deux minimums :

• Le minimum de la plateforme. Sous ce numéro, l'agent est bloqué. La plateforme refuse chaque ordre, sauf la mise à jour automatique de l'agent. Aucune sauvegarde et aucune restauration n'a lieu sur cette machine.
• Le minimum d'une fonction, par système. L'agent travaille, mais cette fonction est refusée tant que la version est plus ancienne.

Cette page donne les deux minimums. Elle donne aussi la manière de repérer un agent bloqué.

Prérequis

• Le rôle read pour lire la version d'un agent dans le portail ou par l'API. Voir Rôles et droits.
• Un agent enrôlé. La plateforme connaît la version d'un agent après sa première connexion. Avant cette connexion, la version est inconnue.

Minimum de la plateforme

Minimum de la plateforme	Version
Toute fonction de l'agent, Linux et Windows	0.6.1

Sous la version 0.6.1 :

• la plateforme n'envoie plus d'ordre de sauvegarde ni de restauration ;
• l'API répond 409 avec le code agent_too_old. La réponse donne la version de l'agent, la version minimale et l'adresse de la procédure de mise à jour à la main ;
• la mise à jour automatique de l'agent reste possible. C'est la seule manière de débloquer la machine sans intervention sur place.

L'administrateur de votre plateforme peut relever ce minimum. Lisez la valeur affichée par le portail sur la fiche de la machine, et non le numéro de cette page, quand les deux diffèrent.

Minimum par fonction

Les versions ci-dessous sont les premières versions de l'agent qui exécutent la fonction, par système.

Fonction	Agent Linux	Agent Windows
Restaurer des fichiers depuis le portail	0.6.1	0.6.1
Parcourir les dossiers de la machine depuis le portail	0.4.0	0.4.0
Sauvegarder un partage réseau et tester un partage	0.5.0	0.5.0
Restaurer vers un partage réseau	0.5.0	0.5.0
Sauvegarder et restaurer des bases SQL Server	non disponible	0.8.0-rc.1

Lisez ce tableau avec le minimum de la plateforme. Le minimum de la plateforme passe d'abord : un agent 0.4.0 ou 0.5.0 est bloqué, donc toute machine qui travaille exécute au moins la version 0.6.1.

Quand une fonction porte la mention « non disponible » pour un système, l'agent de ce système ne l'exécute pas, quelle que soit sa version.

Fonctions sans numéro de version

Certaines fonctions ne dépendent pas d'un numéro de version. À chaque connexion, l'agent déclare à la plateforme ce qu'il sait exécuter sur cette machine. La plateforme n'envoie l'ordre que si l'agent l'a déclaré. C'est le cas de :

• l'image complète d'une machine (restauration de la machine entière) ;
• les scripts avant et après une sauvegarde.

Quand l'agent n'a pas déclaré la fonction, la tâche échoue avec la cause agent_unsupported. Mettez l'agent à jour, puis relancez la tâche. Voir Codes de cause d'une tâche.

Un agent déclare une fonction seulement quand la machine la permet. Une version plus récente de l'agent ne suffit donc pas toujours.

Repérer un agent trop ancien

Dans le portail

1. Dans la barre du haut, ouvrez Endpoints.
2. Ouvrez Filtres.
3. Cochez Version trop ancienne seulement.
4. Lisez la liste. Chaque ligne porte l'étiquette Version trop ancienne, puis la version de l'agent et la version minimale.
5. Ouvrez une machine. Le bloc de santé de la fiche donne les deux versions, la raison du blocage et un lien vers la procédure de mise à jour à la main.

Par l'API

1. Appelez GET /endpoints avec le paramètre too_old=true.
2. Lisez la réponse. Chaque endpoint porte agent_version, min_agent_version et agent_version_state.
3. Le champ agent_version_state prend trois valeurs :
   • supported : la version est acceptée ;
   • too_old : la version est sous le minimum de la plateforme, l'agent est bloqué ;
   • unknown : l'agent ne s'est pas encore connecté, sa version n'est pas connue.

Voir la référence de l'API pour le détail de la route.

Débloquer la machine

1. Attendez la mise à jour automatique. Voir Mise à jour automatique de l'agent.
2. Quand la mise à jour automatique échoue plusieurs fois, mettez l'agent à jour à la main. Voir Mettre un agent à jour à la main.

Limites et précautions

• Une version de pré-série est plus ancienne que sa version finale. L'agent 0.6.1-rc.2 est donc trop ancien pour un minimum de 0.6.1.
• Un numéro de version que la plateforme ne sait pas lire compte comme trop ancien.
• Une machine qui ne s'est jamais connectée n'est pas marquée trop ancienne. Sa version est inconnue.
• Un média de restauration plus ancien que la version 0.6.1 est refusé avec le code agent_too_old. Téléchargez le média de restauration à jour depuis le portail.
• Ces minimums ne disent rien des systèmes acceptés. Voir Avant d'installer.
• Le minimum de la plateforme monte avec certaines versions du produit. Mettez vos agents à jour avant de mettre la plateforme à jour.

Référence liée

• Codes de cause d'une tâche
• CLI de l'agent : la commande baastide version donne la version installée sur la machine.
• API