Schritt 3 – Deinen ersten Agent bereitstellen

Den octoja Agent auf einem Gerät installieren, damit es überwacht werden kann

Der octoja Agent ist ein kleines Programm, das auf einem Computer oder Server läuft. Nach der Installation verbindet er sich direkt mit dem octoja Web-Service und sendet Gesundheitsdaten – CPU-Auslastung, Arbeitsspeicher, Festplattenspeicher, laufende Dienste und mehr – damit du das Gerät aus der Ferne überwachen kannst.

Bevor du beginnst

Dein octoja-Benutzer braucht die Berechtigung Agent-Verwaltung – ohne sie lässt sich die Agent-Bereitstellung nicht öffnen. Administratoren haben sie bereits.
Du brauchst Administratorrechte auf dem Gerät, auf dem du den Agent installierst.
Das Gerät benötigt eine Internetverbindung (ausgehend HTTPS auf Port 443).
Du solltest den Kunden, zu dem dieses Gerät gehört, bereits angelegt haben (siehe Schritt 2).

Schritte

Navigiere in octoja zu Administration → Agent-Bereitstellung in der linken Seitenleiste.
Schritt 1 – Einstellungen. Wähle Offenes Deployment nur, wenn deine octoja-Instanz die Registrierung ohne Token erlaubt. Diese Auswahl erzeugt einen Installationsbefehl ohne Token; sie ändert die Registrierungsrichtlinie nicht. Verlangt deine Instanz ein Token, wähle Token-basiertes Deployment und ein gültiges Enrollment-Token. Dein Administrator kann es nach der Anleitung für Enrollment-Tokens bereitstellen.
Schritt 2 – Plattform wählen. Wähle das Betriebssystem des Geräts aus: Windows, Linux oder macOS.
Schritt 3 – Installationsmethode wählen. Für deinen ersten Agent wird Schnellinstallation empfohlen. Dabei wird ein einzelner Befehl ausgeführt, der die Architektur automatisch erkennt und den Agent lautlos installiert.
Schritt 4 – Installieren. Kopiere den im grauen Code-Block angezeigten Installationsbefehl und führe ihn auf dem Zielgerät aus:

Plattform	Ausführung
Windows	PowerShell als Administrator öffnen, Befehl einfügen, Enter drücken
Linux	Terminal öffnen, Befehl einfügen, Enter drücken. Er läuft mit sudo – gib dein Passwort ein, wenn du dazu aufgefordert wirst
macOS	Terminal öffnen, Befehl einfügen, Enter drücken. Er läuft mit sudo – gib dein Passwort ein, wenn du dazu aufgefordert wirst

Schritt 4 Installieren des Deployment-Assistenten mit dem PowerShell-Installationsbefehl in einem grauen Code-Block. Die Kopierschaltfläche oben rechts am Code-Block ist rot umrandet; der Befehlstext reicht über den sichtbaren Ausschnitt hinaus (kopiere ihn aus der Live-Oberfläche, nicht aus diesem Bild).

Den Befehl aus der octoja-Oberfläche kopieren. Nicht aus diesem Artikel abtippen – er enthält deine individuelle Server-URL.

Unter Windows installiert die Schnellinstallation fehlende Voraussetzungen automatisch, darunter Microsoft Visual C++ Redistributable und .NET Framework. Erfordert die Installation von .NET Framework einen Neustart, stoppt das Skript vor der Agent-Installation. Starte Windows selbst neu und führe den Befehl danach erneut aus. Die Windows-Bereitstellungsanleitung beschreibt die Download-Freigaben und mögliche Auswirkungen auf laufende Dienste.

Schritt 5 – Verifizierung. Sobald der Installationsbefehl durchgelaufen ist, navigiere in der Seitenleiste zu Geräte. Das Gerät erscheint innerhalb von Sekunden. In der schmalen Statusspalte mit der Überschrift S. bekommt das Gerätesymbol einen grünen Ring, sobald der Agent online ist. Die Spalte Zustand zeigt einen Strich – sie fasst Check-Ergebnisse zusammen, und für dieses Gerät gibt es noch keine Checks. Sie wird zu einem grünen Haken, sobald du in Schritt 4 deinen ersten Check aktivierst.

Die octoja Gerätetabelle kurz nach der Registrierung. Das neu registrierte Gerät CONTOSO-DC01 erscheint in der Liste, sein Server-Symbol in der Spalte „S.“ ist blau umrandet. Die Health-Spalte zeigt einen Gedankenstrich, während die ersten Telemetriedaten noch eingehen; sie wird innerhalb von 1–2 Minuten grün, sobald der Agent meldet.

Wenn du die Registrierung absichern möchtest

Für den Produktivbetrieb öffnet dein Administrator Einstellungen → Richtlinie zur Agent-Registrierung und schaltet Offenes Deployment erlauben aus. Erst diese Einstellung verlangt bei neuen Registrierungen ein gültiges Enrollment-Token. Die Auswahl Token-basiertes Deployment im Bereitstellungsassistenten fügt lediglich ein Token zum Installationsbefehl hinzu und sperrt die Registrierung ohne Token nicht. Die Richtlinie können nur Administratoren ändern; Agent-Verwaltung allein reicht dafür nicht. Siehe Enrollment-Tokens konfigurieren.

Fehlerbehebung

Problem	Was tun
Gerät erscheint nach 5 Minuten nicht	Prüfe den Internetzugang des Geräts. Versuche, eine beliebige Website im Browser zu öffnen. Wenn das funktioniert, starte den Agent-Dienst auf dem Gerät neu.
Installation schlägt auf Windows fehl	Führe PowerShell als Administrator aus. Windows erfordert Administratorrechte, um Dienste zu installieren.
Installation schlägt auf Linux oder macOS fehl	Der Befehl braucht Root-Rechte. Führe ihn mit einem Konto aus, das sudo verwenden darf, und gib das Passwort ein, wenn das Terminal danach fragt.
Agent wird als getrennt angezeigt	Starte das Gerät neu und warte 2 Minuten. Wenn weiterhin getrennt, prüfe, ob eine Firewall ausgehende HTTPS-Verbindungen (Port 443) blockiert.

Mehr Details? Die ausführlichen Deployment-Anleitungen:

Nächster Schritt

Weiter zu Schritt 4 – Deinen ersten Check aktivieren.

War dies hilfreich?

Brauchen Sie noch Hilfe? Team fragen