Den Agent von einem Gerät entfernen

Deinstalliere den octoja Agent unter Windows, macOS und Linux — und erfahre, was das Löschen eines Geräts aus dem octoja-Inventar auf dem Gerät selbst bewirkt.

Geschrieben von Stefan Steuer

Zuletzt aktualisiert Vor 25 Tagen

Diese Anleitung zeigt dir, wie du den octoja Agent von einem Windows-, macOS- oder Linux-Gerät entfernst — und was dabei in octoja passiert. Es gibt zwei Wege: Du löschst das Gerät in octoja und der Agent entfernt sich selbst, oder du deinstallierst den Agent lokal auf dem Gerät.

Deinstalliert das Löschen eines Geräts auch den Agent?

Ja. Wenn du ein Gerät aus dem octoja-Inventar löschst, deinstalliert sich der Agent auf diesem Gerät selbst:

Das Gerät ist …	Was passiert
online	Der Agent wird sofort benachrichtigt, startet seinen Plattform-Uninstaller und entfernt sich innerhalb weniger Augenblicke.
offline	Der Agent deinstalliert sich beim nächsten Mal, wenn er sich mit octoja verbindet.
endgültig weg (neu aufgesetzt, verkauft, verschrottet)	Auf dem Gerät kann nichts mehr die Entfernung auslösen. Falls das Gerät noch existiert, deinstalliere den Agent manuell — siehe die Plattform-Abschnitte unten.

Der Umkehrschluss ist genauso wichtig: Weil das Löschen eines Geräts auch seinen Agent deinstalliert, lösche einen Geräteeintrag nie nur zum Aufräumen deiner Liste, solange der Agent auf dem Gerät weiterlaufen soll.

Welchen Weg solltest du wählen?

Das Gerät wird noch verwaltet und ist erreichbar: Lösche es in octoja. Ein Schritt entfernt sowohl den Inventar-Eintrag als auch den Agent — du musst vorher nicht deinstallieren.
Das Gerät ist bereits neu aufgesetzt oder weg: Lösche den Eintrag in octoja. Mehr ist nicht nötig.
Das Gerät bleibt im Einsatz, aber ohne octoja: Deinstalliere den Agent lokal (unten) und lösche den Geräteeintrag, sobald er als offline angezeigt wird.

Das Gerät in octoja löschen

Gehe in octoja zu Geräte und öffne das Gerät.
Öffne das …-Menü oben rechts auf der Geräteseite und wähle Gerät löschen. Du brauchst die Berechtigung Gerät löschen, um diese Aktion zu sehen.
Bestätige mit Löschen. octoja warnt dich vorher — das Löschen kann nicht rückgängig gemacht werden.

Das Gerät verschwindet aus der Liste unter Geräte, und der Agent auf dem Gerät entfernt sich selbst wie oben beschrieben.

Manuell deinstallieren unter Windows

Öffne auf dem Gerät Einstellungen → Apps → Installierte Apps.
Suche octoja Agent (Herausgeber: octoja GmbH) und wähle Deinstallieren.

Die Deinstallation stoppt und entfernt beide Agent-Dienste (Octoja Agent und Octoja Launcher) und löscht die Programmdateien sowie die Verbindungseinstellungen.

Für eine unbeaufsichtigte Entfernung — zum Beispiel über deine Software-Verteilung — nutze die MSI-Datei, mit der du installiert hast:

msiexec /x octoja.Launcher.<version>.<arch>.msi /qn

Für ein vollständig sauberes Gerät: Nach der Deinstallation bleibt ein kleiner Datenordner unter C:\ProgramData\octoja GmbH zurück. Er enthält unter anderem die Identitätsdatei, die der Agent bei der Registrierung angelegt hat. Lösche den Ordner manuell — vor allem, bevor du den Agent auf diesem Gerät noch einmal neu installierst.

Manuell deinstallieren unter macOS

Der Agent bringt sein eigenes Deinstallations-Skript mit. Öffne Terminal (Programme → Dienstprogramme → Terminal) und führe aus:

sudo /opt/octoja/uninstall.sh

Das Skript stoppt beide Agent-Dienste (com.octoja.launcher und com.octoja.agent), entfernt ihre Einträge aus /Library/LaunchDaemons, löscht den kompletten Ordner /opt/octoja und entfernt die macOS-Paketquittung. Der Agent hält alle seine Dateien, Einstellungen und Logs unter /opt/octoja — es bleibt also nichts zurück, das ist die vollständige Entfernung.

Manuell deinstallieren unter Linux

Der Agent ist als Paket octoja installiert. Entferne ihn über den Paketmanager:

sudo apt purge octoja

Die beiden Dienste (octoja-launcher und octoja-agent) werden beim Entfernen automatisch gestoppt und deaktiviert. Beachte den Unterschied zwischen den beiden Paketmanager-Befehlen:

Befehl	Was entfernt wird
`sudo apt remove octoja`	Nur Programme und Dienste — die Konfiguration in `/etc/octoja` und die Dateien unter `/opt/octoja` bleiben auf der Platte.
`sudo apt purge octoja`	Alles, einschließlich `/opt/octoja` und `/etc/octoja`. Nutze diesen Befehl für die vollständige Entfernung.

Wenn du direkt mit dpkg arbeitest, ist sudo dpkg -P octoja das Gegenstück zum Purge-Befehl.

Danach in octoja

Hast du das Gerät in octoja gelöscht, bist du fertig — der Eintrag ist weg und kann nicht wiederhergestellt werden.

Hast du den Agent stattdessen lokal deinstalliert, bleibt der Geräteeintrag in octoja bestehen: Er wechselt kurz darauf auf offline und liefert keine Daten mehr. Lösche den Eintrag über die Geräteseite (siehe oben), wann immer du bereit bist. Lässt du ihn stehen, bleibt er einfach ein Offline-Gerät in deiner Liste.

Um ein Gerät später wieder aufzunehmen, installiere den Agent erneut über den normalen Bereitstellungsweg — siehe die Anleitungen unten.