Manuelle Installation des Server-Agenten

Der Kabeen Server-Agent ist die Komponente, die für die Erfassung von Informationen über die Infrastruktur des Informationssystems zuständig ist: Host-Konfiguration, Systemmetriken, installierte Programme und laufende Prozesse.

Es handelt sich um einen eigenständigen Systemdienst, der auf jedem Server installiert werden muss, den Sie in Kabeen analysieren möchten. Die Daten werden über gRPC via TLS an das Kabeen-Backend übertragen, ausschließlich über den ausgehenden Port 443/TCP.

Neu in 3.0. Der Server-Agent wird unter Windows nun als signierter MSI-Installer ausgeliefert (anstelle der .exe) und seine Konfiguration verwendet eine TOML-Datei (config.toml) anstelle von application.conf. Wenn ein bisheriger Agent auf dem Rechner vorhanden ist, wird seine Konfiguration beim ersten Start automatisch migriert (siehe Migration vom bisherigen Agenten).

Voraussetzungen

• Ausgehende Verbindung zu intake.kabeen.io über Port 443/TCP zulässig. Es ist keine eingehende Verbindung erforderlich.
• Administrator-Rechte (root unter Linux, Mitglied der lokalen Administratoren unter Windows).
• Unter Linux ist systemd als Init-Manager erforderlich.

Paket-Download

Laden Sie das Paket für Ihr Betriebssystem aus Ihrer Kabeen-Konsole herunter (Infrastruktur > Server hinzufügen > Automatische Installation).

Installation unter Windows

1. Doppelklicken Sie auf die MSI-Datei und bestätigen Sie die UAC-Eingabeaufforderung.
2. Lesen und akzeptieren Sie den Endbenutzer-Lizenzvertrag (EULA).
3. Fügen Sie auf dem Bildschirm Kabeen API key den aus Ihrem Kabeen-Konto abgerufenen API-Schlüssel ein. Sie können das Feld auch leer lassen und den Schlüssel später in config.toml angeben.
4. Klicken Sie auf Install.

Der Installer kopiert die Binärdatei nach C:\Program Files\Kabeen\Server Agent\, schreibt die Konfiguration nach C:\ProgramData\Kabeen\Server Agent\config.toml, registriert den Windows-Dienst KabeenServerAgent (automatischer Start) und startet ihn.

Unbeaufsichtigte Installation. Für einen einzelnen Rechner, in einer PowerShell mit Administratorrechten:

msiexec /i "kabeen-server-agent-x86_64.msi" /qn /norestart APIKEY="IHR_KABEEN_API_SCHLÜSSEL"

Für eine Massenbereitstellung (GPO, Intune, SCCM) lesen Sie die entsprechenden Anleitungen im Abschnitt Infrastruktur-Agent.

Installation unter Linux (Debian / Ubuntu)

Installieren Sie das heruntergeladene .deb-Paket (apt-get install löst die Abhängigkeiten automatisch auf):

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

Die Installation erstellt die Konfigurationsdatei, aktiviert die Unit kabeen-server-agent.service und startet sie. Geben Sie anschließend den API-Schlüssel an (siehe Konfiguration des API-Schlüssels).

Installation unter Linux (Red Hat und Derivate)

Installieren Sie das heruntergeladene .rpm-Paket:

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

Wie unter Debian wird der Dienst automatisch aktiviert und gestartet. Es bleibt nur noch, den API-Schlüssel anzugeben.

Konfiguration des API-Schlüssels

Unter Linux muss der API-Schlüssel in der Datei /etc/kabeen-server-agent/config.toml angegeben werden:

api_key = "IHR_KABEEN_API_SCHLÜSSEL"

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

Unter Windows befindet sich die Datei unter C:\ProgramData\Kabeen\Server Agent\config.toml.

Kein Neustart des Dienstes erforderlich. Der Agent liest config.toml automatisch alle 10 Sekunden neu ein: Der neue Schlüssel wird beim nächsten Tick übernommen. Da die Datei einen Schlüssel im Klartext enthält, behalten Sie restriktive Berechtigungen bei (0600 / root unter Linux).

Migration vom bisherigen Agenten

Wenn ein bisheriger Agent bereits installiert ist, importiert der Kabeen Server-Agent dessen Konfiguration beim allerersten Start automatisch:

Die Übernahme der agentUUID stellt sicher, dass der Rechner dieselbe Identität behält in der Kabeen-Konsole — er erscheint nicht als neuer Host.

Die Migration erfolgt nur einmal und überschreibt niemals eine bereits angegebene Konfiguration. Empfohlenes Vorgehen: Installieren Sie den Server-Agenten, prüfen Sie in der Kabeen-Konsole, dass der Rechner unter derselben Kennung erscheint, und deinstallieren Sie anschließend den bisherigen Agenten.

Überprüfung des Betriebs

Linux:

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

Windows (PowerShell als Administrator):

Get-Service -Name KabeenServerAgent

Sobald ein gültiger API-Schlüssel angegeben ist, sollten die Protokolle All tasks running. Agent is operational. anzeigen, und der Rechner sollte in Ihrer Kabeen-Konsole mit einem aktuellen Heartbeat (weniger als 2 Minuten) erscheinen.