Agent installieren

Die Installation ist ein einziger Befehl. Danach meldet sich der Server selbstständig bei LIVCK an und schickt innerhalb einer Minute den ersten Messwert.

Voraussetzungen

Andere Distributionen mit systemd (z.B. openSUSE) installiert der Agent auf eigene Verantwortung: der Installer gibt eine Warnung aus und macht weiter. Ohne systemd -- etwa auf Alpine mit OpenRC -- bricht er ab.

Schritt 1: Server in LIVCK anlegen

1. Klicke in der Seitenleiste unter Überwachung auf Server
2. Klicke auf "Server hinzufügen"
3. Wähle, wie viele Server du verbinden willst:
   • Einen Server -- erzeugt einen Einmal-Token, der nach der ersten Anmeldung verfällt
   • Mehrere Server -- erzeugt einen Mehrfach-Token für bis zu 50 Server, 90 Tage gültig
4. Klicke auf "Weiter" -- LIVCK zeigt dir den fertigen Installationsbefehl

Der Dialog bleibt offen und aktualisiert sich von selbst, sobald sich dein Server meldet.

Schritt 2: Befehl auf dem Server ausführen

Der Befehl sieht so aus -- den echten Token bekommst du im Dialog:

curl -fsSL https://get.livck.cloud/install.sh | sudo sh -s -- --token lve_DEIN_TOKEN

Optional kannst du dem Server gleich einen Namen und Tags mitgeben:

curl -fsSL https://get.livck.cloud/install.sh | sudo sh -s -- \
  --token lve_DEIN_TOKEN --name web-01 --tag env:prod --tag team:platform

Ohne --name verwendet LIVCK den Hostnamen des Servers.

sudo sh <<'EOF'
umask 077
tf=$(mktemp); trap 'rm -f "$tf"' EXIT
cat > "$tf" <<'TOKEN'
lve_DEIN_TOKEN
TOKEN
curl -fsSL https://get.livck.cloud/install.sh | sh -s -- --token-file "$tf" --name web-01
EOF

Was der Installer macht

1. Prüft Betriebssystem, Architektur, systemd und dass kein Container vorliegt -- passt etwas nicht, bricht er ab, bevor er irgendetwas ändert
2. Lädt das passende Paket von get.livck.cloud und vergleicht es mit der veröffentlichten SHA-256-Prüfsumme
3. Installiert ein .deb bzw. .rpm, wenn dein System einen der beiden Paketmanager hat -- sonst legt er die statische Binary direkt ab
4. Legt den Systembenutzer livck-agent an
5. Startet den Dienst und meldet den Server mit deinem Token bei LIVCK an

Was auf dem Server landet

Der Dienst läuft unter dem eigenen, unprivilegierten Benutzer livck-agent -- nicht als root. Details zur Absicherung stehen unter Sicherheit & Transparenz.

Schritt 3: Ergebnis prüfen

In der Serverliste erscheint dein Server zunächst mit dem Zustand Warte auf Agent und wechselt nach dem ersten Report auf Online. Danach kannst du:

• die Detailansicht mit Live-Metriken öffnen,
• eigene Alarm-Regeln anlegen,
• Erreichbarkeits-Prüfungen konfigurieren.

Passiert nichts, hilft Fehlerbehebung weiter.

Enrollment-Tokens verwalten

Ein Enrollment-Token ist ein einmaliges Anmelde-Kennwort für neue Server. Es gehört zur Organisation, nicht zu einem einzelnen Server. Sobald ein Server angemeldet ist, braucht er den Token nicht mehr -- er bekommt beim Anmelden seinen eigenen Zugang, den er selbstständig turnusmäßig erneuert.

Alle Tokens findest du unter Einstellungen → Organisation → Enrollment-Tokens.

Der Fleet-Token ist gedacht für Terraform, Cloud-init, Ansible oder ein Golden Image: einmal ausrollen, viele Server melden sich an.

Tags am Token

Gibst du einem Token Tags mit, bekommt sie jeder Server, der sich damit anmeldet. Sie gelten immer. Ein Server kann sie bei der Installation nicht ersetzen. Setzt er mit --tag einen Tag mit demselben Schlüssel, etwa kunde:4712 bei einem Token mit kunde:4711, bleibt es bei kunde:4711, und LIVCK verwirft den Tag des Servers. Die Anmeldung klappt trotzdem.

Mit dem Schalter Server darf eigene Tags setzen legst du fest, ob Tags aus dem Installationsbefehl dazukommen dürfen. Ist er aus, bekommt ein Server nur die Tags des Tokens. In der Übersicht steht dann Nur Token-Tags. Die Tags, die der Agent selbst setzt, etwa Betriebssystem und Distribution, kommen in jedem Fall dazu.

Ein Token darf auch einen Tag tragen, der eine Gruppe auf einer Statuspage füllt. Der Server bekommt den Tag, erscheint aber nie auf der Statuspage: Gruppen, die sich per Tag füllen, lassen Server aus.

Tokens lassen sich auch über die API erstellen, abfragen und widerrufen. Dort heißen sie Enrollment-Keys.

In der Übersicht siehst du je Token Name, Typ, Verwendungen, Status (Aktiv, Widerrufen, Abgelaufen, Aufgebraucht), Ablaufdatum und wer ihn erstellt hat. Zwei Aktionen stehen zur Verfügung:

• Rotieren -- der alte Token wird sofort ungültig, ein neuer erscheint einmalig im Klartext. Bereits angebundene Server sind nicht betroffen.
• Widerrufen -- der Token wird dauerhaft ungültig. Bereits angebundene Server bleiben verbunden.

Der Agent auf der Kommandozeile

Alle Befehle laufen als root:

Hinter einem Proxy

Braucht dein Server einen HTTP-Proxy für ausgehende Verbindungen, hinterlege ihn einmalig:

sudo cp /etc/livck-agent/agent.env.example /etc/livck-agent/agent.env
sudo nano /etc/livck-agent/agent.env      # HTTPS_PROXY / HTTP_PROXY / NO_PROXY setzen
sudo systemctl restart livck-agent

Server wieder entfernen

Ein Server verschwindet erst vollständig, wenn du beide Seiten aufräumst.

Auf dem Server

sudo livck-agent uninstall

Das stoppt Dienst und Update-Timer, entfernt das Paket bzw. die Binary und löscht Konfiguration, Zwischenspeicher und den Systembenutzer. Mit --keep-data bleiben Identität und Konfiguration liegen -- praktisch, wenn du gleich neu installieren willst.

Der Agent meldet die Deinstallation an LIVCK: Der Server wechselt in der Konsole in den Zustand Deinstalliert und wird pausiert. Installierst du ihn später erneut, läuft er einfach weiter.

In LIVCK

Der Eintrag samt Verlauf bleibt bestehen, bis du ihn löschst: in der Serverliste über das Papierkorb-Symbol oder über Löschen in der Mehrfachauswahl. Der Bestätigungsdialog heißt "Server trennen".

Nur die Überwachung pausieren

Willst du den Server behalten, aber vorübergehend keine Alarme bekommen, markierst du ihn in der Serverliste und wählst Pausieren. Mit Fortsetzen geht es weiter.

Weiterführende Themen

• Sicherheit & Transparenz -- was der Agent darf und was nicht
• Serverliste & Detailansicht -- die Zustände eines Servers
• Agent-Updates -- Auto-Update und Wartungsfenster
• Fehlerbehebung -- wenn keine Daten ankommen
• Grenzen & Pläne -- wie viele Server pro Plan