Zum Inhalt springen
  •  +49 (861) 88 00 32 00
COD powered by extocode GmbH
  • 0
  • Anmelden
  • English (US) Français Deutsch Español Türkçe
  • Demo öffnen
  • Home
  • COD Überblick
    Plattform
    ÜberblickPlattform: Mandanten und MarkeFunktionsübersichtProbleme & LösungenArchitekturDokumentationIntegrationenPreise
    Betrieb & Netzwerk
    MonitoringNetzwerkNetwork Access Control (NAC)TACACS+Captive PortalFirewall
    Sicherheit & Resilienz
    Governance, Risk & ComplianceBackupHypervisorOTPPasskeeprAutomatisierung
    Lösungen & Mehr
    NIS2 & CompliancecodPassKI-Dokumentation (Zusatzmodul InfraScan)Demo öffnenReferenzenDownloadsFAQ
  • Preise
  • Neuigkeiten
    • Blog
    • Roadmap
  • FAQ
  • Über uns
    • Über uns
    • Karriere
    • Partner
    • Referenzen
  • Academy
  • Kontakt
COD powered by extocode GmbH
  • 0
    • Home
    • COD Überblick
    • Preise
    • Neuigkeiten
      • Blog
      • Roadmap
    • FAQ
    • Über uns
      • Über uns
      • Karriere
      • Partner
      • Referenzen
    • Academy
    • Kontakt
  •  +49 (861) 88 00 32 00
  • English (US) Français Deutsch Español Türkçe
  • Anmelden
  • Demo öffnen
  1. Start
  2. Dokumentation
  3. Fehlerbilder

Fehlerbilder

Diese Seite sammelt bekannte Fehlerbilder mit Symptom, Ursache und Lösung. Am Ende stehen die Befehle für die Diagnose.

Stand: November 2026, COD 3.8.6

Inhalt der Dokumentation
  • Übersicht
  • Erste Schritte
  • Voraussetzungen
  • Namen und Adressen
  • Netzgeräte
  • Zeit und DNS
  • Installation
  • Aufbauformen
  • Ersteinrichtung
  • Updates
  • Module
  • Fehlerbilder
  • Sicherheit
  • Versionen
  • Versionsverlauf
  • Support

Dokumentation

  • Übersicht
  • Erste Schritte
  • Voraussetzungen
  • Namen und Adressen
  • Netzgeräte
  • Zeit und DNS
  • Installation
  • Aufbauformen
  • Ersteinrichtung
  • Updates
  • Module
  • Fehlerbilder
  • Sicherheit
  • Versionen
  • Versionsverlauf
  • Support

Übersicht

BereichFehlerbild
NetzwerkKeine Verbindung zwischen zwei Switches in Layer 2
NetzwerkGerät fehlt in der Topologie
Netzwerk„port discovery failed“
NetzwerkAbfrage gilt als fehlgeschlagen, obwohl SSH lief
NetzwerkFehler bei der Abfrage wegen unbekanntem Hersteller
MikroTikKeine Routen und leere Live-Anzeigen
Backup„All configured authentication methods failed“
Backup„Permission denied“ beim Download
BackupHost steht auf ERROR wegen Namensprüfung
NACKeine NAC-Sitzungen am Port
AnmeldungAnmeldung über HTTP scheitert
AnmeldungTerminal oder Passkeepr hängen hinter einem Reverse Proxy
PasskeeprBrowser-Erweiterung wird abgewiesen
ModuleModul nach der Freischaltung nicht sichtbar
ModuleFeld für die TACACS+-Adresse fehlt
BetriebAudit-Status „degraded“
MonitoringVerknüpfung zu Zabbix nach Umbenennen weg
FirewallFirewall erscheint nicht im Modul
InstallationAnsible-Rollout bricht nach Adresswechsel ab
InstallationFehler nach einer Neuinstallation

Netzwerk und Topologie

