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.

Die Seite Agent-Bereitstellung in octoja mit dem mehrstufigen Assistenten. Der Seitentitel „Agent-Bereitstellung“ ist rot umrandet. Der Schalter „Offenes Deployment erlauben“ oben rechts ist aktiviert. Schritt 1 Einstellungen zeigt die Optionskacheln Offenes Deployment und Token-basiertes Deployment mit ausgewähltem Offenes Deployment; Schritt 2 Plattform wählen zeigt Windows, Linux und macOS; Schritt 3 Installationsmethode wählen zeigt Schnellinstallation, Manuelle Installation und Automatischer Rollout.

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

  1. Navigiere in octoja zu Administration → Agent-Bereitstellung in der linken Seitenleiste.

  2. Schritt 1 – Einstellungen. Behalte für deinen ersten Agent die Standardoption Offenes Deployment bei. Damit kann sich jedes Gerät mit der richtigen Server-URL sofort registrieren, sodass du ein Gerät ohne zusätzliche Einrichtung verbinden kannst.

  3. Schritt 2 – Plattform wählen. Wähle das Betriebssystem des Geräts aus: Windows, Linux oder macOS.

  4. 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.

  5. Schritt 4 – Installieren. Kopiere den im grauen Code-Block angezeigten Installationsbefehl und führe ihn auf dem Zielgerät aus:

PlattformAusführung
WindowsPowerShell als Administrator öffnen, Befehl einfügen, Enter drücken
LinuxTerminal öffnen, Befehl einfügen, Enter drücken. Er läuft mit sudo – gib dein Passwort ein, wenn du dazu aufgefordert wirst
macOSTerminal ö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.

  1. 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

Offenes Deployment ist praktisch, solange du das Produkt kennenlernst. Für den Produktivbetrieb sollte dein Administrator auf Token-basiertes Deployment umstellen, damit sich nur Geräte mit einem gültigen Enrollment-Token verbinden können. Die Admin-Einrichtung ist in Agent-Enrollment-Tokens konfigurieren beschrieben.

Fehlerbehebung

ProblemWas tun
Gerät erscheint nach 5 Minuten nichtPrü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 fehlFühre PowerShell als Administrator aus. Windows erfordert Administratorrechte, um Dienste zu installieren.
Installation schlägt auf Linux oder macOS fehlDer 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 angezeigtStarte 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.