Agent auf Linux bereitstellen

Voraussetzungen

• Ein octoja-Konto mit der Berechtigung Agent-Verwaltung — ohne sie erscheint Administration → Agent-Bereitstellung nicht in deiner Navigation
• Ubuntu 22.04 LTS oder 24.04 LTS, Debian 12 oder 13 oder ein System der RHEL-Familie ab Version 8 (x64 oder arm64)
• Root- oder sudo-Zugang
• Internetzugang (ausgehend HTTPS auf Port 443)

Geklonte Geräte und Master-Images

Installiere den octoja Agent auf jedem Gerät einzeln nach dem Klonen, statt einen bereits registrierten Agent in das Master-Image aufzunehmen. Beim Klonen eines registrierten Agents wird seine Geräteidentität mitkopiert. Dadurch können mehrere Rechner als ein Gerät erscheinen und Fernaktionen den falschen Klon erreichen.

Wenn das bereits passiert ist, nutze den betroffenen Eintrag nicht für Fernaktionen und kontaktiere den Support. Ein neuer Gerätename oder das erneute Ausführen des Installers setzt die octoja-Identität nicht zurück.

Wichtige Begriffe

Diese Anleitung verwendet einige Linux-Befehle. Hier ist ihre Bedeutung:

Schritte

1. Navigiere in octoja zu Administration → Agent-Bereitstellung.
2. Wähle in Schritt 1 – Einstellungen den Registrierungsmodus für den Installationsbefehl. Offenes Deployment erzeugt einen Befehl ohne Token und funktioniert nur, wenn die Registrierungsrichtlinie deiner octoja-Instanz das erlaubt. Token-basiertes Deployment fügt das ausgewählte Enrollment-Token zum Befehl hinzu. Diese Auswahl ändert die Richtlinie nicht.
3. Klicke in Schritt 2 – Plattform wählen auf Linux.
4. Wähle in Schritt 3 – Installationsmethode wählen die Schnellinstallation für ein einzelnes Gerät oder Manuelle Installation, wenn du ein eigenes Paket benötigst.
5. Kopiere in Schritt 4 – Installieren den Befehl aus dem Bereich und führe ihn auf dem Linux-Gerät aus (siehe unten).
6. Bestätige in Schritt 5 – Verifizierung, dass das neue Gerät auftaucht. Du kannst auch zu Geräte navigieren. Das Gerät erscheint in der Regel innerhalb von Sekunden, nachdem die Installation abgeschlossen ist.

Schnellinstallation (empfohlen)

Kopiere den Schnellinstallations-Befehl von der Bereitstellungsseite. Er sieht in etwa so aus:

curl -fsSL 'https://cdn.octoja.com/installer/install.sh' | sudo bash -s -- 'https://YOUR-OCTOJA-URL'

Wenn du im Assistenten Token-basiertes Deployment gewählt hast, enthält der Befehl das Token als zweites positionelles Argument:

curl -fsSL 'https://cdn.octoja.com/installer/install.sh' | sudo bash -s -- 'https://YOUR-OCTOJA-URL' 'YOUR-TOKEN'

Den Befehl direkt aus octoja kopieren. Er enthält bereits die Server-URL (und ggf. das Token). Das obige Beispiel funktioniert nicht ohne Anpassung.

Das Skript erkennt die Architektur, lädt das passende Paket herunter, installiert es und startet die Dienste octoja-launcher und octoja-agent. Fehlen die ICU-Laufzeit oder jq, installiert das Skript sie vorher und weist darauf hin — der Agent braucht ICU zum Starten, und die Linux-Skripte für Überwachung und Automatisierung brauchen jq.

Zum Schluss prüft das Skript, ob beide Dienste wirklich laufen. Ist einer davon nicht gestartet, bricht das Skript mit einer Fehlermeldung ab und gibt die letzten 20 Logzeilen dieses Dienstes aus, damit du siehst, was schiefgelaufen ist. Die vollständigen Logs liegen unter /opt/octoja/logs/agent/ und /opt/octoja/logs/launcher/.

Manuelle Installation

Wähle auf der Bereitstellungsseite Manuelle Installation, um das Agent-ZIP-Archiv direkt herunterzuladen. Entpacke es und führe dann aus dem entpackten Verzeichnis heraus das mitgelieferte install.sh mit deiner Server-URL aus:

sudo bash install.sh https://YOUR-OCTOJA-URL

Falls ein Token erforderlich ist, übergib es als zweites Argument:

sudo bash install.sh https://YOUR-OCTOJA-URL YOUR-TOKEN

Das Archiv enthält .deb- und .rpm-Pakete. Das Skript wählt auf Debian-basierten Systemen .deb mit dpkg, auf RHEL-basierten Systemen .rpm mit dnf/rpm. Es legt den Agenten unter /opt/octoja ab und startet die Dienste octoja-launcher und octoja-agent. Lass die Paketdateien beim Ausführen neben install.sh liegen.

So funktioniert die Sidecar-Einstellungsdatei

Wenn du install.sh mit einer Server-URL (und optional einem Token) ausführst, schreibt das Skript diese Werte in eine Einstellungsdatei unter /etc/octoja/installer.settings.json. Der Post-Install-Schritt des Pakets liest dann diese Datei zur Konfiguration des Agenten — er liest nicht die Befehlszeilenargumente direkt aus.

Falls die Sidecar-Datei beim Installieren des Pakets fehlt, gibt der Post-Install-Schritt einen Hinweis aus, dass du launcherconfig.xml manuell bearbeiten sollst. Du kannst die Sidecar-Datei auch selbst vor der Paketinstallation anlegen, etwa beim Vorbereiten eines Images:

sudo mkdir -p /etc/octoja
sudo tee /etc/octoja/installer.settings.json <<'EOF'
{
  "octojaUrl": "https://YOUR-OCTOJA-URL",
  "token": "YOUR-TOKEN"
}
EOF

Agent-Status überprüfen

Der octoja Agent läuft als zwei systemd-Dienste — Hintergrundprogramme, die beim Systemstart automatisch gestartet werden:

• octoja-launcher — verwaltet Updates und überwacht den Agent-Prozess.
• octoja-agent — der eigentliche Agent, der sich mit deinem octoja-Server verbindet.

Prüfe den Status beider Dienste mit folgenden Befehlen:

systemctl status octoja-launcher
systemctl status octoja-agent

Beide sollten active (running) anzeigen. Falls einer inactive oder failed anzeigt, starte ihn neu:

sudo systemctl restart octoja-launcher
sudo systemctl restart octoja-agent

Agent-Dienste verwalten

Der Launcher richtet zusätzlich den Timer octoja-service-recovery.timer ein. Er prüft alle fünf Minuten, ob beide Dienste laufen, und startet einen gestoppten Dienst wieder. Ein systemctl stop nur für die beiden Dienste hält sie deshalb höchstens bis zur nächsten Prüfung an.

Enrollment-Token benötigt? Siehe Enrollment-Tokens konfigurieren.

FAQ