---
title: "Fehlerbehebung"
description: "Fehlerbehebung für LumiScan Cockpit auf ctrlX OS und auf einem PC - allgemeine Prüfungen, das Cockpit öffnen, Ansichten und Ergebnisse, Live-Aktualisierung, Overlays und was Sie an den Support senden."
product: "LumiScan Cockpit"
component: "lumiscan-cockpit-de"
version: "1.2.0"
display_version: "1.2.0.8"
latest_version: true
language: "de"
url: "https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html"
---

# Fehlerbehebung – LumiScan Cockpit

Beginnen Sie mit den [Allgemeine Prüfungen](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#general-checks): Sie helfen bei jedem Problem mit LumiScan Cockpit. Suchen Sie dann Ihr Symptom in den folgenden Abschnitten und arbeiten Sie dessen Schritte der Reihe nach ab. Der letzte Abschnitt nennt, was Sie an den Support senden, wenn das Problem weiterhin besteht.

## Allgemeine Prüfungen {#general-checks}

Prüfen Sie zuerst diese Punkte:

- **Die Anwendungen laufen auf demselben Gerät.** Das Cockpit zeigt die Daten anderer Anwendungen an: Die Anwendungen, deren Bilder und Ergebnisse es zeichnet, müssen auf derselben ctrlX CORE, demselben ctrlX IPC oder demselben PC laufen. Für sich allein zeigt das Cockpit eine leere Übersicht. Siehe [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/requirements.html).

- **Die Anwendungsübersicht.** Sie führt alle kompatiblen Anwendungen von HD Vision Systems auf, die gerade laufen, und die Ansichten, die jede von ihnen bietet. Siehe [Das Cockpit öffnen](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/opening-the-cockpit.html).

- **Auf einem PC: dieselbe Broker-Adresse.** Das Cockpit und die Anwendungen müssen dieselbe Adresse verwenden. Ohne Optionen tun sie das alle; eine mit `--keryx-url` übergebene Adresse muss jeder von ihnen übergeben werden. Ist LumiScan Keryx installiert, zeigt die Data-Layer-Seite `http://127.0.0.1:7555/` den Baum. Siehe [Broker, Fenster und Seiten (PC)](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/opening-the-cockpit.html#windows).

- **Die Einstellungsdatei wird einmal, beim Start, gelesen.** Nur die Einstellungen der Live-Ansicht, die im Einstellungsfenster geändert werden, gelten sofort. Siehe [Overlays](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/overlays.html).

- **Das Log.**

  | Plattform | Log |
  | --- | --- |
  | ctrlX OS | das Systemprotokoll von ctrlX OS: das Logbuch der ctrlX-Weboberfläche oder `journalctl`. Siehe [ctrlX Data Layer auf ctrlX OS](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/ctrlx-data-layer.html) |
  | Windows | `%LOCALAPPDATA%\LumiScan Cockpit\logs\lumiscan-cockpit.log`. Aus einer Konsole als `lumiscan-cockpit` gestartet, schreibt das Cockpit sein Log auch in diese Konsole |

## Das Cockpit öffnen {#opening-cockpit}

### Problem: Auf ctrlX OS beendet sich das Cockpit kurz nach dem Start {#ts-shuts-down-after-start}

**Symptome**

Auf ctrlX OS beendet sich die Anwendung Cockpit kurz nach dem Start.

**Mögliche Ursachen**

- Die Lizenz fehlt. Die ctrlX-Lizenz für LumiScan Cockpit ist `SWL-W-XCx-COCKPITxxxHDVSx-V1NN`.

**Diagnose**

1. Lesen Sie das Systemprotokoll von ctrlX OS - erwartet: Es nennt den Grund, warum sich die Anwendung beendet hat.
2. Prüfen Sie die Seitenleiste der ctrlX-Weboberfläche - erwartet: der Link **LumiScan Cockpit**. Die Anwendung fügt ihn hinzu, wenn sie installiert ist und läuft.

**Lösung**

- **Wenn die Lizenz fehlt:** Aktivieren Sie die ctrlX-Lizenz `SWL-W-XCx-COCKPITxxxHDVSx-V1NN` auf dem Gerät und starten Sie die Anwendung dann erneut. Siehe [Lizenz](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/requirements.html#licence) und [LumiScan Lizenzierung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/path-ctrlx-os.html).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit den Zeilen des Systemprotokolls, die den Grund nennen.

### Problem: Auf einem PC meldet das Cockpit, dass sein Port belegt ist, und beendet sich {#faq-port-taken}

**Symptome**

Auf einem PC zeigt das Cockpit eine Meldung, dass sein Port belegt ist, und beendet sich.

**Mögliche Ursachen**

- Das Cockpit liefert seine Seiten auf Port 8000 aus. Ein anderes Programm verwendet diesen Port bereits.
- Ein mit `--no-gui` gestartetes Cockpit verwendet diesen Port bereits.

**Diagnose**

1. Prüfen Sie, ob ein mit `--no-gui` gestartetes Cockpit läuft - erwartet: keines, wenn Sie das Cockpit mit seinem Fenster starten wollen.
2. Prüfen Sie, ob ein anderes Programm Port 8000 verwendet.

**Lösung**

- **Wenn ein anderes Programm oder ein mit `--no-gui` gestartetes Cockpit den Port verwendet:** Beenden Sie es und starten Sie das Cockpit dann erneut.
- **Wenn der Port beim anderen Programm bleiben muss:** Starten Sie das Cockpit mit `--port` und einem anderen Port.

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit der Meldung des Cockpits und den Optionen, mit denen es gestartet wurde.

### Problem: Unter Windows öffnet sich das Cockpit im Browser statt in seinem eigenen Fenster {#faq-no-window}

**Symptome**

Unter Windows öffnet das Cockpit seine Seiten im Standardbrowser statt in seinem eigenen Fenster und zeigt eine Meldung. Ein Klick auf **OK** in der Meldung beendet das Cockpit.

**Mögliche Ursachen**

- Die Microsoft Edge WebView2 Runtime fehlt. Das Fenster des Cockpits zeigt seine Seiten mit ihr.

**Diagnose**

1. Prüfen Sie, ob das Cockpit mit `--no-gui` gestartet wurde - erwartet: nein, wenn Sie sein Fenster wollen. Mit `--no-gui` öffnet das Cockpit bestimmungsgemäß kein Fenster.
2. Prüfen Sie, ob die Microsoft Edge WebView2 Runtime auf dem PC installiert ist.

**Lösung**

- **Wenn die WebView2 Runtime fehlt:** Installieren Sie sie und starten Sie das Cockpit dann erneut. Oder verwenden Sie das Cockpit im Browser.

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit der Meldung des Cockpits.

### Problem: Die Übersicht zeigt keine Anwendungen {#faq-overview-empty-pc}

**Symptome**

Die Anwendungsübersicht führt keine Anwendungen auf.

**Mögliche Ursachen**

- Die Anwendungen laufen nicht.
- Die Anwendungen laufen nicht auf demselben Gerät wie das Cockpit.
- Auf einem PC: Das Cockpit und die Anwendungen verwenden nicht denselben Broker. Eine mit `--keryx-url` übergebene Adresse wurde nicht jeder von ihnen übergeben.
- Auf einem PC: Es wurde kein Broker gestartet. Das passiert bei einer `ipc://`-Adresse relativ zu dem Ordner, in dem ein Programm gestartet wird, und bei `--no-keryx-autostart` oder `LUMISCAN_KERYX_AUTOSTART=0`.

**Diagnose**

1. Prüfen Sie, ob die Anwendungen auf demselben Gerät wie das Cockpit laufen.
2. Vergleichen Sie auf einem PC die Optionen, mit denen das Cockpit und die Anwendungen gestartet wurden - erwartet: dieselbe `--keryx-url` oder keine.
3. Öffnen Sie auf einem PC mit LumiScan Keryx die Data-Layer-Seite `http://127.0.0.1:7555/` - erwartet: Der Baum zeigt die laufenden Anwendungen.

**Lösung**

- **Wenn die Anwendungen nicht laufen:** Starten Sie sie.
- **Wenn die Anwendungen auf einem anderen Gerät laufen:** Betreiben Sie sie auf demselben Gerät wie das Cockpit.
- **Wenn sie unterschiedliche Broker-Adressen verwenden:** Übergeben Sie jeder Anwendung, auch dem Cockpit, dieselbe `--keryx-url`, oder starten Sie alle ohne die Option.
- **Wenn kein Broker gestartet wurde:** Starten Sie zuerst selbst `krxsystem --backend hdv --url <address>`. Bei einer relativen `ipc://`-Adresse starten Sie den Broker und jede Anwendung aus demselben Ordner.

Siehe auch [Fehlerbehebung Data Layer: der Broker](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html#no-broker) und [Fehlerbehebung Data Layer: eine App fehlt](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html#app-missing).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit den Optionen, mit denen das Cockpit und die Anwendungen gestartet wurden.

## Ansichten und Ergebnisse {#views-and-results}

### Problem: Eine Ansicht zeigt eine Meldung statt eines Bildes {#faq-view-nothing-to-show}

**Symptome**

Eine Ansicht nennt den Grund, warum sie nichts zu zeigen hat, statt einen leeren Frame zu zeigen.

**Mögliche Ursachen**

- Die Anwendung hat noch kein Bild erzeugt.
- Es ist keine Bildquelle konfiguriert. Die acht Anwendungen, die Funde zeichnen, lesen ihr Bild von anderswo, und das Cockpit folgt der `input-image-address` des Moduls, um es zu finden.
- Das Ergebnis gehört zu einer anderen Bildgröße, siehe [Problem: Funde werden nicht gezeichnet, und ein Hinweis nennt die Größe, zu der das Ergebnis gehört](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#faq-findings-not-drawn).

**Diagnose**

1. Lesen Sie den Grund, den die Ansicht nennt.
2. Bei einer veröffentlichenden Anwendung: Prüfen Sie, ob sie seit ihrem Start gelaufen ist.
3. Bei einer der acht Anwendungen, die Funde zeichnen: Lesen Sie die `input-image-address` des Moduls - erwartet: der Bildknoten einer Kamera.

**Lösung**

- **Wenn die Anwendung noch kein Bild erzeugt hat:** Führen Sie die veröffentlichende Anwendung einmal aus.
- **Wenn keine Bildquelle konfiguriert ist:** Richten Sie das Modul zuerst auf den Bildknoten einer Kamera.
- **Wenn das Ergebnis zu einer anderen Bildgröße gehört:** Siehe [Problem: Funde werden nicht gezeichnet, und ein Hinweis nennt die Größe, zu der das Ergebnis gehört](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#faq-findings-not-drawn).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit dem Grund, den die Ansicht nennt, und der `input-image-address` des Moduls.

### Problem: Funde werden nicht gezeichnet, und ein Hinweis nennt die Größe, zu der das Ergebnis gehört {#faq-findings-not-drawn}

**Symptome**

Die Ansicht zeigt das Bild ohne Funde, und ein Hinweis nennt die Bildgröße, zu der das Ergebnis gehört.

**Mögliche Ursachen**

- Das letzte Ergebnis wurde in einem Kamerabild mit einer anderen Größe als dem angezeigten gefunden, meist weil sich die Kameraauflösung nach dem letzten Lauf geändert hat.

**Diagnose**

1. Vergleichen Sie die Größe im Hinweis mit der aktuellen Kameraauflösung - erwartet: Sie unterscheiden sich.

**Lösung**

- **Wenn sich die Kameraauflösung nach dem letzten Lauf geändert hat:** Führen Sie die Anwendung erneut aus, um das Ergebnis für die neue Auflösung zu erneuern.

Siehe [Der Ansichtsbereich](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/the-view-region.html).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit der Größe aus dem Hinweis und der Kameraauflösung.

### Problem: Eine Ansicht von AI Object Matching auf einem Stream zeigt **approximate** {#faq-ai-approximate}

**Symptome**

Die Live-Ansicht eines Moduls von AI Object Matching zeigt den Hinweis **approximate**. Während sich die Szene bewegt, kann eine Box etwas versetzt sein.

**Mögliche Ursachen**

- Das Modul hat für die Inferenz länger gebraucht, als das Cockpit die letzten Frames der Kamera (64 MB) vorhält. Der Frame, in dem das Ergebnis gefunden wurde, wird nicht mehr vorgehalten; die Boxen werden daher auf den neuesten Frame gezeichnet.

**Diagnose**

1. Prüfen Sie, ob das Modul auf dem Bild-Stream einer Kamera inferiert - erwartet: Seine `control/subscribe/output/stream/active` ist `true`. Der Hinweis erscheint nur in einer solchen Live-Ansicht.

**Lösung**

- **Wenn der Frame nicht mehr vorgehalten wird:** Es ist nichts zu tun. Die Boxen werden auf den neuesten Frame gezeichnet und mit **approximate** markiert. Kommt ein Ergebnis rechtzeitig, werden seine Boxen auf genau den Frame gezeichnet, in dem es gefunden wurde.

Siehe [AI Object Matching auf einem Kamera-Stream](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/viewing-results.html#ai-on-a-stream).

**Wenn das Problem weiterhin besteht**

Wenden Sie sich mit den unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#support-information) genannten Informationen an den Support, wenn etwas versetzte Boxen für Ihre Anwendung ein Problem sind.

## Live-Aktualisierung {#live-updates}

### Problem: Eine Ansicht aktualisiert sich nur alle zwei Sekunden {#faq-view-updates-slowly}

**Symptome**

Eine Ansicht zeigt nur alle zwei Sekunden ein neues Bild.

**Mögliche Ursachen**

- Mehr als acht Ansichten streamen gleichzeitig, Einzelbilder oder live. Darüber hinaus fällt eine Ansicht darauf zurück, ihr Bild alle zwei Sekunden neu zu holen.
- Die Verbindung über einen Proxy erlaubt kein Streaming.

**Diagnose**

1. Zählen Sie die geöffneten Ansichten - erwartet: acht oder weniger.
2. Prüfen Sie, ob der Browser das Cockpit über einen Proxy erreicht.

**Lösung**

- **Wenn mehr als acht Ansichten geöffnet sind:** Schließen Sie Ansichten, die Sie nicht brauchen.
- **Wenn ein Proxy kein Streaming erlaubt:** Die Ansicht holt ihr Bild weiterhin alle zwei Sekunden neu. Das Bild bleibt korrekt; es kommt nur später an.

Siehe [Live-Aktualisierung](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/live-updates.html).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit der Anzahl der geöffneten Ansichten und der Angabe, ob ein Proxy verwendet wird.

### Problem: Eine Kamera streamt, aber ihre Ansicht zeigt Einzelbilder statt **LIVE** {#faq-live-view-still}

**Symptome**

Die Kamera streamt ihre Bilder, aber ihre Ansicht zeigt Einzelbilder, und **LIVE** erscheint nicht neben dem Namen der Ansicht.

**Mögliche Ursachen**

- Mehr als vier Live-Ansichten sind gleichzeitig offen, jeden Tab und jedes Fenster mitgezählt. Darüber hinaus zeigt eine Live-Ansicht Einzelbilder und versucht es alle fünf Sekunden erneut.
- Der Stream wurde nicht mit `control/publish/execute` von LumiScan Cam Driver gestartet. Erst dann wird eine Ansicht live. Die Ansicht eines Moduls von AI Object Matching wird live, wenn das Modul auf Kamera-Streams inferiert.
- Auf ctrlX OS: Die ctrlX-Weboberfläche reicht die Live-Ansicht nicht durch. Ob sie das tut, wurde noch nicht auf einem Gerät geprüft.

**Diagnose**

1. Zählen Sie die Live-Ansichten, die in allen Tabs und Fenstern offen sind - erwartet: vier oder weniger.
2. Lesen Sie an der Kamera `control/publish/output/stream/active` von LumiScan Cam Driver - erwartet: `true`. Siehe [Der Produzent: der Cam Driver](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/streams.html#producer).

**Lösung**

- **Wenn mehr als vier Live-Ansichten offen sind:** Schließen Sie Live-Ansichten, die Sie nicht brauchen. Die Ansicht versucht es alle fünf Sekunden erneut.
- **Wenn der Stream nicht gestartet wurde:** Starten Sie ihn mit `control/publish/execute` des Cam Driver. Siehe das Handbuch des Cam Driver, „Bilder streamen".
- **Wenn die ctrlX-Weboberfläche die Live-Ansicht nicht durchreicht:** Die Ansicht zeigt Einzelbilder. Das Bild bleibt korrekt; es kommt nur später an.

Siehe [Live-Ansicht](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/live-updates.html#live-view).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit der Anzahl der offenen Live-Ansichten und dem Wert von `control/publish/output/stream/active`.

## Overlays {#overlays}

### Problem: Eine Overlay-Änderung hat keine Wirkung, oder eine Form wird weiß gezeichnet {#faq-overlay-not-applied}

**Symptome**

Nachdem Sie die Einstellungsdatei des Cockpits bearbeitet haben, ändert sich das Overlay nicht; oder eine Form wird weiß statt in ihrer Farbe gezeichnet.

**Mögliche Ursachen**

- Das Cockpit wurde seit der Änderung nicht neu gestartet. Die Einstellungsdatei wird nur einmal, beim Start, gelesen.
- Der Wert von `color` kann nicht gelesen werden. Eine Farbe, die nicht gelesen werden kann, wird weiß gezeichnet statt abgelehnt.
- Eine Position oder Größe von `1.0` oder darüber ist in absoluten Pixeln angegeben: `1.0` ist ein Pixel, nicht der gegenüberliegende Rand oder die volle Breite.

**Diagnose**

1. Prüfen Sie, ob das Cockpit nach dem Bearbeiten der Datei neu gestartet wurde.
2. Prüfen Sie den Wert von `color` jeder weißen Form - erwartet: `red`, `green`, `blue`, `black`, `white`, `yellow`, `cyan`, `magenta` oder sechs Hexadezimalziffern `RRGGBB` (das darf entfallen).
3. Prüfen Sie `centerX`, `centerY`, `width` und `height` - erwartet: Werte unter `1.0`, wo Sie relative Werte meinen.

**Lösung**

- **Wenn das Cockpit nicht neu gestartet wurde:** Starten Sie die Anwendung Cockpit neu.
- **Wenn die Farbe nicht gelesen werden kann:** Korrigieren Sie den Tippfehler im Wert von `color` und starten Sie das Cockpit dann neu.
- **Wenn ein Wert von `1.0` als gegenüberliegender Rand oder volle Breite gemeint war:** Verwenden Sie einen Wert knapp unter `1.0` und starten Sie das Cockpit dann neu.

Siehe [Overlays](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/overlays.html).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit der Einstellungsdatei des Cockpits.

## Informationen für den Support {#support-information}

Wenden Sie sich an den Customer Success von HD Vision Systems unter [customer.success@hdvisionsystems.com](mailto:customer.success@hdvisionsystems.com) oder +49 6221 6721905; für Lizenzen an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com). Senden Sie bitte:

- die Version von LumiScan Cockpit;
- die Plattform: ctrlX OS mit seiner Version auf einer ctrlX CORE oder einem ctrlX IPC, oder einen PC und sein Betriebssystem;
- Datum und Uhrzeit des Fehlers;
- das Log: auf ctrlX OS aus dem Systemprotokoll (Logbuch der ctrlX-Weboberfläche oder `journalctl`); unter Windows `%LOCALAPPDATA%\LumiScan Cockpit\logs\lumiscan-cockpit.log`;
- den Kommunikationsstatus: die Anwendungen und Ansichten, die die Übersicht aufführt, und auf einem PC die Data-Layer-Adresse (`--keryx-url`), die dem Cockpit und den Anwendungen übergeben wurde;
- die Meldung oder den Hinweis, den die Ansicht zeigt;
- die Konfiguration: die Einstellungsdatei des Cockpits (`lumiscan-cockpit.json` auf einem PC) und auf einem PC die Optionen, mit denen das Cockpit gestartet wurde.