Keine Verbindung zwischen zwei Switches in Layer 2

  • Symptom: Zwei Switches sind verbunden. Die Layer-2-Karte zeigt keine Verbindung.
  • Ursache: COD ordnet einen LLDP-Nachbarn über seinen Systemnamen einem Asset zu. Weicht der Name auch nur in einem Zeichen vom Asset-Namen ab, entsteht keine Verbindung. Oder der Switch sendet den Systemnamen nicht per LLDP.
  • Lösung: Asset-Name und Hostname des Geräts angleichen. LLDP auf allen Switch- und Router-Ports senden und empfangen, mit system-name, system-description, system-capabilities, management-address und port-description. Bei manchen Herstellern schalten Sie das je Port ein.

Mehr dazu unter Netzgeräte vorbereiten und Namen und Adressen.

Gerät fehlt in der Topologie

  • Symptom: Kameras, Speichersysteme, Haustechnik oder andere Endgeräte erscheinen nicht in der Layer-2-Karte.
  • Ursache: COD zeichnet Verbindungen aus den LLDP-Daten von Switches und Routern. Geräte ohne LLDP erscheinen nie automatisch.
  • Lösung: Zeichnen Sie diese Geräte von Hand in die Topologie. Ihre Verfügbarkeit überwachen Sie über die Zabbix-Anbindung.

„port discovery failed“

  • Symptom: Ein Netzwerkobjekt bleibt im Status „port discovery failed“.
  • Ursache: Das Gerät liefert per SNMP keine Port-MIB (IF-MIB). Das betrifft vor allem kleine Switches.
  • Lösung: Prüfen Sie, ob das Gerät die IF-MIB per SNMP beantwortet. Liefert es keine, erfasst COD seine Ports nicht. Zeichnen Sie das Gerät bei Bedarf von Hand in die Topologie.

Abfrage gilt als fehlgeschlagen, obwohl SSH lief

  • Symptom: Die Abfrage eines Netzwerkobjekts gilt als fehlgeschlagen. Daten per SSH, etwa LLDP-Nachbarn oder Clients, kommen trotzdem an.
  • Ursache: Scheitert die Port-Discovery per SNMP, gilt die ganze Abfrage als fehlgeschlagen, auch wenn SSH lief.
  • Lösung: SNMP am Gerät prüfen. COD fragt SNMP v1 und v2c mit Community ab. Die Community muss stimmen, die Zugriffsliste am Gerät muss die Quelladresse von COD erlauben, und die Port-MIB muss antworten.

Fehler bei der Abfrage wegen unbekanntem Hersteller

  • Symptom: Die Abfrage eines Netzwerkobjekts endet mit einem Fehler.
  • Ursache: Hersteller und Modellfamilie am Asset entscheiden, welcher Sammler läuft. Ein unbekannter Hersteller ergibt einen Fehler.
  • Lösung: Hersteller und Familie am Asset richtig aus dem Katalog wählen. COD erfasst Geräte von Allied Telesis, Arista, Aruba, Cisco, Extreme, Juniper, MikroTik, Ruijie und Sophos. Mehr dazu unter Integrationen.

MikroTik: keine Routen und leere Live-Anzeigen

  • Symptom: Die Layer-3-Karte zeigt für einen MikroTik-Router keine Routen. Die Live-Anzeigen bleiben leer.
  • Ursache: COD liest Routen, Adressen, Nachbarn und Schnittstellen über die REST-Schnittstelle von RouterOS. Ist die Schnittstelle am Router aus oder für COD gesperrt, bleiben die Daten leer. Außerdem gilt: Bearbeiten Sie einen Router in COD, während er nicht erreichbar ist, löscht COD seine gespeicherten Routen.
  • Lösung: Für den MikroTik-Abgleich muss die REST-Schnittstelle des Routers für COD erreichbar sein. Einzelheiten erhalten Sie im Projekt. Beschränken Sie den Zugang auf die Quelladresse von COD und legen Sie für COD einen eigenen Benutzer mit kleinen Rechten an. Bearbeiten Sie Router nur, wenn sie erreichbar sind. Die Mindestrechte erhalten Sie im Projekt.

Mehr dazu unter Netzwerk und MikroTik.

Backup

„All configured authentication methods failed“

  • Symptom: Sicherungen scheitern mit „All configured authentication methods failed“, obwohl die Zugangsdaten stimmen.
  • Ursache: Zu viele gleichzeitige SSH-Sitzungen gegen dasselbe Ziel. RouterOS erlaubt zum Beispiel 20 SSH-Sitzungen.
  • Lösung: Startzeiten der Sicherungen staffeln, wenn viele Sicherungen über denselben Weg laufen.

