---
title: "Fehlerbehebung"
description: "Fehlerbehebung für den Data Layer der LumiScan-Apps - allgemeine Prüfungen, der Broker, fehlende Apps, Module und Knoten, abgelehnte Methodenaufrufe, Handshakes, Streams, der OPC UA Connector und was Sie an den Support senden."
product: "LumiScan Keryx"
component: "lumiscan-keryx-de"
version: "1.0.0"
display_version: "1.0.0.7"
latest_version: true
language: "de"
url: "https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html"
---

# Fehlerbehebung – LumiScan Keryx

Beginnen Sie mit den [Allgemeine Prüfungen](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html#general-checks): Sie helfen bei jedem Problem mit dem Data Layer. 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 App läuft und ist auf dem Data Layer.** Öffnen Sie auf einem PC die Keryx-Seite `http://127.0.0.1:7555/` (Windows) oder führen Sie `krxclient tree hdvisionsystems --depth 1` aus: Der Baum zeigt den Ordner `hdvisionsystems` mit einem Ordner pro laufender App. Auf ctrlX OS verwenden Sie die Data-Layer-Ansicht der Weboberfläche von ctrlX OS. Siehe [Werkzeuge](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/tools.html).

- **Alle Programme verwenden denselben Broker (PC).** Jede App nennt beim Start in ihrem Log die Broker-Adresse, die sie verwendet. Jede App, Cockpit und der OPC UA Connector müssen dieselbe Adresse verwenden. Standard ist `tcp://127.0.0.1:5555`; `--keryx-url` oder `LUMISCAN_KERYX_URL` ändert sie. Siehe [Optionen und Umgebungsvariablen](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/keryx.html#options).

- **Die App bedient ihre Module.** Für jede App mit Modulen listet `hdvisionsystems/<app>/system/found-modules` diese auf. Ist die Liste leer, nennt `hdvisionsystems/<app>/system/status-text` den Grund.

- **Der Status des Moduls.** Cam Driver, AI Object Matching und Calibration melden ihn auf `<module>/control/status/code` und `control/status/text`: Werte unter `0` sind Fehler. Die Finder melden jede Methode auf `<method>/output/status-code` und `status-text`. Verwenden Sie die Zahlen, nicht die Texte. Siehe [Statuscodes und Ergebnisse](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/status-codes.html).

- **Die Adressen passen zur App-Version.** Adressen sind kleingeschrieben. In den kommenden Releases sind mehrere Knoten umgezogen, ohne Alias unter der alten Adresse: Vergleichen Sie Ihr Programm mit der **Data Layer Reference** der App-Version, die Sie einsetzen.

- **Die Logs.** Die Apps protokollieren die erste Ablehnung einer Methode und danach für dieselbe Methode und dasselbe Ergebnis höchstens eine Zeile alle zehn Sekunden.

  | Log | Wo |
  | --- | --- |
  | Eine App auf ctrlX OS | das Systemprotokoll von ctrlX OS: das Logbuch der ctrlX-Weboberfläche oder `journalctl` |
  | Der Broker unter Windows (Log, Aufzeichnungen und `broker.json`) | `C:\ProgramData\HD Vision Systems GmbH\LumiScan Keryx` |
  | Der Broker unter Ubuntu | `/tmp/lumiscan-keryx` |
  | LumiScan Keryx Utilities | `%LOCALAPPDATA%\LumiScan Keryx Utilities\logs\keryx-utilities.log` |

## Broker, Apps und Knoten {#broker-apps-nodes}

### Problem: Eine App wartet auf den Broker (PC) {#no-broker}

**Symptome**

Eine App auf einem PC protokolliert, dass sie keinen Data-Layer-Broker erreichen konnte (`could not reach a Keryx broker`), und wartet.

**Mögliche Ursachen**

- Es ist der erste Start: Der Broker braucht einige Sekunden, bis er antwortet.
- **LumiScan Keryx** ist nicht installiert.
- Das Terminal wurde vor der Installation von LumiScan Keryx geöffnet. Das Installationsprogramm setzt die Variablen `HDV_KERYX_BROKER` und `HDV_KERYX_PAGE`; ein Programm oder Terminal, das bereits geöffnet war, sieht sie nicht.
- Der automatische Start ist ausgeschaltet: `--no-keryx-autostart` oder `LUMISCAN_KERYX_AUTOSTART=0`.
- Der Broker wurde auf der Keryx-Seite mit **Shut down broker** gestoppt.
- Die Adresse ist eine `ipc://`-Adresse relativ zu einem Ordner: Keine App startet dafür einen Broker.
- Die Adresse ist die eines anderen Computers: Eine App verbindet sich nur damit und startet dort nie einen Broker.

**Diagnose**

1. Warten Sie nach dem ersten Start einige Sekunden - erwartet: Die App verbindet sich, sobald der Broker antwortet.
2. Lesen Sie die Broker-Adresse im Log der App beim Start - erwartet: die Adresse, die Sie verwenden wollen, standardmäßig `tcp://127.0.0.1:5555`.
3. Prüfen Sie, ob LumiScan Keryx installiert ist und ob Sie das Terminal nach der Installation geöffnet haben.
4. Prüfen Sie die Optionen und Umgebungsvariablen der App - erwartet: Weder `--no-keryx-autostart` noch `LUMISCAN_KERYX_AUTOSTART=0` ist gesetzt, es sei denn, Sie starten den Broker selbst.
5. Prüfen Sie, ob auf der Keryx-Seite **Shut down broker** geklickt wurde. Danach starten die Apps den Broker nicht von selbst erneut.
6. Bei einer `ipc://`-Adresse: Prüfen Sie, ob der Broker und jede App aus demselben Ordner gestartet wurden.

**Lösung**

- **Wenn es der erste Start ist:** Warten Sie. Die App verbindet sich, sobald der Broker antwortet.

- **Wenn LumiScan Keryx nicht installiert ist:**

  a. Installieren Sie zuerst LumiScan Keryx, dann die Apps. Führen Sie jedes Installationsprogramm als Administrator aus.

  b. Öffnen Sie ein **neues** Terminal und starten Sie die App erneut.

- **Wenn das Terminal vor der Installation geöffnet wurde:** Öffnen Sie ein neues Terminal und starten Sie die App erneut.

- **Wenn der automatische Start ausgeschaltet ist:** Entfernen Sie die Option oder die Variable, oder starten Sie den Broker selbst: `krxsystem --backend hdv --url <address>`.

- **Wenn der Broker heruntergefahren wurde:** Klicken Sie auf der Keryx-Seite auf **Start broker** oder öffnen Sie das LumiScan Keryx-Fenster. Auch ein von Hand gestartetes `krxsystem` oder ein Neustart des PCs startet ihn wieder.

- **Wenn die Adresse eine relative `ipc://`-Adresse ist:** Starten Sie den Broker selbst (`krxsystem --backend hdv --url <address>`) und starten Sie dann jede App aus genau diesem Ordner.

- **Wenn die Adresse die eines anderen Computers ist:** Der Betrieb von Apps auf mehreren PCs an einem Broker wird in diesem Handbuch nicht behandelt. Wenden Sie sich an den Support.

Siehe [LumiScan Keryx auf einem PC](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/keryx.html).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit der Meldung aus dem Log der App, der Broker-Adresse, die die App dort nennt, und dem Log des Brokers.

### Problem: Eine App oder ein Modul fehlt im Baum {#app-missing}

**Symptome**

Der Baum enthält unter `hdvisionsystems` keinen Ordner für die App, oder ein erwartetes Modul erscheint nicht auf dem Data Layer: `hdvisionsystems/<app>/system/found-modules` führt es nicht auf.

**Mögliche Ursachen**

- Die App läuft nicht.
- Die App verwendet einen anderen Broker als das Programm, mit dem Sie nachsehen (PC).
- Die Einstellungsdatei konnte nicht geladen werden.
- Die Lizenz fehlt. Auf ctrlX OS beendet sich eine App ohne gültige Lizenz kurz nach dem Start.
- Der Modulname enthält Großbuchstaben oder andere Zeichen als `a-z`, `0-9`, `-` und `_`. Cam Driver und AI Object Matching lehnen ein solches Modul ab.
- Cam Driver, AI Object Matching, Calibration: Die Moduldatei wurde mit `system/control/activate-module/execute` aktiviert, die App wurde seitdem aber nicht neu gestartet.
- Template Finder, Object Finder, Area Detector, Text Reader: Das Modul wurde mit `system/create-module/execute` angelegt und nicht gespeichert, und die App wurde seitdem neu gestartet.

**Diagnose**

1. Prüfen Sie den Baum - auf einem PC auf der Keryx-Seite oder mit `krxclient tree`; auf ctrlX OS in der Weboberfläche von ctrlX OS; erwartet: Der Ordner `hdvisionsystems` enthält einen Ordner pro laufender App.
2. Vergleichen Sie auf einem PC die Broker-Adresse im Log der App mit der Adresse von Cockpit, dem OPC UA Connector oder dem verwendeten Werkzeug - erwartet: dieselbe Adresse.
3. Lesen Sie `hdvisionsystems/<app>/system/found-modules` - erwartet: Das Modul ist aufgeführt.
4. Falls nicht, lesen Sie `hdvisionsystems/<app>/system/status-text` - erwartet: Dort steht, warum die App kein Modul bedient, meist eine Einstellungsdatei, die nicht geladen werden konnte, oder eine fehlende Lizenz.
5. Prüfen Sie den Modulnamen - erwartet: nur Kleinbuchstaben, Ziffern, `-` und `_`. Der Name stammt aus `id` in der Moduldatei (Cam Driver), aus `name` in der Moduldatei (AI Object Matching), aus dem Namen der Moduldatei (Calibration) oder aus der Modul-ID (die Finder). Siehe [Modulnamen](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/addresses.html#module-names).
6. Lesen Sie auf ctrlX OS das Systemprotokoll - erwartet: keine Meldung, dass die Lizenz fehlt.

**Lösung**

- **Wenn die App nicht läuft:** Starten Sie sie und warten Sie, bis sie vollständig gestartet ist.

- **Wenn die App einen anderen Broker verwendet:** Übergeben Sie jeder App, Cockpit und dem OPC UA Connector dieselbe `--keryx-url`.

- **Wenn die Einstellungsdatei nicht geladen werden konnte:** Korrigieren Sie sie und starten Sie die App erneut. Auf einem PC sind die Einstellungen Dateien im Einstellungsordner der App (unter Windows `C:\ProgramData\HD Vision Systems GmbH\LumiScan Vision Suite\<program>\etc\<settings folder>`); die Option `--generate-settings` schreibt ein Beispiel. Siehe [Speicherorte der Dateien](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/keryx.html#files). Auf ctrlX OS laden Sie sie hoch, wie es das Handbuch der App unter **Uploading Data** beschreibt.

- **Wenn die Lizenz fehlt:** Siehe [LumiScan Lizenzierung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/index.html).

- **Wenn der Modulname ungültig ist:** Verwenden Sie Modulnamen in Kleinbuchstaben.

- **Wenn die App seit der Aktivierung nicht neu gestartet wurde:** Rufen Sie `hdvisionsystems/<app>/system/control/restart/execute` auf.

- **Wenn ein Finder-Modul nicht gespeichert wurde:**

  a. Legen Sie das Modul mit `system/create-module/execute` erneut an.

  b. Speichern Sie die Modulliste mit `system/save-current-modules/execute` und die Eingaben des Moduls mit `system/save-module-inputs/execute`.

Siehe [Einstellungen, Module und Neustart](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/settings-and-modules.html).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit dem Inhalt von `system/found-modules` und `system/status-text` sowie der Moduldatei.

### Problem: Ein Knoten ist „not found" {#node-not-found}

**Symptome**

Ein Lese-, Schreib- oder Methodenaufruf meldet, dass der Knoten nicht gefunden wurde: `NodeNotFound` (LumiScan Keryx), `DL_INVALID_ADDRESS` (ctrlX Data Layer) oder `BadNodeIdUnknown` (OPC UA). Ein Programm, das für ein früheres Release geschrieben wurde, findet einen Knoten nicht mehr, den es verwendet hat.

**Mögliche Ursachen**

- Groß-/Kleinschreibung oder Schreibweise der Adresse ist falsch. Adressen sind kleingeschrieben.
- Der Knoten ist umgezogen. In den kommenden Releases sind mehrere Knoten umgezogen, ohne Alias unter der alten Adresse, zum Beispiel der Stream des Cam Driver von `input/stream/enable` nach `control/publish/input/enable`.
- Die App startet gerade neu: Ihre Knoten verschwinden, bis sie wieder läuft.
- Das Modul fehlt, siehe [Problem: Eine App oder ein Modul fehlt im Baum](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html#app-missing).

**Diagnose**

1. Vergleichen Sie die Adresse mit dem Baum - auf einem PC auf der Keryx-Seite oder aus `krxclient tree`; auf ctrlX OS in der Weboberfläche von ctrlX OS; erwartet: dieselbe Groß-/Kleinschreibung und Schreibweise.
2. Vergleichen Sie die Adresse mit der **Data Layer Reference** der App-Version, die Sie einsetzen - erwartet: Der Knoten ist dort unter dieser Adresse aufgeführt.
3. Prüfen Sie, ob die App gerade neu startet - erwartet: `system/restart-required` kann gelesen werden.

**Lösung**

- **Wenn Groß-/Kleinschreibung oder Schreibweise falsch ist:** Korrigieren Sie die Adresse.
- **Wenn der Knoten umgezogen ist:** Ändern Sie Ihr Programm auf die Adresse in der **Data Layer Reference** der App-Version, die Sie einsetzen.
- **Wenn die App gerade neu startet:** Warten Sie, bis `system/restart-required` wieder gelesen werden kann.
- **Wenn das Modul fehlt:** Siehe [Problem: Eine App oder ein Modul fehlt im Baum](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-keryx-de/1.0.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit der Adresse, die nicht gefunden wird, und dem Ergebnis des Aufrufs.

## Funktionen aufrufen {#calling-functions}

### Problem: Ein Methodenaufruf wird abgelehnt {#refused}

**Symptome**

Ein Schreibvorgang auf einen `execute`-Knoten antwortet nicht mit `Ok` (`DL_OK`, OPC UA `Good`), sondern mit einem der Ergebnisse aus [Ergebnisse eines Methodenaufrufs](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/status-codes.html#method-results), zum Beispiel `TooManyOperations`, `InvalidOperationMode`, `ResourceUnavailable` oder `Rejected`. Auf dem ctrlX Data Layer trägt ein abgelehnter Aufruf keinen Grund.

**Mögliche Ursachen**

- `TooManyOperations` (ctrlX `DL_TOO_MANY_OPERATIONS`, OPC UA `BadTooManyOperations`): Eine andere Operation desselben Moduls läuft - ein Execute, ein Handshake oder bei den Findern ein Frame eines Streams.
- `InvalidOperationMode` (ctrlX `DL_INVALID_OPERATION_MODE`, OPC UA `BadInvalidState`): Die Funktion ist nicht bereit. Ihr `ready` ist `false`, zum Beispiel weil keine Lizenz vorhanden ist, die Kamera nicht verbunden ist oder ein Stream läuft.
- `ResourceUnavailable` (ctrlX `DL_RESOURCE_UNAVAILABLE`, OPC UA `BadResourceUnavailable`): Nach einer Änderung über `system/settings` ist ein Neustart erforderlich (Status `-5`), die App wird beendet, oder ein AI-Modul hat einen Fehler.
- `Rejected` (ctrlX `DL_INVALID_VALUE`, OPC UA `BadRequestNotAllowed`): Eine Eingabe ist ungültig; nichts wurde geändert.
- `NodeNotFound` (ctrlX `DL_INVALID_ADDRESS`, OPC UA `BadNodeIdUnknown`): Ein Bild, eine Quelle, ein Modul oder der Knoten selbst wurde nicht gefunden.
- `CreationFailed` (ctrlX `DL_CREATION_FAILED`): Etwas konnte nicht geschrieben oder angelegt werden, zum Beispiel eine Datei, ein bereits vorhandenes Modul oder eine nicht verfügbare Lizenz.
- `InternalError` (ctrlX `DL_FAILED`, OPC UA `BadInternalError`): Die Operation ist fehlgeschlagen.

**Diagnose**

1. Notieren Sie das Ergebnis des Aufrufs und schlagen Sie es unter [Ergebnisse eines Methodenaufrufs](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/status-codes.html#method-results) nach.
2. Lesen Sie das Log der App - erwartet: der Grund der Ablehnung. Die Apps schreiben ihn dorthin, weil ein abgelehnter Aufruf auf dem ctrlX Data Layer keinen trägt.
3. Cam Driver, AI Object Matching, Calibration: Lesen Sie `control/<function>/ready` zusammen mit `control/status/code` und `control/status/text`. `ready` nennt die fehlende Voraussetzung; der Statustext trägt noch die Meldung des Fehlers, der sie verursacht hat.
4. Finder: Lesen Sie `<method>/output/status-code` und `status-text`. Siehe [Ausführungsstatus der Finder](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/status-codes.html#execution-status).

**Lösung**

- **Wenn eine andere Operation des Moduls läuft (`TooManyOperations`):** Wiederholen Sie den Aufruf. Er gelingt, sobald die laufende Operation abgeschlossen ist.
- **Wenn die Funktion nicht bereit ist (`InvalidOperationMode`):** Bringen Sie das Modul zuerst in den erforderlichen Zustand, verbinden Sie zum Beispiel die Kamera. Bloßes Wiederholen schlägt weiter fehl: Wiederholen Sie nicht in einer Schleife. `capture` des Cam Driver und `inference` von AI Object Matching sind nicht bereit, während ihr Stream läuft: Stoppen Sie zuerst den Stream, siehe [Streams und einzelne Operationen](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/streams.html#collisions). Das Handbuch der App nennt, wann jedes `ready` `true` ist.
- **Wenn ein Neustart erforderlich ist (`ResourceUnavailable`, Status `-5`):** Siehe [Problem: Status `-5` (`restartRequired`) oder `ResourceUnavailable` bei jedem Aufruf](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html#faq-restart-required).
- **Wenn die App beendet wird oder ein AI-Modul einen Fehler hat (`ResourceUnavailable`):** Lesen Sie den Status und starten Sie die App neu, wenn erforderlich.
- **Wenn eine Eingabe ungültig ist (`Rejected`):** Korrigieren Sie die Eingabe und rufen Sie erneut auf.
- **Wenn etwas nicht gefunden wurde (`NodeNotFound`):** Prüfen Sie die Adresse und ihre Groß-/Kleinschreibung, siehe [Problem: Ein Knoten ist „not found"](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html#node-not-found).
- **Wenn etwas nicht geschrieben oder angelegt werden konnte (`CreationFailed`) oder die Operation fehlgeschlagen ist (`InternalError`):** Lesen Sie das Log und den Status; dort steht der Grund.

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit der Adresse der Methode, ihrem Ergebnis, den Werten von `ready`, `control/status/code` und `control/status/text` sowie den Log-Zeilen zur Ablehnung.

### Problem: Status `-5` (`restartRequired`) oder `ResourceUnavailable` bei jedem Aufruf {#faq-restart-required}

**Symptome**

Jedes Modul der App meldet `control/status/code` = `-5` (`restartRequired`), und seine Methoden antworten mit `ResourceUnavailable` (ctrlX `DL_RESOURCE_UNAVAILABLE`, OPC UA `BadResourceUnavailable`).

**Mögliche Ursachen**

- Die Einstellungen wurden über `system/settings` geändert. Sie werden beim nächsten Start wirksam.

**Diagnose**

1. Lesen Sie `hdvisionsystems/<app>/system/restart-required` - erwartet nach einer gespeicherten Änderung: `true`, bis die App neu startet.

**Lösung**

- **Wenn die Einstellungen über `system/settings` geändert wurden:**

  a. Rufen Sie `hdvisionsystems/<app>/system/control/restart/execute` auf. Die Knoten der App verschwinden, bis sie wieder läuft.

  b. Warten Sie, bis `system/restart-required` wieder gelesen werden kann.

  c. Führen Sie Ihre Startsequenz erneut aus: In `input/` geschriebene Werte bleiben nicht erhalten, die Kamera ist nicht verbunden und der Stream des Cam Driver ist aus. Siehe [Was bei einem Neustart erhalten bleibt](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/settings-and-modules.html#kept).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit dem Wert von `system/restart-required` und dem Inhalt von `system/settings`.

### Problem: Der Execute-Aufruf antwortet mit `Ok` (`DL_OK`), aber nichts ist passiert {#faq-write-ok-but-failed}

**Symptome**

Cam Driver, AI Object Matching, Calibration: Ein Schreibvorgang auf einen `execute`-Knoten antwortet mit `Ok` (`DL_OK`, OPC UA `Good`), aber die Operation hatte keine Wirkung.

**Mögliche Ursachen**

- Die Operation wurde ausgeführt, ist aber fehlgeschlagen. Das Ergebnis des Schreibvorgangs sagt nur aus, dass die Operation ausgeführt wurde. Ob sie erfolgreich war, steht im Modulstatus.

**Diagnose**

1. Lesen Sie direkt nach dem Aufruf `control/status/code` und `control/status/text` - erwartet: `0` (`ready`). Werte unter `0` sind Fehler.
2. Schlagen Sie den Code unter [Modulstatus](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/status-codes.html#module-status) nach. App-spezifische Codes stehen im Handbuch der jeweiligen App.

**Lösung**

- **Wenn der Status unter `0` liegt:** Beheben Sie die Ursache, die der Code nennt, korrigieren Sie zum Beispiel eine Eingabe (`-3`, `invalidInput`) oder starten Sie die App neu (`-5`, siehe [Problem: Status `-5` (`restartRequired`) oder `ResourceUnavailable` bei jedem Aufruf](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html#faq-restart-required)). Rufen Sie dann erneut auf.
- Lesen Sie in Ihrem Programm nach dem Aufruf immer `control/status/code`. Siehe [Wo Eingaben, Ausgaben und Ausgang stehen](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/execute.html#where).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit der Adresse der Methode und den Werten von `control/status/code` und `control/status/text` nach dem Aufruf.

### Problem: Ein Handshake wird nicht abgeschlossen oder zeigt den falschen Ausgang {#handshake-stuck}

**Symptome**

`ready` bleibt nach dem Request `false`; ein `capture` des Cam Driver oder eine `inference` von AI Object Matching per Handshake endet mit Status `3` (`waitingForClient`); oder ein fehlgeschlagenes `connect-camera` des Cam Driver zeigt seinen Fehler nur etwa 100 ms lang.

**Mögliche Ursachen**

- `request` ist noch `true`: Das Modul wartet darauf, dass `request` zurückfällt, so lange es dauert.
- Zwei Programme schreiben denselben `request`-Knoten, und ein Request geht verloren.
- `capture` des Cam Driver: Ein fehlgeschlagenes Capture endet mit Status `3`, nicht mit seinem eigenen Fehlercode, und `capture/ready` bleibt `false`, bis ein `reset` gelingt. Ein fehlgeschlagenes `reset`, `save` oder `load` bleibt ebenfalls bestehen, bis ein `reset` gelingt.
- `inference` von AI Object Matching: Jede Inferenz endet mit Status `3`, unabhängig von ihrem Ausgang. Nach einer fehlgeschlagenen Inferenz und solange das Modul einen Fehler hat, wird jeder Request außer `reset` ignoriert. Während der Stream läuft, ist `inference/ready` `false`, und ein Request erhält Status `100002`.
- Cam Driver: Jeder andere Fehler bleibt nur etwa 100 ms lang im Status stehen.
- Cam Driver ohne Lizenz: Jedes `ready` ist `false`, und der Status ist `-4`.

**Diagnose**

1. Folgen Sie den Schritten unter [Der Ablauf](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/handshake.html#sequence), fragen Sie dabei alle 50 bis 100 ms ab, und notieren Sie den Schritt, an dem es stehen bleibt.
2. Lesen Sie `request`, nachdem `ready` `false` geworden ist - erwartet: Ihr Programm hat es wieder auf `false` gesetzt.
3. Prüfen Sie, welche Programme den `request`-Knoten schreiben - erwartet: nur eines.
4. Bei einem `capture` des Cam Driver oder einer `inference` von AI Object Matching: Lesen Sie `output/package-identifier` davor und danach - erwartet: Er ist um eins gestiegen, wenn die Operation erfolgreich war.
5. Bei einem `connect-camera` des Cam Driver: Lesen Sie `device-info/is-connected` - erwartet: `true`, wenn die Kamera verbunden ist.
6. Beim Cam Driver: Lesen Sie `control/status/code` - erwartet: nicht `-4`.

**Lösung**

- **Wenn `request` noch `true` ist:** Setzen Sie `request` auf `false`.
- **Wenn zwei Programme `request` schreiben:** Lassen Sie nur ein Programm schreiben. Ein Programm, das sich nicht mit anderen abstimmen kann, verwendet die [Execute-Methode](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/execute.html), die einen zweiten Aufruf ablehnt, solange einer läuft.
- **Wenn ein `capture` oder eine `inference` mit Status `3` endet:** So enden sie. Erkennen Sie den Erfolg an `output/package-identifier`, oder verwenden Sie die Execute-Methode: Der Status behält dann den eigenen Code der Operation. Führen Sie nach einem fehlgeschlagenen Capture `reset` aus.
- **Wenn AI Object Matching nach einer fehlgeschlagenen Inferenz Requests ignoriert:** Führen Sie `reset` aus; es wird sofort ausgeführt.
- **Wenn der Stream von AI Object Matching läuft (Status `100002`):** Stoppen Sie zuerst den Stream.
- **Wenn ein Fehler des Cam Driver nach etwa 100 ms aus dem Status verschwindet:** Prüfen Sie eine Verbindung mit `device-info/is-connected`, nicht mit dem Status.
- **Wenn der Cam Driver keine Lizenz hat (Status `-4`):** Siehe [LumiScan Lizenzierung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/index.html).

Siehe [Unterschiede zwischen den Apps](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/handshake.html#differences).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit der Funktion, dem Schritt, an dem der Handshake stehen bleibt, und den Werten von `ready`, `request`, `control/status/code` und `output/package-identifier`.

## Streams {#streams}

### Problem: Ein Stream liefert nichts {#stream-nothing}

**Symptome**

Von einem Stream kommen keine Ergebnisse an: `output/stream/active` bleibt `false`, oder die Zähler unter `…/stream/statistics/` steigen nicht mehr. Nach einem Neustart kommen keine Bilder an.

**Mögliche Ursachen**

- Die Eingaben wurden geschrieben, aber `execute` wurde nicht aufgerufen. Die Eingaben wirken erst bei `execute`; `enable` allein zu schreiben startet nichts.
- `enable` ist `true` ohne Adresse. Der Aufruf wird abgelehnt (`Rejected`, ctrlX `DL_INVALID_VALUE`), und nichts ändert sich.
- Die `address` des Konsumenten ist nicht der Stream-Ordner des Produzenten.
- Das Modul kann nicht laufen: Lizenz, Netz nicht geladen oder Neustart erforderlich.
- Der Cam Driver wurde neu gestartet: Sein Stream und die Kameraverbindung bleiben bei einem Neustart nicht erhalten.
- `connect-camera`, `disconnect-camera` oder `reset` hat den Stream des Cam Driver gestoppt.
- Nichts triggert die Kamera. Der Cam Driver triggert die Kamera nie von selbst.
- Calibration: Ihr Abschnitt `stream` hat keinen `onEntry`-Schritt, der angibt, wie die Quelle zu lesen ist.

**Diagnose**

1. Lesen Sie an der Kamera `control/publish/output/stream/active` - erwartet: `true`.

2. Lesen Sie am Konsumenten `control/subscribe/output/stream/active` - erwartet: `true`.

3. Lesen Sie am Konsumenten `setting/stream/…` - erwartet: `enable` ist `true`, und `address` ist der Stream-Ordner des Produzenten, zum Beispiel `hdvisionsystems/lumiscan-cam-driver/camera1/control/publish/output/stream`.

4. Verfolgen Sie die Kette mit den Zählern unter `…/stream/statistics/` - erwartet: Sie steigen. Der erste Zähler, der nicht steigt, zeigt, wo die Kette stehen bleibt. Siehe [Die Kette verfolgen](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/streams.html#counters).

   a. Der Cam Driver zählt keine `frames`: Nichts triggert die Kamera.

   b. Calibration: `failed-updates` steigt, und es erscheinen keine Punkte: Der `onEntry`-Schritt fehlt.

   c. Finder und Code Reader: `control/subscribe/output/stream/last-failure` nennt, warum das letzte Element fehlgeschlagen ist.

5. Lesen Sie `control/status/code` und das Log des Moduls, an dem die Kette stehen bleibt.

**Lösung**

- **Wenn `execute` nicht aufgerufen wurde:** Rufen Sie nach dem Schreiben der Eingaben `control/subscribe/execute` (bei einem Konsumenten) oder `control/publish/execute` (beim Cam Driver) auf. Warten Sie dann, bis `output/stream/active` `true` ist.

- **Wenn `enable` `true` ohne Adresse ist:** Schreiben Sie `control/subscribe/input/address` und rufen Sie dann `control/subscribe/execute` auf.

- **Wenn die Adresse nicht der Stream-Ordner des Produzenten ist:** Schreiben Sie den Ordner, zum Beispiel `hdvisionsystems/lumiscan-cam-driver/camera1/control/publish/output/stream`, und rufen Sie `execute` auf.

- **Wenn das Modul nicht laufen kann:** Beheben Sie die Ursache, die `control/status/code` und das Log nennen. Zu einem erforderlichen Neustart siehe [Problem: Status `-5` (`restartRequired`) oder `ResourceUnavailable` bei jedem Aufruf](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html#faq-restart-required).

- **Wenn der Cam Driver neu gestartet wurde oder der Stream durch `connect-camera`, `disconnect-camera` oder `reset` gestoppt wurde:**

  a. Führen Sie den Handshake `connect-camera` aus.

  b. Rufen Sie `control/publish/execute` mit `enable` = `true` auf.

  c. Die Konsumenten abonnieren von selbst erneut.

- **Wenn nichts die Kamera triggert:** Prüfen Sie ihren Trigger-Modus oder rufen Sie `control/trigger/execute` auf.

- **Wenn der `onEntry`-Schritt von Calibration fehlt:** Ergänzen Sie ihn im Abschnitt `stream`. Siehe das Handbuch von Calibration.

Siehe [Stream starten und stoppen](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/streams.html#running).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit den Werten von `output/stream/active`, `setting/stream/…` und den Zählern unter `…/stream/statistics/` jedes Moduls der Kette.

### Problem: Stream-Ergebnisse sind veraltet oder vermischt {#ts-stream-results-mixed}

**Symptome**

Die Ergebnisse, die Ihr Programm liest, sind veraltet, oder Werte verschiedener Ergebnisse sind vermischt.

**Mögliche Ursachen**

- Ihr Programm hat gelesen, während ein neues Ergebnis geschrieben wurde.

**Diagnose**

1. Prüfen Sie, wie Ihr Programm die einfachen Ausgabeknoten liest - erwartet: Es liest sie, nachdem sich `output/package-identifier` geändert hat. `output/package-identifier` wird zuletzt geschrieben.

**Lösung**

- **Wenn Ihr Programm liest, während ein neues Ergebnis geschrieben wird:** Lesen Sie die Ausgaben, wenn sich `output/package-identifier` ändert, oder abonnieren Sie einen einzelnen Knoten wie `plain-points` von Calibration. Siehe [Neuestes Ergebnis behalten](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/streams.html#keep-latest).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit den Knoten, die Ihr Programm liest, und deren Reihenfolge.

## OPC UA Connector {#opc-ua}

### Problem: Ein OPC-UA-Client kann sich nicht verbinden {#ts-opcua-cannot-connect}

**Symptome**

Der Client kann sich nicht mit `opc.tcp://<pc>:4840` verbinden.

**Mögliche Ursachen**

- Der Connector läuft nicht: Er wurde vor dem Broker gestartet und hat sich beendet, siehe [Problem: Das Fenster des Connectors schließt sich sofort](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html#ts-opcua-window-closes).
- Die Firewall des PCs blockiert TCP-Port 4840.
- Der Client besteht auf einem sicheren Kanal. Der Connector unterstützt nur Security Policy **None** und anonyme Anmeldung.
- Der Connector wurde auf einem anderen Port gestartet (`--port`).

**Diagnose**

1. Prüfen Sie, ob der Connector läuft - erwartet: Sein Fenster ist geöffnet.
2. Prüfen Sie die Firewall des PCs - erwartet: TCP 4840 ist für die Adresse der SPS oder des Clients geöffnet.
3. Prüfen Sie die Sicherheitseinstellungen des Clients - erwartet: Security Policy **None**, anonyme Anmeldung.
4. Prüfen Sie die Optionen des Connectors - erwartet: der Port, den der Client verwendet.

**Lösung**

- **Wenn der Connector nicht läuft:** Starten Sie zuerst die Apps, dann den Connector.
- **Wenn die Firewall den Port blockiert:** Öffnen Sie TCP 4840 nur für die Adresse der SPS.
- **Wenn der Client auf einem sicheren Kanal besteht:** Stellen Sie ihn auf Security Policy **None** und anonyme Anmeldung. Zertifikate, Benutzernamen und Verschlüsselung werden nicht unterstützt. Siehe [Sicherheit](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/opc-ua.html#security).
- **Wenn der Connector auf einem anderen Port läuft:** Verbinden Sie sich mit diesem Port.

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit den Optionen des Connectors, seinem Log und der Fehlermeldung des Clients.

### Problem: Das Fenster des Connectors schließt sich sofort {#ts-opcua-window-closes}

**Symptome**

Das Fenster des OPC UA Connector schließt sich direkt nach dem Start; der Connector beendet sich mit Exit-Code 1.

**Mögliche Ursachen**

- Es läuft kein Broker. Der Connector startet nie einen Broker: Ohne Broker protokolliert er den Grund und beendet sich.
- Die `--keryx-url` des Connectors nennt einen anderen Broker als den, den die Apps verwenden.

**Diagnose**

1. Prüfen Sie, ob die Apps laufen - erwartet: Die Keryx-Seite zeigt `hdvisionsystems` mit den Apps.
2. Vergleichen Sie die `--keryx-url` des Connectors mit der Broker-Adresse, die die Apps in ihren Logs nennen - erwartet: dieselbe Adresse.
3. Lesen Sie das Log des Connectors - erwartet: der Grund, warum er sich beendet hat.

**Lösung**

- **Wenn kein Broker läuft:** Starten Sie zuerst die Apps, dann den Connector.
- **Wenn der Connector eine andere Adresse verwendet:** Übergeben Sie ihm dieselbe `--keryx-url` wie den Apps.

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit den Optionen des Connectors und seinem Log.

### Problem: `Objects` ist leer oder enthält kein `hdvisionsystems` {#ts-opcua-objects-empty}

**Symptome**

Der Client ist verbunden, aber `Objects` ist leer oder enthält kein `hdvisionsystems`.

**Mögliche Ursachen**

- Die Apps laufen nicht.
- Die `--keryx-url` des Connectors nennt einen anderen Broker als den, den die Apps verwenden.
- Eine App wurde gerade erst gestartet: Der Connector durchläuft den Baum alle 2 Sekunden erneut.

**Diagnose**

1. Prüfen Sie, ob die Apps laufen - erwartet: Die Keryx-Seite zeigt `hdvisionsystems` mit den Apps.
2. Vergleichen Sie die `--keryx-url` des Connectors mit der Broker-Adresse, die die Apps in ihren Logs nennen - erwartet: dieselbe Adresse.
3. Browsen Sie nach etwa 2 Sekunden erneut - erwartet: Eine später gestartete App erscheint.

**Lösung**

- **Wenn die Apps nicht laufen:** Starten Sie sie.
- **Wenn der Connector eine andere Adresse verwendet:** Starten Sie ihn mit derselben `--keryx-url` wie die Apps neu.
- **Wenn eine App gerade erst gestartet wurde:** Browsen Sie erneut. Es gibt keine Model-Change-Events: Ein Client, der sein Browse-Ergebnis zwischengespeichert hat, muss erneut browsen.

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit den Optionen des Connectors und seinem Log.

### Problem: `BadNodeIdUnknown` {#ts-opcua-bad-node-id}

**Symptome**

Ein Lese-, Schreib- oder Methodenaufruf über OPC UA antwortet mit `BadNodeIdUnknown`.

**Mögliche Ursachen**

- Die Adresse, ihre Groß-/Kleinschreibung oder der Namespace-Index ist falsch.
- Die App läuft nicht.
- Das Modul fehlt.

**Diagnose**

1. Ermitteln Sie den Namespace-Index `n` der URI `urn:hdvisionsystems:keryx` im `NamespaceArray` des Servers - erwartet: der Index, den Ihr Programm verwendet.
2. Prüfen Sie die NodeId - erwartet: `ns=<n>;s=<address>`, mit der Data-Layer-Adresse in Kleinbuchstaben, zum Beispiel `ns=<n>;s=hdvisionsystems/lumiscan-cam-driver/camera1/control/status/code`.
3. Lesen Sie `hdvisionsystems/<app>/system/found-modules` - erwartet: Das Modul ist aufgeführt.

**Lösung**

- **Wenn der Namespace-Index falsch ist:** Ermitteln Sie ihn nach jedem Verbindungsaufbau anhand seiner URI. Schreiben Sie keinen festen Index in Ihr Programm: Bei einem anderen Start kann er anders nummeriert sein.
- **Wenn die Adresse falsch ist:** Korrigieren Sie Groß-/Kleinschreibung und Schreibweise, siehe [Problem: Ein Knoten ist „not found"](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html#node-not-found).
- **Wenn die App nicht läuft oder das Modul fehlt:** Siehe [Problem: Eine App oder ein Modul fehlt im Baum](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-keryx-de/1.0.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit der NodeId und dem Inhalt des `NamespaceArray` des Servers.

### Problem: `BadTypeMismatch` beim Schreiben {#faq-opcua-type-mismatch}

**Symptome**

Ein Schreibvorgang über OPC UA antwortet mit `BadTypeMismatch`.

**Mögliche Ursachen**

- Der Typ des Werts entspricht nicht exakt dem Typ des Knotens. Der Connector konvertiert nicht: Ein `Boolean`-Knoten nimmt einen Boolean an, nicht 0 oder 1; ein `UInt32`-Knoten nimmt UInt32 an, nicht Int32.

**Diagnose**

1. Ermitteln Sie den Typ des Knotens, zum Beispiel auf der Keryx-Seite (wählen Sie den Knoten aus) - erwartet: der Typ, den Ihr Client sendet, zugeordnet wie unter [Lesen, Schreiben und Typen](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/opc-ua.html#types).

**Lösung**

- **Wenn der Typ abweicht:** Senden Sie exakt den Typ des Knotens, zum Beispiel `Boolean` für Flags und `UInt32` für `queue-size`.

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit der Adresse des Knotens und dem Typ, den Ihr Client sendet.

### Problem: Eine Subscription erhält nur einen Wert oder verpasst Ergebnisse {#ts-opcua-subscription}

**Symptome**

Ein Monitored Item meldet nur einen Wert oder weniger Benachrichtigungen, als die App pusht.

**Mögliche Ursachen**

- Die Einstellungen des Monitored Item weichen von den empfohlenen ab: Sampling Interval nicht `0`, eine Queue Size von 1 (nur der neueste Push kommt an) oder ein anderer DataChange Trigger als `StatusValueTimestamp` (zwei identische Ergebnisse zählen als eines).
- Der Knoten pusht nicht: Ein Wert, der zu groß ist, um gepusht zu werden, meldet sich im Event-Modus nie.
- Der Connector hat beim Start festgestellt, dass der Event-Modus nicht funktioniert, und tastet jedes Item per Timer ab.

**Diagnose**

1. Vergleichen Sie die Subscription mit [Subscriptions](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/opc-ua.html#subscriptions) - erwartet: Publishing Interval 10 ms oder mehr, Sampling Interval `0`, Queue Size 10 bis 100, DataChange Trigger `StatusValueTimestamp`, DiscardOldest `true`.
2. Lesen Sie zuerst das Log des Connectors - erwartet: keine Meldung, dass er im Sampling-Modus arbeitet.

**Lösung**

- **Wenn die Einstellungen abweichen:** Stellen Sie sie wie empfohlen ein. Verwenden Sie Sampling Interval `0` nur bei Knoten, die pushen.
- **Wenn der Knoten nicht pusht:** Verwenden Sie dafür ein positives Sampling Interval.
- **Wenn der Connector im Sampling-Modus arbeitet:** Wenden Sie sich mit seinem Log an den Support.

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit den Einstellungen der Subscription und dem Log des Connectors.

### Problem: Benachrichtigungen bleiben nach einem Neustart des Connectors oder einer App aus {#ts-opcua-notifications-stop}

**Symptome**

Nach einem Neustart des Connectors erhält der Client keine Benachrichtigungen. Nach einem Neustart einer App meldet sich ein Monitored Item nicht wieder, oder Lesezugriffe liefern `BadTimeout`, dann `BadNoCommunication`.

**Mögliche Ursachen**

- Der Connector wurde neu gestartet: Die Subscriptions des Clients sind weg.
- Eine App wurde gestoppt oder neu gestartet. Eine App, die stoppt, behält ihre Knoten im Baum; Lesezugriffe darauf liefern `BadTimeout`, dann `BadNoCommunication`, bis sich die App wieder registriert. Nach dem Neustart ist die Kamera nicht verbunden und der Stream des Cam Driver ist aus.

**Diagnose**

1. Prüfen Sie, ob der Connector oder eine App zu dem Zeitpunkt neu gestartet wurde, an dem die Benachrichtigungen ausblieben.
2. Lesen Sie einen Knoten der App - erwartet: ein Wert, nicht `BadTimeout` oder `BadNoCommunication`.

**Lösung**

- **Wenn der Connector neu gestartet wurde:** Verbinden Sie sich neu und legen Sie die Subscriptions erneut an.

- **Wenn eine App neu gestartet wurde:**

  a. Warten Sie, bis sich die App wieder registriert hat.

  b. Führen Sie Ihre Startsequenz erneut aus.

  c. Meldet sich ein Monitored Item nicht wieder, löschen Sie es und legen Sie es neu an.

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit dem Zeitpunkt des Neustarts und dem Log des Connectors.

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

Besteht das Problem weiter, wenden Sie sich an [customer.success@hdvisionsystems.com](mailto:customer.success@hdvisionsystems.com), +49 6221 6721905. Für Lizenzen: [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com). Senden Sie bitte:

- die App und ihre Version;
- die Plattform: Windows 11, Ubuntu 24.04 oder ctrlX OS mit seiner Version;
- Datum und Uhrzeit des Fehlers;
- das Log der App; auf ctrlX OS aus dem Systemprotokoll (Logbuch der ctrlX-Weboberfläche oder `journalctl`);
- auf einem PC das Log des Brokers aus `C:\ProgramData\HD Vision Systems GmbH\LumiScan Keryx` (Windows) oder `/tmp/lumiscan-keryx` (Ubuntu) und, falls Sie sie verwenden, die Logs des OPC UA Connector und von LumiScan Keryx Utilities;
- den Kommunikationsstatus: die Data-Layer-Adresse, die die Apps verwenden, den Inhalt von `system/found-modules` und `system/status-text`, den Modulstatus (`control/status/code` und `text` bzw. `status-code` und `status-text` eines Finders), das Ergebnis eines abgelehnten Aufrufs und bei OPC UA den Statuscode und die Optionen des Connectors;
- die Konfiguration: die Einstellungsdateien der App (auf einem PC in `C:\ProgramData\HD Vision Systems GmbH\LumiScan Vision Suite\<program>\etc\<settings folder>`, auf ctrlX OS im Ordner der App unter `/var/snap/rexroth-solutions/common/solutions/activeConfiguration`) oder den Inhalt von `system/settings`, und auf einem PC `broker.json`.
