Server-Agent aktualisieren | Docs

Den Kabeen-Server-Agenten zu aktualisieren bedeutet, das neueste Paket über die vorhandene Version zu installieren. Der Vorgang erfolgt an Ort und Stelle: Die Binärdatei wird ersetzt, der Dienst startet automatisch mit der neuen Version neu, und Konfiguration sowie Host-Identität bleiben erhalten.

Keine Neukonfiguration erforderlich. Die Datei config.toml (unter C:\ProgramData\Kabeen\Server Agent\ unter Windows, /etc/kabeen-server-agent/ unter Linux) wird durch eine Aktualisierung niemals überschrieben. Der API-Schlüssel und die Agenten-Identität (agent_id) bleiben unverändert: Die Maschine meldet sich weiterhin unter derselben Kennung in der Kabeen-Konsole und erscheint nicht als neuer Host.

Installierte Version prüfen

Prüfen Sie vor und nach der Aktualisierung die vorhandene Version.

Windows (PowerShell als Administrator):

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

Die Version ist auch unter Systemsteuerung > Programme und Funktionen sichtbar.

Linux (Debian / Ubuntu):

dpkg -l kabeen-server-agent

Linux (Red Hat und Derivate):

rpm -q kabeen-server-agent

Die Kabeen-Konsole zeigt ebenfalls die von jedem Host gemeldete Agentenversion an (Infrastruktur > Server auswählen).

Das neueste Paket herunterladen

Die Download-Links liefern stets die neueste veröffentlichte Version. Laden Sie das Paket für Ihr Betriebssystem herunter:

Plattform	Download-Link
Windows (MSI)	Link
Linux (DEB)	Link
Linux (RPM)	Link

Aktualisierung unter Windows

Der 3.0-MSI-Installer führt ein Major Upgrade durch: Starten Sie einfach das neue MSI – es entfernt die alte Version sauber und installiert dann die neue, wobei config.toml erhalten bleibt.

Im interaktiven Modus doppelklicken Sie auf das neue MSI und folgen dem Assistenten. Der Bildschirm Kabeen API key kann leer bleiben: Der bereits in config.toml vorhandene Schlüssel wird beibehalten.

Im stillen Modus (PowerShell als Administrator):

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

Geben Sie bei einer Aktualisierung den Parameter APIKEY nicht an: Der vorhandene Schlüssel genügt. Er ist nur nützlich, um den Schlüssel (neu) zu setzen, wenn config.toml noch keinen enthält.

Der Dienst KabeenServerAgent wird vom Installer automatisch gestoppt und neu gestartet.

Aktualisierung im großen Maßstab per GPO

Für eine in die Domäne eingebundene Windows-Flotte verbreitet sich die Aktualisierung über dieselbe Softwareinstallations-GPO wie die Erstbereitstellung, indem das neue MSI als Upgrade des alten Pakets deklariert wird.

Kopieren Sie das neue MSI in die von der GPO genutzte Netzwerkfreigabe (behalten Sie das alte Paket, bis das Upgrade abgeschlossen ist):
```
\\server\freigabe\kabeen\kabeen-server-agent-x86_64.msi
```
Öffnen Sie die Konsole Gruppenrichtlinienverwaltung, bearbeiten Sie die Bereitstellungs-GPO und navigieren Sie zu Computerkonfiguration > Richtlinien > Softwareeinstellungen > Softwareinstallation.
Rechtsklick > Neu > Paket, wählen Sie das neue MSI über seinen UNC-Pfad aus und wählen Sie dann die Methode Zugewiesen.
Öffnen Sie die Eigenschaften des neuen Pakets > Registerkarte Upgrades > Hinzufügen, und wählen Sie das alte Paket aus. Wählen Sie Vorhandenes Paket deinstallieren, dann Upgrade-Paket installieren, und aktivieren Sie Erforderliches Upgrade für vorhandene Pakete.
Erzwingen Sie auf einem Testserver die Anwendung und starten Sie dann neu (die Softwareinstallation per GPO wird beim Start angewendet):
```
gpupdate /force
```

