Schritt 3 – Deinen ersten Agent bereitstellen

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

Geschrieben von Erdinc Akay

Zuletzt aktualisiert Vor 28 Tagen

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

  • 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
macOSTerminal öffnen, Befehl einfügen, Enter drücken
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. Warte 1–2 Minuten, navigiere dann in der Seitenleiste zu Geräte. Das Gerät sollte in der Liste erscheinen und der Status-Punkt leuchtet grün. Die Health-Spalte kann in den ersten ein bis zwei Minuten einen Strich zeigen, bevor sie grün wird — der Agent ist verbunden, die ersten Telemetriedaten sind nur noch unterwegs.
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.
macOS blockiert den InstallerNavigiere zu Systemeinstellungen → Datenschutz & Sicherheit und klicke auf Trotzdem öffnen. Das ist Gatekeeper – macOS blockiert standardmäßig unbekannte Entwickler.
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.