---
title: "Fehlerbehebung"
description: "Probleme mit LumiScan Training - Modellkonvertierung, GPU-Speicher, gemeinsames Backend und Lizenzen - mit Symptomen, Ursachen, Prüfungen und Lösungen sowie den Informationen, die der Support benötigt."
product: "LumiScan Training"
component: "lumiscan-training-de"
version: "2.3.0"
display_version: "2.3.0.2"
latest_version: true
language: "de"
url: "https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/troubleshooting.html"
---

# Fehlerbehebung – LumiScan Training

Diese Seite beginnt mit allgemeinen Prüfungen, die Sie zuerst durchführen. Suchen Sie danach Ihr Symptom und arbeiten Sie Diagnose und Lösung durch. Besteht das Problem weiterhin, senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support.

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

- Prüfen Sie, ob der Computer die [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/requirements.html) erfüllt: Windows 11 Professional oder Windows 11 Enterprise, eine NVIDIA-RTX-Grafikkarte, bis zu 15 GB freier Speicherplatz, CUDA Toolkit 11.8 und CodeMeter 9.00 oder höher.
- Prüfen Sie die Lizenz (siehe [Lizenz](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/requirements.html#licence)). Lizenzprobleme mit dem LumiScan Key - ein Key, der nicht erkannt wird, die Meldung `User maximum reached!`, eine Engineering-App, die nicht mehr startet, weil das Jahresabonnement abgelaufen ist - sind unter [Lizenzierung: Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/troubleshooting.html) beschrieben.
- Nur wenn eine Hailo-TPU verwendet wird: Prüfen Sie, ob der Computer mindestens 24 GB Arbeitsspeicher (DRAM) und Hardware hat, die Hyper-V unterstützt, und ob Podman 6.0.x und das Hailo PlugIn vor LumiScan Training installiert wurden (siehe [Podman installieren](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/lumiscan-training-installation.html#installing-podman)).
- Prüfen Sie die JSON-Konfiguration: Pfade verwenden Schrägstriche (`/`) statt Backslashes (`\`), und ein leerer Wert wird als `null` geschrieben, ohne Anführungszeichen und Großbuchstaben (siehe [Beschreibung der JSON-Parameter](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/json-settings.html#json-parameters-description)).
- Lesen Sie den Bereich **Process Status** im Hauptfenster. `Waiting for configuration file!` bedeutet, dass noch keine Konfigurationsdatei ausgewählt wurde (**Select Config File/Browse**); die weiteren Meldungen sind unter [Benutzeroberfläche](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/user-interface.html) beschrieben.
- Während einer Modellkonvertierung zeigt die Log-Konsole am unteren Rand des Dialogs **Model Conversion (ONNX → Hailo)** den Fortschritt und, wenn die Konvertierung fehlschlägt, zusätzliche Informationen.

## Problem: **Model Conversion** ist nicht verfügbar, oder `podman` bzw. das Konvertierungsabbild wird nicht gefunden {#faq-model-conversion-unavailable}

**Symptome**

- Während der Installation von LumiScan Training meldet das Setup-Programm, dass die Funktion **Model Conversion** nicht verfügbar sein wird.
- Die Anwendung meldet, dass der Befehl `podman` oder das erforderliche Konvertierungsabbild nicht gefunden werden konnte.

**Mögliche Ursachen**

- Das Hailo PlugIn ist nicht installiert. Die Modellkonvertierung läuft im Hailo-Konvertierungscontainer und ist nur verfügbar, wenn zusätzlich zu LumiScan Training das Hailo PlugIn (`Installer-LumiScanTraining-HailoPlugIn`) installiert ist.
- Podman wurde nicht vor dem Hailo PlugIn installiert. Das Hailo PlugIn prüft seine Voraussetzungen nacheinander und bricht bei der ersten fehlenden Voraussetzung ab.
- Hyper-V ist nicht verfügbar. Auf Windows-Home-Editionen steht Hyper-V nicht zur Verfügung; das Hailo PlugIn kann dort nicht verwendet werden.

**Diagnose**

1. Prüfen Sie, ob die Podman-CLI für Windows in Version 6.0.x mit **Windows Hyper-V** als Virtualisierungs-Provider installiert ist - erwartet: Podman 6.0.x ist installiert. Das Abbild des Hailo PlugIn ist für Podman 6.0 erstellt; eine neuere Podman-CLI ist damit nicht getestet.
2. Prüfen Sie, ob das Setup-Programm des Hailo PlugIn bis zum Ende ausgeführt wurde - erwartet: Eine Meldung hat bestätigt, dass das Abbild erfolgreich installiert wurde, und das Setup-Programm wurde mit **Finish** geschlossen.
3. Prüfen Sie Windows-Edition und Hardware - erwartet: Windows 11 Professional oder Windows 11 Enterprise, Hardware, die Hyper-V unterstützt, mindestens 24 GB Arbeitsspeicher.

**Lösung**

- **Wenn das Hailo PlugIn nicht installiert ist:** Installieren Sie Podman und das Hailo PlugIn wie unter [Podman installieren](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/lumiscan-training-installation.html#installing-podman) und [Hailo PlugIn installieren](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/lumiscan-training-installation.html#installing-hailo-plugin) beschrieben. Die Installation des Hailo PlugIn kann 10 bis 20 Minuten oder länger dauern; unterbrechen Sie sie nicht.
- **Wenn Podman nicht vor dem Hailo PlugIn installiert wurde:**
  1. Installieren Sie die Podman-CLI 6.0.x für Windows mit **Windows Hyper-V** als Virtualisierungs-Provider.
  2. Führen Sie das Setup-Programm des Hailo PlugIn erneut aus und warten Sie, bis es meldet, dass das Abbild erfolgreich installiert wurde.
- **Wenn Hyper-V nicht verfügbar ist:** Verwenden Sie einen Computer mit Windows 11 Professional oder Windows 11 Enterprise und Hardware, die Hyper-V unterstützt. Das Installationsprogramm des Hailo PlugIn prüft, ob Hyper-V verfügbar ist, und bietet an, es bei Bedarf zu aktivieren.

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit der genauen Meldung, der installierten Podman-Version und dem Installationslog, das das Setup-Programm des Hailo PlugIn anzeigt.

## Problem: Das Training schlägt wegen unzureichenden GPU-Speichers fehl oder dauert ungewöhnlich lange {#faq-gpu-memory}

**Symptome**

- Das Training mit dem Trainingsprofil `B8x1` schlägt wegen unzureichenden GPU-Speichers fehl.
- Das Training dauert ungewöhnlich lange.

**Mögliche Ursachen**

- Der GPU-Speicher reicht für das Trainingsprofil `B8x1` (Standardwert) nicht aus.
- Das Training verwendet gemeinsamen GPU-Speicher (Shared GPU Memory). Auch eine ungewöhnlich lange Trainingsdauer kann auf unzureichenden GPU-Speicher hindeuten.

**Diagnose**

1. Prüfen Sie den Wert von `trainingProfile` in der JSON-Konfiguration - erwartet: `B8x1` (Standard) oder `B4x1`.
2. Prüfen Sie während des Trainings im Windows-Task-Manager die Nutzung des gemeinsamen GPU-Speichers - erwartet: Das Training verwendet keinen gemeinsamen GPU-Speicher.

**Lösung**

- **Wenn der GPU-Speicher für `B8x1` nicht ausreicht oder das Training gemeinsamen GPU-Speicher verwendet:**
  1. Setzen Sie `trainingProfile` in der JSON-Konfiguration auf `B4x1` (siehe [Beschreibung der JSON-Parameter](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/json-settings.html#json-parameters-description)).
  2. Wählen Sie die Konfigurationsdatei aus und klicken Sie erneut auf **Start Training**.

> [!NOTE]
> Derzeit wird nur eine GPU unterstützt.

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit der JSON-Konfigurationsdatei und dem Modell der Grafikkarte.

## Problem: Die Modellkonvertierung bricht mit Exit-Code 137 ab {#faq-exit-code-137}

**Symptome**

Die Modellkonvertierung schlägt fehl. Die Statuszeile des Dialogs **Model Conversion (ONNX → Hailo)** zeigt den Exit-Code `137`, und die Log-Konsole zeigt zusätzliche Informationen.

**Mögliche Ursachen**

- Der Speicher der Podman-Maschine ist während der Quantisierung erschöpft.

**Diagnose**

1. Lesen Sie den Exit-Code in der Statuszeile - erwartet für dieses Problem: `137`. Bei einem anderen Exit-Code siehe [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/troubleshooting.html#support-information).
2. Lesen Sie die Log-Konsole - erwartet: Sie zeigt, wie Sie der virtuellen Maschine zusätzlichen Speicher zuweisen.
3. Prüfen Sie den Arbeitsspeicher des Computers - erwartet: mindestens 24 GB (DRAM). Die Modellkonvertierung läuft in einer virtuellen Maschine mit 18 GB Arbeitsspeicher.

**Lösung**

- **Wenn der Speicher der Podman-Maschine erschöpft ist:**
  1. Weisen Sie der virtuellen Maschine zusätzlichen Speicher zu, wie in der Log-Konsole beschrieben.
  2. Klicken Sie erneut auf **Start Conversion**.

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit dem Exit-Code, dem vollständigen Inhalt der Log-Konsole und der Größe des Arbeitsspeichers.

## Problem: Die Modellkonvertierung dauert länger als erwartet {#faq-conversion-slow}

**Symptome**

Nach **Start Conversion** zeigt der Status länger als erwartet **Converting…**.

**Mögliche Ursachen**

- Es ist die erste Konvertierung: Die Podman-Maschine wird zunächst gestartet, falls sie nicht bereits läuft.
- Die ONNX-Datei, der Kalibrierordner oder der Ausgabeordner liegt auf einem anderen Laufwerk als `C:`, beispielsweise `E:`, oder auf einer Netzwerkfreigabe. Die erforderlichen Dateien werden dann vor der Konvertierung in den Container übertragen und die Ergebnisse danach zurückübertragen. Je nach Umfang der Kalibrierdaten verlängert sich dadurch die Konvertierung.

**Diagnose**

1. Prüfen Sie, ob es die erste Konvertierung seit dem letzten Start der Podman-Maschine ist - erwartet: Die erste Konvertierung dauert länger.
2. Prüfen Sie die Pfade unter **ONNX model file**, **Calibration folder** und **Output folder** - erwartet: Alle drei liegen auf dem Laufwerk `C:`. Andernfalls zeigt die Log-Konsole die zusätzlichen Übertragungsschritte an.

**Lösung**

- **Wenn es die erste Konvertierung ist:** Warten Sie, bis die Konvertierung abgeschlossen ist. Danach erscheint die Meldung `Conversion finished successfully.`
- **Wenn die Dateien auf einem anderen Laufwerk oder einer Netzwerkfreigabe liegen:** Warten Sie, bis die Konvertierung abgeschlossen ist. Der Konvertierungscontainer kann direkt auf das Laufwerk `C:` zugreifen; für dort gespeicherte Dateien ist keine Übertragung nötig.

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit den drei Pfaden der Konvertierung und dem vollständigen Inhalt der Log-Konsole.

## Problem: Ein Client kann keine Verbindung zum gemeinsamen Backend herstellen {#faq-client-cannot-connect}

**Symptome**

Ein Client-Computer kann keine Verbindung zum gemeinsamen Backend-Server herstellen: im Webbrowser unter `http://<server-ip>:8420` oder in einer LumiScan Training-Installation, in der **Start backend locally** deaktiviert und der Server unter **Remote backend address** eingetragen ist.

**Mögliche Ursachen**

- Die **Backend bind address** des Servers ist `localhost (127.0.0.1)`. Diese Adresse nimmt ausschließlich Verbindungen desselben Computers an.
- Die Windows-Firewall auf dem Server erlaubt dem Backend die Kommunikation über das Netzwerk nicht.
- Das Backend auf dem Server läuft nicht.
- Die Serveradresse auf dem Client ist nicht korrekt.

**Diagnose**

1. Öffnen Sie auf dem Client-Computer `http://<server-ip>:8420/api/v1/health` in einem Webbrowser - erwartet: Der Endpunkt antwortet sofort. Bleibt eine Antwort aus, fahren Sie mit den nächsten Schritten fort.
2. Öffnen Sie auf dem Server den Reiter **App Settings** und prüfen Sie **Backend bind address** - erwartet: die Netzwerk-IP-Adresse des Computers, beispielsweise `192.168.1.50`, oder `0.0.0.0 (all interfaces)`; nicht `localhost (127.0.0.1)`.
3. Prüfen Sie auf dem Server, ob die Windows-Firewall dem Backend die Kommunikation über das Netzwerk erlaubt - erwartet: Der Zugriff ist für **Private networks** erlaubt.
4. Öffnen Sie auf dem Server **App Settings** und prüfen Sie **Backend connection** - erwartet: **Start backend locally** und **Autostart backend as a service** sind aktiviert. Mit Autostart wird das Backend automatisch gestartet, sobald sich der Windows-Benutzer anmeldet, auch wenn LumiScan Training selbst nicht geöffnet ist.
5. Prüfen Sie auf dem Client die Serveradresse - erwartet: die IP-Adresse des Servers in der Browseradresse bzw. unter **Remote backend address**.

**Lösung**

- **Wenn die Bind-Adresse `localhost (127.0.0.1)` ist:**
  1. Wählen Sie auf dem Server unter **Backend bind address** die Netzwerk-IP-Adresse des Computers oder `0.0.0.0 (all interfaces)`.
  2. Klicken Sie auf **Save**.
  3. Starten Sie LumiScan Training neu, oder melden Sie sich von Windows ab und wieder an.
- **Wenn die Windows-Firewall das Backend blockiert:** Erlauben Sie auf dem Server den Zugriff für **Private networks**. Die Windows-Firewall kann beim ersten Binden des Backends an eine netzwerkerreichbare Adresse danach fragen.
- **Wenn das Backend nicht läuft:** Aktivieren Sie auf dem Server **Start backend locally** und **Autostart backend as a service**, klicken Sie auf **Save** und starten Sie LumiScan Training neu oder melden Sie sich von Windows ab und wieder an.
- **Wenn die Serveradresse falsch ist:** Tragen Sie die IP-Adresse des Servers unter **Remote backend address** (bzw. in der Browseradresse) ein, klicken Sie auf **Save** und starten Sie LumiScan Training neu.

Siehe auch [Einrichten eines gemeinsamen Backend-Servers](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/app-settings.html#app-settings-server) und [Verbindung von einem Client-Computer](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/app-settings.html#app-settings-client).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-training-de/2.3.0/troubleshooting.html#support-information) aufgeführten Informationen an den Support, zusammen mit der IP-Adresse des Servers, der **Backend bind address** und dem Ergebnis von `http://<server-ip>:8420/api/v1/health` auf dem Client.

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

Halten Sie diese Informationen bereit, wenn Sie den Support kontaktieren:

- Produkt und Version: LumiScan Training und seine Version. Der Dateiname des Setup-Programms endet mit der Versionsnummer, zum Beispiel `Installer_LumiScanTrainingFramework_v2_1_0_0.exe`.
- Betriebssystem: Windows 11 Professional oder Windows 11 Enterprise, das Modell der Grafikkarte und die installierten Versionen von CUDA Toolkit und CodeMeter. Wenn eine Hailo-TPU verwendet wird: die Podman-Version und die Größe des Arbeitsspeichers.
- Bezugsquelle der Software: HD Vision Systems oder ctrlX Store.
- Die Seriennummer des LumiScan Key (`3-…`, auf dem Key aufgedruckt).
- Die genaue Fehlermeldung, ein Screenshot sowie Datum und Uhrzeit, zu der das Problem auftrat. Beim Training: die Meldung unter **Process Status**. Bei der Modellkonvertierung: der Exit-Code in der Statuszeile und der vollständige Inhalt der Log-Konsole.
- Beim gemeinsamen Backend: die Einstellungen unter **App Settings** auf Server und Client (**Start backend locally**, **Backend bind address**, **Remote backend address**) und das Ergebnis von `http://<server-ip>:8420/api/v1/health`.
- Die für das Training verwendete JSON-Konfigurationsdatei.

Den Kundensupport erreichen Sie unter [customer.success@hdvisionsystems.com](mailto:customer.success@hdvisionsystems.com) oder telefonisch unter +49 6221 6721905. Bei Fragen zu Lizenzen schreiben Sie an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com).