Die Datei config.toml (API-Schlüssel und Agenten-Identität) liegt unter C:\ProgramData\ und übersteht das Upgrade: Es ist keine zusätzliche Konfigurations-GPO erforderlich. Im Gegensatz zur Erstbereitstellung muss der API-Schlüssel nicht erneut gesetzt werden.

Zur Erstbereitstellung per GPO siehe Installation des Server-Agenten per GPO.

Aktualisierung über Microsoft Intune

Für von Microsoft Intune verwaltete Server besteht die Aktualisierung darin, die neue Version des Pakets zu veröffentlichen; Intune verteilt sie anschließend automatisch beim nächsten Check-in an die Zielrechner.

Melden Sie sich beim Intune Admin Center an.
Apps > Alle Apps, wählen Sie dann die vorhandene Anwendung Kabeen Server Agent aus (Branchen-App / line-of-business MSI).
Eigenschaften > Abschnitt App-Informationen > Bearbeiten, und laden Sie das neue MSI hoch (dessen Produktversion höher ist als die vorhandene).
Speichern Sie. Intune stützt sich zur Erkennung auf die MSI-Produktversion: Es installiert die neue Version über die alte auf Geräten, deren Zuweisung Erforderlich ist.

Wurde der Agent als Win32-App (.intunewin) statt als Branchen-App verpackt, veröffentlichen Sie die neue Version als separate App und deklarieren Sie sie als Ersetzung (Supersedence) der alten.

Kein Konfigurationsprofil zu ändern. Der Server-Agent stützt sich nicht auf ADMX-Vorlagen (anders als der Benutzer-Agent): Sein API-Schlüssel und seine Identität bleiben in config.toml erhalten. Nur das Anwendungspaket muss aktualisiert werden. Wie bei jeder Intune-Bereitstellung ist mit einer Verteilungsverzögerung von 24 bis 48 Stunden zu rechnen.

Aktualisierung unter Linux (Debian / Ubuntu)

Die Installation des neuen .deb-Pakets über das alte führt das Upgrade durch; die Dateien unter /etc/kabeen-server-agent/ bleiben erhalten:

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

Das Paket startet die Unit kabeen-server-agent.service mit der neuen Binärdatei neu.

Aktualisierung unter Linux (Red Hat und Derivate)

sudo dnf upgrade ./kabeen-server-agent.x86_64.rpm
# oder, auf Distributionen ohne dnf:
sudo rpm -U kabeen-server-agent.x86_64.rpm

Wie unter Debian bleibt die Konfiguration erhalten und der Dienst wird automatisch neu gestartet.

Aktualisierung von einem älteren Agenten (2.x / Kapsul)

Der Wechsel von einem älteren Agenten (Kapsul 2.x, Konfiguration application.conf, .exe-Dienst) zum Server-Agenten 3.0 ist keine einfache Paketaktualisierung – es handelt sich um eine Migration. Installieren Sie den Server-Agenten 3.0 parallel: Er importiert beim ersten Start automatisch den API-Schlüssel und die agentUUID des älteren Agenten und bewahrt so die Host-Identität; anschließend deinstallieren Sie den älteren Agenten.

Das detaillierte Vorgehen ist in Manuelle Installation des Server-Agenten beschrieben.

Überprüfung nach der Aktualisierung

Prüfen Sie, dass der Dienst läuft und die neue Version vorhanden ist.

Linux:

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

Windows (PowerShell als Administrator):

Get-Service -Name KabeenServerAgent

Die Protokolle sollten All tasks running. Agent is operational. anzeigen, und die Maschine sollte sich weiterhin in der Kabeen-Konsole mit einem aktuellen Heartbeat (weniger als 2 Minuten) melden – unter derselben Kennung wie vor der Aktualisierung.

Für die Erstinstallation siehe Manuelle Installation des Server-Agenten. Zum Entfernen des Agenten siehe Server-Agent deinstallieren.