Désinstaller l'agent

Ce que fait la désinstallation

La désinstallation retire l'agent de la machine : le service, le programme, l'identité, l'état de mise à jour, le cache et les journaux de l'agent. La machine ne sauvegarde plus et ne restaure plus.

La désinstallation ne touche pas au portail. L'endpoint reste dans la liste du client, hors ligne, jusqu'à sa suppression dans le portail. Les sauvegardes déjà faites restent dans le dépôt de l'endpoint.

La désinstallation ne supprime jamais les fichiers restaurés. Elle garde le dossier des restaurations quand il n'est pas vide, et elle le signale.

Une réinstallation sur la même machine ne demande pas de désinstallation. Relancez le script d'installation sans jeton d'enrôlement : il remet les fichiers en place et garde l'identité. Voir « Réinstaller les fichiers de l'agent » dans Installer l'agent sur Linux et Installer l'agent sur Windows.

Prérequis

• Un accès root sur une machine Linux. Un compte administrateur local sur une machine Windows.
• L'adresse du serveur BaaStide, pour la méthode par script. Prenez-la dans la commande d'installation que le portail affiche. Voir Créer un jeton d'enrôlement.
• Un accès HTTPS sortant vers le serveur, port 443, pour la méthode par script.
• Le rôle Technicien ou Administrateur dans le portail, pour supprimer l'endpoint ensuite. Voir Rôles et droits.

Vérifiez qu'aucune sauvegarde et qu'aucune restauration de la machine n'est en cours. L'arrêt du service annule la tâche en cours.

Retirer l'agent d'une machine Linux

1. Ouvrez une session sur la machine.

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

3. Lancez le script d'installation avec l'option de désinstallation :

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

   Prenez l'adresse du script dans la commande d'installation que le portail affiche. Quand votre MSP a changé les noms de l'agent, cette adresse porte le profil de votre MSP : le script ne retire alors que l'agent installé avec ce profil.

4. Lisez la dernière ligne. Elle doit dire install: agent baastide removed. Delete the endpoint in the portal.

5. Supprimez l'endpoint dans le portail. Voir « Supprimer l'endpoint dans le portail » plus bas.

Le script fait, dans cet ordre : il arrête et désactive l'unité baastide.service, il arrête une mise à jour en cours, il retire l'unité et son fichier de réglage, puis il supprime /usr/local/bin/baastide, /usr/lib/baastide, /etc/baastide, /var/cache/baastide et /var/lib/baastide.

Quand /var/lib/baastide/restore contient des fichiers, le script garde ce dossier. Il écrit alors install: /var/lib/baastide/restore is not empty and is kept: move or remove it yourself. Déplacez ces fichiers, puis supprimez le dossier.

Le journal de l'agent reste dans le journal du système. Il part quand le journal tourne.

Retirer l'agent d'une machine Linux sans accès au serveur

Suivez cette procédure quand la machine n'atteint plus le serveur BaaStide.

1. Ouvrez une session sur la machine, en root.

2. Déplacez les fichiers de /var/lib/baastide/restore dont vous avez besoin.

3. Arrêtez et retirez le service :

   systemctl disable --now baastide.service
   systemctl stop 'baastide-update-*'
   rm -f /etc/systemd/system/baastide.service
   rm -f /etc/systemd/system/baastide.service.d/systemd-before-236.conf
   rmdir /etc/systemd/system/baastide.service.d
   systemctl daemon-reload

   La deuxième commande arrête une mise à jour en cours. Une mise à jour tourne hors du service : sans cet arrêt, elle remet le programme en place après l'étape 4.

4. Supprimez les fichiers de l'agent :

   rm -f /usr/local/bin/baastide /usr/local/bin/baastide.new
   rm -rf /usr/lib/baastide /etc/baastide /var/lib/baastide /var/cache/baastide

5. Supprimez l'endpoint dans le portail.

Sur un nœud Proxmox VE, préférez toujours la méthode par script. Elle défait ce qu'une sauvegarde de VM interrompue a laissé sur les VM et sur les conteneurs du nœud.

Retirer l'agent d'une machine Windows

Trois chemins retirent l'agent. Ils font le même travail.

Depuis Applications installées

1. Ouvrez une session sur la machine, avec un compte administrateur local.
2. Ouvrez Paramètres, Applications, Applications installées.
3. Trouvez la ligne BaaStide agent. Son éditeur est BaaStide.
4. Ouvrez le menu de la ligne, puis cliquez sur Désinstaller.
5. Acceptez la demande de droits d'administrateur.
6. Supprimez l'endpoint dans le portail.

