Installation manuelle de l'agent serveur

L'agent serveur Kabeen est le composant en charge de la collecte des informations sur l'infrastructure du système d'information : configuration de l'hôte, métriques système, programmes installés et processus en cours.

Il se présente sous la forme d'un service système autonome à installer sur chaque serveur que l'on souhaite analyser dans Kabeen. Les données sont transmises au backend Kabeen via gRPC sur TLS, sur le port sortant 443/TCP uniquement.

Nouveau en 3.0. L'agent serveur est désormais distribué sous forme d'installateur MSI signé sur Windows (en remplacement de l'.exe) et sa configuration utilise un fichier TOML (config.toml) en remplacement de application.conf. Si un ancien agent est présent sur la machine, sa configuration est migrée automatiquement au premier démarrage (voir Migration depuis l'ancien agent).

Pré-requis

• Connexion sortante autorisée vers intake.kabeen.io sur le port 443/TCP. Aucune connexion entrante n'est requise.
• Privilèges administrateur (root sous Linux, membre des Administrateurs locaux sous Windows).
• Sous Linux, systemd est requis comme gestionnaire d'init.

Téléchargement du package

Récupérez le package correspondant à votre système d'exploitation depuis votre console Kabeen (Infrastructure > Ajouter un serveur > Installation automatique).

Installation sur Windows

1. Double-cliquer sur le fichier MSI et accepter l'élévation UAC.
2. Lire et accepter le contrat de licence (CLUF).
3. Sur l'écran Kabeen API key, coller la clé d'API récupérée sur votre compte Kabeen. Vous pouvez aussi laisser le champ vide et renseigner la clé ultérieurement dans config.toml.
4. Cliquer sur Install.

L'installateur copie le binaire dans C:\Program Files\Kabeen\Server Agent\, écrit la configuration dans C:\ProgramData\Kabeen\Server Agent\config.toml, enregistre le service Windows KabeenServerAgent (démarrage automatique) et le démarre.

Installation silencieuse. Pour un poste isolé, en PowerShell administrateur :

msiexec /i "kabeen-server-agent-x86_64.msi" /qn /norestart APIKEY="VOTRE_CLÉ_API_KABEEN"

Pour un déploiement de masse (GPO, Intune, SCCM), consultez les guides dédiés de la section Agent infrastructure.

Installation sur Linux (Debian / Ubuntu)

Installer le paquet .deb téléchargé (apt-get install résout automatiquement les dépendances) :

sudo apt-get install ./kabeen-server-agent_amd64.deb

L'installation crée le fichier de configuration, active l'unité kabeen-server-agent.service et la démarre. Renseigner ensuite la clé d'API (voir Configuration de la clé d'API).

Installation sur Linux (Red Hat et dérivés)

Installer le paquet .rpm téléchargé :

sudo dnf install ./kabeen-server-agent.x86_64.rpm
# ou, sur les distributions sans dnf :
sudo yum install ./kabeen-server-agent.x86_64.rpm

Comme sous Debian, le service est activé et démarré automatiquement. Il ne reste plus qu'à renseigner la clé d'API.

Configuration de la clé d'API

Sous Linux, la clé d'API doit être précisée dans le fichier /etc/kabeen-server-agent/config.toml :

api_key = "VOTRE_CLÉ_API_KABEEN"

sudo install -m 600 -o root -g root /dev/stdin /etc/kabeen-server-agent/config.toml <<'EOF'
api_key = "VOTRE_CLÉ_API_KABEEN"
EOF

Sous Windows, le fichier se trouve dans C:\ProgramData\Kabeen\Server Agent\config.toml.

Pas besoin de redémarrer le service. L'agent relit config.toml automatiquement toutes les 10 secondes : la nouvelle clé est prise en compte au tick suivant. Le fichier contenant une clé en clair, conservez des permissions restrictives (0600 / root sous Linux).

Migration depuis l'ancien agent

Si un ancien agent est déjà installé, l'agent serveur Kabeen importe automatiquement sa configuration au tout premier démarrage :

La reprise de l'agentUUID garantit que la machine conserve la même identité côté console Kabeen — elle n'apparaît pas comme un nouvel hôte.

La migration ne s'effectue qu'une seule fois et n'écrase jamais une configuration déjà renseignée. Procédure recommandée : installer l'agent serveur, vérifier dans la console Kabeen que la machine remonte sous le même identifiant, puis désinstaller l'ancien agent.

Vérification du bon fonctionnement

Linux :

sudo systemctl status kabeen-server-agent.service
sudo journalctl -u kabeen-server-agent.service -f

Windows (PowerShell administrateur) :

Get-Service -Name KabeenServerAgent

Une fois la clé d'API valide renseignée, les journaux doivent afficher All tasks running. Agent is operational., et la machine doit apparaître dans votre console Kabeen avec un heartbeat récent (moins de 2 minutes).