Aller au contenu principal

Mettre un agent à jour à la main

Ce que fait cette procédure​

Cette procédure installe sur la machine la version de l'agent publiée par votre serveur BaaStide. Vous relancez le script d'installation, sans jeton d'enrôlement. Le script remplace le programme de l'agent et garde l'identité de la machine. L'endpoint, sa politique et son historique ne changent pas.

Mettez un agent à jour à la main dans ces deux cas :

  • la mise à jour automatique échoue plusieurs fois sur cette machine ;
  • le portail signale la machine Version trop ancienne et vous voulez la débloquer tout de suite.

Voir Mise à jour automatique de l'agent pour la mise à jour pilotée par la plateforme.

Prérequis​

  • Un agent déjà enrôlé sur la machine. Cette procédure ne remplace pas une installation. Voir Installer l'agent sur Linux et Installer l'agent sur Windows.
  • Un accès root sur la machine Linux, ou un compte administrateur local sur la machine Windows.
  • Un accès HTTPS sortant de la machine vers le serveur BaaStide, port 443.
  • L'adresse de votre serveur BaaStide. Prenez-la dans la commande d'installation que le portail affiche. Voir Créer un jeton d'enrôlement.
  • Le rôle read pour lire la fiche de la machine dans le portail. Le rôle operate pour lancer une sauvegarde de contrôle. Voir Rôles et droits.
  • Aucun jeton d'enrôlement : l'agent garde son identité.

Ne relancez pas la commande complète du portail. Elle porte un jeton d'enrôlement, et ce jeton ne sert qu'une fois.

Mettre à jour un agent Linux​

  1. Ouvrez une session sur la machine.

  2. Devenez root. Par exemple, lancez sudo -i.

  3. Lancez le script d'installation sans le jeton d'enrôlement :

    curl -fsSL 'https://<serveur>/install.sh' | sh -s -- --server 'https://<serveur>'

    Remplacez https://<serveur> par l'adresse de votre serveur BaaStide, aux deux endroits.

  4. Attendez la fin de la commande. Elle écrit une ligne par étape.

  5. Lisez la sortie. Elle doit porter cette ligne :

    install: /etc/baastide/agent.conf exists, keeping the current identity

    Cette ligne dit que le script a gardé l'identité de la machine.

  6. Lisez la dernière ligne. Elle a cette forme :

    install: agent baastide <version> installed and started (systemctl status baastide)

  7. Vérifiez la version installée :

    baastide version

    La première ligne a la forme baastide agent <version>. Elle doit donner la nouvelle version.

  8. Vérifiez que le service tourne :

    systemctl is-active baastide

    La réponse doit être active.

Le script télécharge l'agent et le manifeste de la version, puis il vérifie la taille et l'empreinte SHA-256 du fichier téléchargé. Un fichier abîmé arrête la commande. Le script remet aussi le garde de démarrage et l'unité systemd d'origine.

Mettre à jour un agent Windows​

  1. Ouvrez une session sur la machine, avec un compte administrateur local.

  2. Ouvrez PowerShell avec Exécuter en tant qu'administrateur. Prenez Windows PowerShell 5.1 ou PowerShell 7, en 64 bits.

  3. Lancez le script d'installation sans le jeton d'enrôlement :

    & ([scriptblock]::Create((Invoke-RestMethod 'https://<serveur>/install.ps1'))) -Server 'https://<serveur>'

    Remplacez https://<serveur> par l'adresse de votre serveur BaaStide, aux deux endroits.

  4. Attendez la fin de la commande. Elle écrit une ligne par étape.

  5. Lisez la sortie. Elle doit porter cette ligne :

    install: C:\ProgramData\BaaStide\agent.conf exists, keeping the current identity

  6. Lisez la dernière ligne. Elle dit installed and started, puis elle donne le chemin du journal.

  7. Vérifiez la version installée :

    & "$env:ProgramFiles\BaaStide\baastide.exe" version

    La première ligne a la forme baastide agent <version>. Elle doit donner la nouvelle version.

  8. Vérifiez que le service tourne :

    Get-Service BaaStide

    L'état doit être Running.

Le script vérifie la taille, l'empreinte SHA-256 et la signature Authenticode de l'agent téléchargé. Une signature absente, ou d'un autre éditeur, arrête la commande. Le script enregistre de nouveau le service BaaStide et l'entrée de Applications installées.

Quand une étape échoue après l'arrêt du service, le script essaie de redémarrer le service avant de s'arrêter.

Vérifier le résultat dans le portail​

  1. Ouvrez le portail.
  2. Ouvrez la page Endpoints.
  3. Cliquez sur le nom de la machine.
  4. Lisez son état. Il doit être En ligne. L'agent se reconnecte quelques secondes après la mise à jour.
  5. Lisez le champ Version du bloc de détails. Il doit donner la nouvelle version.
  6. Vérifiez que l'étiquette Version trop ancienne n'est plus affichée.
  7. Cliquez sur Sauvegarder maintenant, puis ouvrez l'onglet Activité. La tâche doit démarrer. Cette étape demande le rôle operate et une politique de sauvegarde sur la machine.

Les sauvegardes planifiées repartent à leur prochaine heure prévue.

Une machine qui reste Hors ligne après la mise à jour a un problème de connexion ou de démarrage. Lisez le journal de l'agent :

  • Linux : journalctl -u baastide -n 50.
  • Windows : Get-Content "$env:ProgramData\BaaStide\log\agent.log" -Tail 50.

Limites et précautions​

  • Le service de l'agent s'arrête quelques secondes. Une tâche en cours s'arrête aussi, et elle finit Interrompue. Lancez cette procédure hors des heures de sauvegarde de la machine.
  • Le script installe la version publiée par votre serveur BaaStide. Il n'installe pas une version plus récente que celle de votre serveur.
  • Ne lancez pas cette procédure pendant une mise à jour automatique de la même machine. Ouvrez d'abord l'onglet Activité de la machine, et vérifiez qu'aucune tâche Mise à jour de l'agent n'est en cours.
  • Après une mise à jour à la main, la plateforme envoie une mise à jour automatique dès que la version installée n'est pas la version qu'elle vise pour cette machine.
  • L'option --version sous Linux, et l'option -Version sous Windows, installent une version précise. Le serveur doit publier cette version, sinon la commande s'arrête. N'utilisez cette option que sur demande du support.
  • Quand la commande s'arrête avec install: BAASTIDE_ENROLL_TOKEN is not set, la machine n'a pas d'identité d'agent. Installez l'agent avec un jeton d'enrôlement. Voir Installer l'agent sur Linux et Installer l'agent sur Windows.
  • Ne remplacez jamais le programme de l'agent par une copie de fichier. Le garde de démarrage et le retour à la version précédente ont besoin des fichiers posés par le script.
  • Ne modifiez pas l'unité systemd baastide.service, ni le service Windows BaaStide. Le script remet les réglages d'origine.
  • Quand votre MSP a changé les noms de l'agent, l'adresse du script, les noms du programme, du service et des dossiers suivent le profil de votre MSP. Prenez toujours l'adresse du script dans la commande que le portail affiche.
  • Sur une instance installée chez vous, le serveur publie les versions d'agent livrées avec sa propre version. Mettez l'instance à jour pour obtenir une version d'agent plus récente.

Référence​