Watchflare docs
Sur cette page

Désinstaller l'Agent Watchflare

Retirez l'agent Watchflare sous Linux ou macOS. Arrêt du service, binaire et config, nettoyage optionnel des données et de l'utilisateur.

sudo watchflare-agent uninstall

Linux

uninstall pose des questions. Il arrête le service, le retire, supprime le binaire, puis demande un par un : données, config, journal, utilisateur système.

bash
sudo watchflare-agent uninstall
=== Watchflare Agent Uninstallation ===

[1/6] Checking permissions...
  → Running as root

[2/6] Removing service...
  → Removed systemd service

[3/6] Removing binary...
  → Removed /usr/local/bin/watchflare-agent

[4/6] Data and configuration...
Remove data directory (/var/lib/watchflare)? (y/N): y
Remove configuration directory (/etc/watchflare)? (y/N): y
  → Removed /var/lib/watchflare
  → Removed /etc/watchflare

[5/6] Log files...
Remove log file (/var/log/watchflare-agent.log)? (y/N): y
  → Removed /var/log/watchflare-agent.log

[6/6] System user...
Remove system user 'watchflare'? (y/N): y
  → Removed user 'watchflare'

=== Uninstallation Complete ===

Ce que contrôle chaque question :

QuestionCe qui partRépondre N pour…
Dossier de donnéesWAL, état des paquetsGarder le journal de métriques
Dossier de configagent.conf, ca.pemGarder les identifiants d’enrôlement
Fichier de journal/var/log/watchflare-agent.logGarder les journaux pour dépanner
Utilisateur systèmeutilisateur watchflareLe garder si vous réinstallez bientôt

N sur la config : agent.conf et ca.pem restent. Réinstallez plus tard avec le même agent_id / agent_key : l’agent se reconnecte, sans nouveau jeton.

Remarque

Désinstaller l’agent ne retire pas l’hôte du Hub. Il passe hors ligne sur Hosts. Supprimez-le dans le tableau de bord si vous n’en avez plus besoin.

Vérifier sous Linux

Rien ne doit rester :

bash
which watchflare-agent           # ne doit rien renvoyer
ls /etc/watchflare 2>/dev/null   # ne doit pas exister (si vous avez répondu Y)
ls /var/lib/watchflare 2>/dev/null
systemctl status watchflare-agent 2>/dev/null

macOS

Arrêtez le service, puis retirez le paquet Homebrew :

bash
brew services stop watchflare-agent
brew uninstall watchflare-agent

Pour retirer aussi config et données :

bash
rm -rf $(brew --prefix)/etc/watchflare
rm -rf $(brew --prefix)/var/watchflare
rm -f  $(brew --prefix)/var/log/watchflare-agent.log

Vérifier sous macOS

bash
which watchflare-agent                              # ne doit rien renvoyer
ls $(brew --prefix)/etc/watchflare 2>/dev/null     # ne doit pas exister
brew services list | grep watchflare               # ne doit rien renvoyer

Retirer l’hôte du tableau de bord

Retirer l’agent ne retire pas l’hôte du Hub. Pour le supprimer :

  1. Ouvrez la page de l’hôte.
  2. Menu ⋯ → Delete host.

Ça purge l’historique de métriques, l’inventaire de paquets et les règles d’alerte.


Réinstaller sans réenrôler

Pour remettre l’agent sur la même machine, sans nouveau jeton :

  1. Répondez N à toutes les questions (Linux), ou ne lancez pas les rm -rf (macOS).
  2. Réinstallez le binaire.
  3. L’agent reprend agent_id, agent_key et ca.pem : il se reconnecte tout seul.

Si le dossier de config a été effacé, créez un nouvel hôte dans le tableau de bord et relancez register avec un jeton neuf.