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).

Encodage. Sous Windows, enregistrez config.toml en UTF-8 sans BOM (ni UTF-16) : un mauvais encodage empêche l'agent de démarrer. Méthodes fiables et diagnostic dans Diagnostic › Encodage du fichier de configuration.

Déploiement automatisé sur Linux

Sur un parc de serveurs, l'installation peut être entièrement automatisée et intégrée à un outil d'orchestration (Ansible, Puppet, Chef, script de provisioning…). Le principe reste identique à l'installation manuelle : télécharger le paquet correspondant à la distribution, l'installer, puis écrire la clé d'API dans config.toml.

Le script ci-dessous détecte automatiquement la famille de distribution et réalise l'installation de bout en bout. Il attend la clé d'API en argument :

#!/bin/bash
set -euo pipefail
 
API_KEY="${1:-}"
BASE_URL="https://app.kabeen.io/download/packages/server/latest"
 
if [ -z "$API_KEY" ]; then
    echo "Usage: $0 <CLÉ_API_KABEEN>"
    exit 1
fi
 
# Détection de la famille de distribution
if [ -f /etc/debian_version ]; then
    wget -q "$BASE_URL/kabeen-server-agent-1_amd64.deb" -O /tmp/kabeen-server-agent.deb
    apt-get install -y /tmp/kabeen-server-agent.deb
elif [ -f /etc/redhat-release ]; then
    wget -q "$BASE_URL/kabeen-server-agent.x86_64.rpm" -O /tmp/kabeen-server-agent.rpm
    dnf install -y /tmp/kabeen-server-agent.rpm || yum install -y /tmp/kabeen-server-agent.rpm
else
    echo "Distribution non supportée"
    exit 1
fi
 
# Écriture de la clé d'API avec des permissions restrictives
install -m 600 -o root -g root /dev/stdin /etc/kabeen-server-agent/config.toml <<EOF
api_key = "$API_KEY"
EOF
 
echo "Installation terminée. Vérification du service..."
systemctl status kabeen-server-agent.service --no-pager

Le paquet active et démarre déjà kabeen-server-agent.service. Puisque l'agent relit config.toml toutes les 10 secondes, aucun redémarrage n'est nécessaire après l'écriture de la clé : elle est prise en compte au tick suivant.

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).

Dépannage

Le service ne démarre pas

1. Consultez les journaux : journalctl -u kabeen-server-agent.service -n 50
2. Vérifiez la configuration : cat /etc/kabeen-server-agent/config.toml
3. Sous Windows, vérifiez l'encodage du fichier (UTF-8 sans BOM) : voir la note Encodage de la section Configuration de la clé d'API.

Erreur de connexion

1. Testez la connectivité sortante vers l'intake : nc -zv intake.kabeen.io 443 (ou curl -sv https://intake.kabeen.io).
2. Vérifiez la configuration du proxy le cas échéant.
3. Vérifiez le pare-feu : seul le port 443/TCP sortant vers intake.kabeen.io est requis.