„Permission denied“ beim Download

  • Symptom: Eine Sicherung vom Typ Download scheitert mit „Permission denied“.
  • Ursache: Ein Unterordner ist für den Benutzer der Sicherung nicht lesbar. Ein einziger solcher Ordner bricht den ganzen Download ab. Ein regulärer Ausdruck in der Vorlage verhindert das nicht.
  • Lösung: Dem Benutzer Leserecht auf alle Unterordner geben oder einen Ordner ohne gesperrte Unterordner sichern. Dateien und Ordner mit führendem Punkt überspringt der Download ohnehin.

Host steht auf ERROR wegen Namensprüfung

  • Symptom: Ein Backup-Host steht auf ERROR.
  • Ursache: „Check Server Name“ ist eingeschaltet, und der Hostname am Gerät weicht vom „Server Name“ in COD ab.
  • Lösung: Hostname am Gerät und „Server Name“ angleichen. Mehr dazu unter Namen und Adressen.

Mehr zum Modul unter Backup.

NAC

Keine NAC-Sitzungen am Port

  • Symptom: Geräte melden sich per RADIUS an. Im Port-Dialog unter „Port History“ erscheinen trotzdem keine NAC-Sitzungen.
  • Ursache: Der Switch sendet RADIUS nicht von seiner Management-Adresse.
  • Lösung: Die Quelladresse für RADIUS am Switch auf die Management-Adresse setzen. Senden Sie auch Accounting, damit COD Statistiken zeigt.

Mehr dazu unter NAC.

Anmeldung und Zugriff

Anmeldung über HTTP scheitert

  • Symptom: Die Anmeldung über eine Adresse mit http:// funktioniert nicht.
  • Ursache: COD setzt seine Sitzungs-Cookies nur für sichere Verbindungen. HTTPS ist Pflicht, außer lokal auf dem COD-Server.
  • Lösung: HTTPS einrichten. Die Wege stehen unter Ersteinrichtung: HTTPS.

Terminal oder Passkeepr hängen hinter einem Reverse Proxy

  • Symptom: Hinter einem Reverse Proxy baut das Terminal keine Sitzung auf, oder Passkeepr hängt.
  • Ursache: Das Terminal braucht WebSocket, Passkeepr braucht Server-Sent Events. Der Proxy lässt eines davon nicht durch.
  • Lösung: WebSocket und Server-Sent Events am Proxy durchlassen und in COD „trust proxy“ einschalten. Eine Beispielkonfiguration erhalten Sie im Projekt.

Browser-Erweiterung von Passkeepr wird abgewiesen

  • Symptom: COD weist die Browser-Erweiterung von Passkeepr ab.
  • Ursache: Die Fassung der Erweiterung ist zu alt. Seit COD 3.8.6 ist mindestens Fassung 3.3.6 nötig.
  • Lösung: Die aktuelle Erweiterung aus Passkeepr installieren. Sie braucht Chrome ab 137 oder Firefox ab 140.

Mehr dazu unter Passkeepr.

Module

Modul nach der Freischaltung nicht sichtbar

  • Symptom: Ein Modul ist am Mandanten freigeschaltet, erscheint aber nicht.
  • Ursache: Die Freischaltung wirkt erst nach einer neuen Anmeldung.
  • Lösung: Ab- und wieder anmelden. Für Passkeepr braucht Ihre Rolle zusätzlich das Recht auf das Modul.

Feld für die TACACS+-Adresse fehlt

  • Symptom: Unter „Location > Module URLs“ fehlt das Feld für TACACS+.
  • Ursache: Das Feld erscheint nur, wenn am Mandanten zusätzlich NAC, Backup oder Passkeepr freigeschaltet ist.
  • Lösung: Klären Sie die Freischaltung mit Ihrem Partner. Die eingetragene Adresse muss auf /api/v1 enden.

Mehr dazu unter TACACS+.

Betrieb, Monitoring und Firewall