Cette entrée n'offre ni Modifier ni Réparer. Pour remettre les fichiers de l'agent en place, relancez le script d'installation.

Quand votre MSP a changé les noms de l'agent, la ligne porte le nom du produit de votre MSP.

Avec la commande de l'agent

1. Ouvrez PowerShell avec Exécuter en tant qu'administrateur.

2. Lancez la commande :

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

3. Lisez la dernière ligne. Elle doit dire BaaStide agent removed. Delete the endpoint in the portal.

4. Supprimez l'endpoint dans le portail.

Cette commande n'a pas besoin du serveur. Elle convient à une machine sans accès sortant. Sans droits d'administrateur, elle les demande.

Avec le script d'installation

1. Ouvrez PowerShell avec Exécuter en tant qu'administrateur.

2. Lancez le script avec l'option de désinstallation :

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

   Prenez l'adresse du script dans la commande d'installation que le portail affiche.

3. Lisez la dernière ligne. Elle doit dire install: agent baastide removed. Delete the endpoint in the portal.

4. Supprimez l'endpoint dans le portail.

Les trois chemins arrêtent et retirent le service BaaStide, retirent l'entrée de Applications installées, puis suppriment %ProgramFiles%\BaaStide et %ProgramData%\BaaStide. Sur un hôte Hyper-V, ils suppriment aussi les points de contrôle que l'agent a créés, et ses fichiers temporaires. Les points de contrôle d'un autre outil restent.

Quand %ProgramData%\BaaStide\restore contient des fichiers, la désinstallation garde ce dossier et le signale. Déplacez ces fichiers, puis supprimez le dossier.

Retirer le service sans retirer les fichiers

Sur Windows, cette commande arrête et retire le service seul. Elle garde le programme, l'identité, les journaux et l'entrée de Applications installées. Elle sert pendant un dépannage, pas pour une désinstallation.

1. Ouvrez PowerShell avec Exécuter en tant qu'administrateur.

2. Lancez la commande :

   & "$env:ProgramFiles\BaaStide\baastide.exe" service uninstall

3. Lisez la réponse. Elle nomme le service retiré et le dossier gardé.

Pour remettre le service en place, lancez & "$env:ProgramFiles\BaaStide\baastide.exe" service install, puis Start-Service BaaStide.

Supprimer l'endpoint dans le portail

La désinstallation laisse l'endpoint dans le portail, hors ligne. Supprimez-le pour fermer le dossier de la machine.

1. Ouvrez la page de l'endpoint dans le portail.
2. Demandez la suppression.
3. Attendez le délai de 72 heures.

La page Supprimer un endpoint ou un client donne la procédure complète, le délai de 72 heures et la date de la purge des données.

Gardez l'endpoint tant que vous voulez garder ses points de restauration. La purge des données suit sa suppression.

Limites et précautions

• La désinstallation ne supprime pas l'endpoint et ne supprime pas les sauvegardes. Ce sont deux actions séparées.
• La suppression de l'endpoint devient définitive après 72 heures. La purge des données suit 7 jours plus tard. Après la purge, aucune restauration n'est possible.
• L'arrêt du service annule la tâche en cours de la machine. Attendez la fin d'une sauvegarde ou d'une restauration avant de désinstaller.
• Sur un nœud Proxmox VE, le script refuse la désinstallation pendant une sauvegarde de VM, et pendant une sauvegarde ou une restauration de conteneur. Il écrit install: a VM backup is running. Attendez la fin de la tâche. L'option --force l'annule à votre place.
• Les fichiers restaurés ne sont jamais supprimés. Le dossier des restaurations reste quand il n'est pas vide. Déplacez son contenu, puis supprimez le dossier.
• Quand votre MSP a changé les noms de l'agent, lancez le script avec l'adresse de votre MSP. Avec un autre profil, le script refuse et ne retire rien. Il écrit no agent '<nom>' installed with this profile.
• Vous relancez la désinstallation sans risque. Sur une machine sans agent, elle ne fait rien.
• Sur Windows, le dossier du programme peut partir quelques secondes après la commande, ou au redémarrage suivant : le programme qui s'exécute ne se supprime pas lui-même.
• Pour déplacer une machine vers une autre instance BaaStide, ne désinstallez pas l'agent. Enrôlez-la de nouveau. Voir Enrôler en ligne de commande.

Référence

• CLI de l'agent : baastide, baastide agent. Sous Windows, l'agent a aussi les commandes baastide uninstall et baastide service.
• API : Delete endpoint.