Mettre à jour l'agent serveur

Mettre à jour l'agent serveur Kabeen consiste à réinstaller le dernier package par-dessus la version existante. L'opération se fait sur place : le binaire est remplacé, le service redémarre automatiquement avec la nouvelle version, et la configuration ainsi que l'identité de l'hôte sont conservées.

Aucune reconfiguration nécessaire. Le fichier config.toml (sous C:\ProgramData\Kabeen\Server Agent\ sous Windows, /etc/kabeen-server-agent/ sous Linux) n'est jamais écrasé par une mise à jour. La clé d'API et l'identité de l'agent (agent_id) restent inchangées : la machine continue de remonter sous le même identifiant dans la console Kabeen, sans réapparaître comme un nouvel hôte.

Vérifier la version installée

Avant et après la mise à jour, contrôlez la version en place.

Windows (PowerShell administrateur) :

Get-Package -Name "*Kabeen*" | Select-Object Name, Version

La version est également visible dans Panneau de configuration > Programmes et fonctionnalités.

Linux (Debian / Ubuntu) :

dpkg -l kabeen-server-agent

Linux (Red Hat et dérivés) :

rpm -q kabeen-server-agent

La console Kabeen affiche aussi la version de l'agent remontée par chaque hôte (Infrastructure > sélectionner le serveur).

Télécharger le dernier package

Les liens de téléchargement servent toujours la dernière version publiée. Récupérez le package correspondant à votre système d'exploitation :

Mise à jour sur Windows

L'installateur MSI 3.0 gère une mise à niveau majeure : il suffit de lancer le nouveau MSI, il désinstalle proprement l'ancienne version puis installe la nouvelle, en conservant config.toml.

En mode interactif, double-cliquez sur le nouveau MSI et suivez l'assistant. L'écran Kabeen API key peut être laissé vide : la clé déjà présente dans config.toml est conservée.

En mode silencieux (PowerShell administrateur) :

msiexec /i "kabeen-server-agent-x86_64.msi" /qn /norestart

Ne renseignez pas le paramètre APIKEY lors d'une mise à jour : la clé existante suffit. L'indiquer n'est utile que pour (re)définir la clé si config.toml n'en contient pas encore.

Le service KabeenServerAgent est arrêté puis relancé automatiquement par l'installateur.

Mise à jour en masse par GPO

Pour un parc Windows joint au domaine, la mise à jour se propage via la même GPO d'installation logicielle que le déploiement initial, en déclarant le nouveau MSI comme mise à niveau de l'ancien package.

1. Copiez le nouveau MSI dans le partage réseau utilisé par la GPO (conservez l'ancien package tant que la mise à niveau n'est pas terminée) :

   \\serveur\partage\kabeen\kabeen-server-agent-x86_64.msi

2. Ouvrez la console Gestion des stratégies de groupe, éditez la GPO de déploiement et naviguez vers Configuration ordinateur > Stratégies > Paramètres logiciels > Installation de logiciel.

3. Clic droit > Nouveau > Package, sélectionnez le nouveau MSI via son chemin UNC, puis choisissez la méthode Attribué.

4. Ouvrez les Propriétés du nouveau package > onglet Mises à niveau > Ajouter, et sélectionnez l'ancien package. Choisissez Désinstaller le package existant, puis installer le package de mise à niveau, et cochez Mise à niveau requise pour les packages existants.

5. Sur un serveur de test, forcez l'application puis redémarrez (l'installation de logiciel par GPO s'applique au démarrage) :

   gpupdate /force

Le fichier config.toml (clé d'API et identité de l'agent) réside sous C:\ProgramData\ et survit à la mise à niveau : aucune GPO de configuration supplémentaire n'est nécessaire. Contrairement au premier déploiement, il est inutile de repositionner la clé d'API.

Pour le déploiement initial par GPO, voir Installation de l'agent serveur par GPO.

Mise à jour par Microsoft Intune

Pour les serveurs gérés par Microsoft Intune, la mise à jour consiste à publier la nouvelle version du package ; Intune la déploie ensuite automatiquement sur les machines cibles à leur prochain enregistrement.

1. Connectez-vous au gestionnaire Intune.
2. Applications > Toutes les applications, puis sélectionnez l'application Kabeen Server Agent existante (Application métier / line-of-business MSI).
3. Propriétés > section Informations sur l'application > Modifier, puis chargez le nouveau MSI (dont la version de produit est supérieure à celle en place).
4. Enregistrez. Intune s'appuie sur la version de produit du MSI pour la détection : il installe la nouvelle version par-dessus l'ancienne sur les appareils dont l'affectation est Obligatoire.

Si l'agent a été empaqueté en application Win32 (.intunewin) plutôt qu'en application métier, publiez la nouvelle version comme application distincte et déclarez-la en remplacement (supersedence) de l'ancienne.

Aucun profil de configuration à modifier. L'agent serveur ne s'appuie pas sur des modèles ADMX (contrairement à l'agent utilisateur) : sa clé d'API et son identité sont conservées dans config.toml. Seul le package d'application doit être mis à jour. Comme pour tout déploiement Intune, comptez un délai de propagation de 24 à 48 heures.

Mise à jour sur Linux (Debian / Ubuntu)

Installer le nouveau paquet .deb par-dessus l'ancien réalise la mise à niveau ; les fichiers sous /etc/kabeen-server-agent/ sont préservés :

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

Le paquet redémarre l'unité kabeen-server-agent.service avec le nouveau binaire.

Mise à jour sur Linux (Red Hat et dérivés)

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

Comme sous Debian, la configuration est conservée et le service est redémarré automatiquement.

Mise à jour depuis un ancien agent (2.x / Kapsul)

Le passage d'un ancien agent (Kapsul 2.x, configuration application.conf, service .exe) vers l'agent serveur 3.0 n'est pas une simple mise à jour de paquet : il s'agit d'une migration. Installez l'agent serveur 3.0 en parallèle — il importe automatiquement la clé d'API et l'agentUUID de l'ancien agent au premier démarrage, préservant l'identité de l'hôte — puis désinstallez l'ancien agent.

La procédure détaillée est décrite dans Installation manuelle de l'agent serveur.

Vérification après mise à jour

Contrôlez que le service fonctionne et que la nouvelle version est bien en place.

Linux :

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

Windows (PowerShell administrateur) :

Get-Service -Name KabeenServerAgent

Les journaux doivent afficher All tasks running. Agent is operational., et la machine doit continuer à remonter dans la console Kabeen avec un heartbeat récent (moins de 2 minutes) — sous le même identifiant qu'avant la mise à jour.

Pour la première installation, voir Installation manuelle de l'agent serveur. Pour retirer l'agent, voir Désinstaller l'agent serveur.