Audit-Status „degraded“

  • Symptom: Der Audit-Status steht auf „degraded“.
  • Ursache: Auf dem COD-Server, einem Datenbankserver oder einem Modul-Server fehlt der Zeitabgleich.
  • Lösung: NTP auf allen beteiligten Servern einrichten. Mehr dazu unter Zeit und DNS.

Verknüpfung zu Zabbix nach Umbenennen weg

  • Symptom: Ein Asset ist am nächsten Tag nicht mehr mit seinem Zabbix-Host verknüpft.
  • Ursache: Der Host wurde in Zabbix umbenannt. Der nächtliche Abgleich vergleicht ganze Namen und löst die Verknüpfung.
  • Lösung: Asset-Name und Zabbix-Hostname gleich halten. Danach das Asset über die Liste der nicht überwachten Assets wieder verknüpfen. COD löscht nie Hosts in Zabbix.

Mehr dazu unter Monitoring.

Firewall erscheint nicht im Modul

  • Symptom: Eine Firewall erscheint nicht im Modul Firewall.
  • Ursache: Das Modul braucht den eingebauten Asset-Typ „Firewall“, ein aktiviertes Asset und einen gesetzten Hersteller. Wurde der Typ umbenannt, erkennt COD die Firewall nicht.
  • Lösung: Den eingebauten Typ „Firewall“ nicht umbenennen. Asset aktivieren und Hersteller setzen.

Mehr dazu unter Firewall.

Installation

Ansible-Rollout bricht nach Adresswechsel ab

  • Symptom: Nachdem sich die öffentliche Adresse von COD geändert hat, brechen Ansible-Rollouts ab.
  • Ursache: Der Name, unter dem COD erreichbar ist, zählt für die Herkunftsprüfung im Browser, das Zertifikat und den Aussteller der Anmelde-Tokens.
  • Lösung: Ansible für die betroffenen Standorte neu ausrollen. Legen Sie den Namen von COD vor der Installation fest.

Fehler nach einer Neuinstallation

  • Symptom: Nach Entfernen und Neuinstallation auf demselben Host treten Fehler auf.
  • Ursache: apt purge lässt Konfiguration und Daten liegen. Der Cache (Redis bzw. Valkey) enthält noch Einträge der alten Installation.
  • Lösung: Den Cache vor der Neuinstallation leeren. Mehr dazu unter Updates: Entfernen.

Diagnose

Führen Sie diese Befehle auf dem betroffenen Host aus.

BefehlWas er zeigt
systemctl list-units 'cod-*'Zustand aller COD-Dienste auf dem Host
journalctl -u Protokoll eines Dienstes, etwa journalctl -u cod-backend
curl -sk https://localhost/api/healthZustand von COD. Erwartet ist {"status":"ok"}
apt policy cod-backendinstallierte und verfügbare Version

In der Oberfläche zeigt „Admin Area > Log“ die Protokolle von COD. Über „Service“ wählen Sie auch die Dienste wie NAC, Backup, Passkeepr und TACACS+.

An den Support

Erste Anlaufstelle ist Ihr Partner. Welche Angaben Sie für eine Anfrage bereithalten, steht unter Support. Technische Rückfragen an extocode stellen Sie über das Helpdesk-Formular. Mehr dazu unter Support.

Weiterführend

  • Voraussetzungen
  • Installation prüfen
  • Module
  • Support
  • FAQ: Support und Hilfe
← Zurück: Inventar und CMDB-ImportWeiter: Sicherheit →
Folgen Sie uns
​
  • COD Überblick
  • Funktionen
  • Demo
  • Preise
  • Integrationen
  • NIS2
  • codPass
  • Referenzen

Hilfe

  • FAQ
  • Dokumentation
  • Downloads
  • Kontakt

Kotzinger Straße 21 • 83278 Traunstein • Deutschland

  • ​+49 (861) 88 00 32 00
  • ​info@extocode.com
Datenschutz Impressum ​
Copyright © extocode GmbH
English (US) Français Deutsch Español Türkçe

Wir verwenden Cookies auf dieser Website, um Ihnen ein besseres Nutzererlebnis zu bieten. Datenschutz-Richtlinien

Ablehnen Zustimmen