Agent-Installationsprobleme unter Windows beheben

Erfahre, wo du die Installationsprotokolle des octoja Agent findest und wie du typische Windows-Installationsfehler wie 1603 löst.

Wenn sich der octoja Agent auf einem Windows-Gerät nicht installieren lässt, steht die Antwort fast immer in einer der Protokolldateien des Installers. Dieser Artikel zeigt dir, wo diese Protokolle liegen und wie du die häufigsten Installationsfehler behebst.

Wo du die Protokolle findest

ProtokollSpeicherort
Installationsskript-ProtokollC:\ProgramData\octoja GmbH\install.log — alles, was der Schnellinstallations-Befehl ausgegeben hat, einschließlich der Voraussetzungsprüfungen
MSI-ProtokollC:\ProgramData\octoja GmbH\install.msi.log — das ausführliche Windows-Installer-Protokoll; suche darin nach return value 3, um die fehlschlagende Aktion zu finden
Agent-ProtokolleC:\Program Files\octoja GmbH\logs — Laufzeitprotokolle des installierten Agent, hilfreich wenn die Installation gelang, das Gerät aber nicht erscheint

Häufige Fehler

SymptomLösung
msiexec exited with code 16031603 ist der generische „schwerwiegende Fehler“ des Windows Installers — die eigentliche Ursache steht im MSI-Protokoll (siehe oben). Die üblichen Verdächtigen: Die Shell war nicht erhöht (PowerShell als Administrator ausführen), auf älterem Windows fehlt eine Voraussetzung (.NET Framework 4.7.2, Visual C++ Redistributable), ein Sicherheitsprodukt hat den Installer blockiert (siehe Antivirus-Ausnahmen für den octoja Agent konfigurieren), oder eine halb entfernte frühere Installation ist im Weg (siehe Neuinstallation unten)
octoja Agent is already installed on this computer — nothing to doDer Installer hat den Dienst Octoja.Launcher gefunden und ohne Änderung gestoppt. Das ist beabsichtigt — entferne den Agent zuerst (siehe unten) und führe den Installationsbefehl danach erneut aus
Die zugrunde liegende Verbindung wurde geschlossen: Unbekannter Fehler beim Empfangen auf Windows Server 2016 oder älterDas ist der ältere Protokollfehler. Aktiviere TLS 1.2 in derselben PowerShell-Sitzung und führe den Installationsbefehl erneut aus — den genauen Befehl findest du in Agent auf Windows bereitstellen. Das gilt auch, wenn der Befehl während einer Migration über ein anderes RMM verteilt wird
Resolve installer URL endet mit Für den geschützten SSL/TLS-Kanal konnte keine Vertrauensstellung hergestellt werdenDas ist ein Fehler in der Zertifikatskette, kein Fehler der Protokollversion. Führt eine Firewall oder ein Proxy eine SSL-/TLS-Deep-Inspection durch, bitte deinen Netzwerkadministrator, sowohl die vollständige URL deiner octoja-Instanz als auch cdn.octoja.com davon auszunehmen. Öffne auf dem betroffenen Gerät beide Adressen im Browser und prüfe jeweils den Zertifikatsaussteller; ein Aussteller deiner Firewall, deines Proxys oder deiner Organisation bestätigt die Deep Inspection. Die Verbindungstests für beide Ziele findest du unter Agent auf Windows bereitstellen
Intune meldet 0x80070667Die Befehlszeilenargumente der branchenspezifischen App sind fehlerhaft — siehe Agent über Microsoft Intune bereitstellen

Agent sauber neu installieren

Eine Neuinstallation ist der richtige Weg, wenn die Installation defekt ist — zum Beispiel nachdem das Gerät auf einen Systemwiederherstellungspunkt zurückgesetzt wurde und der Agent sich nicht mehr verbindet, oder wenn Agent-Dateien teilweise entfernt wurden.

  • Öffne auf dem Gerät Einstellungen → Apps → Installierte Apps, suche octoja Agent und deinstalliere ihn.
  • Fehlt der Eintrag dort, aber der Installer meldet weiterhin „already installed“, ist der Dienst Octoja.Launcher noch registriert. Folge Den Agent von einem Gerät entfernen, um die Reste von der Maschine zu nehmen.
  • Führe den Schnellinstallations-Befehl aus Administration → Agent-Bereitstellung erneut aus. Das Gerät registriert sich neu und meldet sich innerhalb von 1–2 Minuten wieder unter Geräte.

Kommst du nicht weiter?

Prüfe Erreichbarkeit & Status von octoja auf aktuell bekannte Einschränkungen und eröffne einen Support-Fall mit den beiden Installationsprotokollen im Anhang — damit kann der Support den fehlschlagenden Schritt sofort eingrenzen. Wie das geht, zeigt Logs für einen Support-Fall sammeln.