# LumiScan Lizenzierung 1.0.4 – complete documentation

> All pages of the LumiScan Lizenzierung 1.0.4 manual (language: de) by HD Vision Systems GmbH, in navigation order. Each page starts with a level-1 heading followed by its URL; cite that URL. Manual: https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/

# LumiScan Lizenzierung

URL: https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/index.html

|   |   |   |
| --- | --- | --- |
| ![LumiScan-Key-USB-Stick mit Seriennummer 3-1234567](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/_images/intro/step-1.svg)<br><br>**Ihren Lizenzweg finden.** LumiScan Key, ctrlX WORKS oder ctrlX OS License Manager. | ![Lizenz-Update-Datei, die in CodeMeter eingespielt wird](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/_images/intro/step-2.svg)<br><br>**Das Lizenz-Update einspielen.** Mit der CodeMeter Runtime in den LumiScan Key. | Beispiellizenzen<br><br><br><br><br><br><br>LumiScan Key<br>3-1234567<br><br><br>Cam Driver<br>2 Kameras<br><br><br>Object Finder<br>10 Module<br><br><br>Training<br>jährlich<br><br>**Ihre Produkte sind lizenziert.** Engineering-Apps im Abo, Laufzeiten einmalig. |

LumiScan Licensing erklärt an einer Stelle, wie Sie jedes LumiScan-Produkt lizenzieren: Lizenzen installieren, anfordern, verlängern und umziehen. Welcher Weg gilt, hängt davon ab, wo Sie die Software gekauft haben und wo sie läuft: LumiScan Key bei Kauf bei HD Vision Systems, ctrlX WORKS unter Windows oder der ctrlX OS License Manager. Engineering-Apps sind ein Jahresabonnement, Laufzeiten und Vision-Apps ein Einmalkauf.

Dieses Handbuch beschreibt, wie Sie LumiScan-Software lizenzieren. Es gilt für alle LumiScan-Produkte: für die Engineering-Apps (zum Beispiel LumiScan Annotation Framework, LumiScan Training Framework und LumiScan VGR Engineering) und für die Runtimes und Vision Apps (zum Beispiel LumiScan VGR, LumiScan CamDriver und die Code Reader).

Die Produkthandbücher nennen nur, **welche** Lizenz ein Produkt benötigt. **Wie** Sie eine Lizenz installieren, anfordern, verlängern und an einem anderen PC verwenden, steht für alle Produkte gemeinsam hier.

## Einstieg

1. Ermitteln Sie Ihren Fall unter [Welcher Lizenzierungsweg gilt](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/which-licensing-path.html). Er hängt davon ab, wo Sie die Software gekauft haben und wo sie läuft.
2. Wenn Ihr Fall den LumiScan Key verwendet, lesen Sie [Der LumiScan Key](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/lumiscan-key.html) und installieren Sie die [CodeMeter Runtime](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/installing-codemeter.html).
3. Folgen Sie der Seite für Ihren Lizenzierungsweg.

Kurze Antworten auf häufige Fragen: [FAQ zur Lizenzierung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/faq.html).

## Kontakt

Senden Sie Lizenzanforderungen und Fragen zur Lizenzierung an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com). Geben Sie dabei bitte immer Ihren Firmennamen, die Bestell- oder Rechnungsnummer und die Seriennummer Ihres LumiScan Key an.

# Welcher Lizenzierungsweg gilt – LumiScan Lizenzierung

URL: https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/which-licensing-path.html

Zwei Dinge bestimmen, wie Ihre LumiScan-Software lizenziert wird: wo Sie sie gekauft haben und wo sie läuft.

**Bezugsquelle und Plattform bestimmen den Lizenzierungsweg**

```mermaid
%% Welcher Lizenzierungsweg gilt. Mermaid rendert es im Browser; bearbeiten und Vorschau unter https://mermaid.live
flowchart LR
  subgraph bought["Gekauft bei"]
    direction TB
    hdvs["`**HD Vision Systems**`"]
    store["`**ctrlX Store**
    Bosch Rexroth`"]
  end
  subgraph runs["Läuft auf"]
    direction TB
    pc["Windows 11 oder Ubuntu 24.04"]
    win["`Windows 11
    Engineering-Apps, Runtimes`"]
    os["`ctrlX OS
    CORE oder IPC, Runtimes`"]
  end
  subgraph lic["Lizenzierung"]
    direction TB
    key["`**Lizenz auf dem LumiScan Key**
    Engineering-Apps: Update jedes Jahr
    Runtimes: einmal aktivieren`"]
    works["`**Lizenz in ctrlX WORKS**
    + LumiScan Key als Softwareschutz
    Key-Update nur für neue Produkte`"]
    ctrlx["`**ctrlX-Lizenz in ctrlX OS**
    License Manager von ctrlX OS
    Kein LumiScan Key`"]
  end
  hdvs --> pc --> key
  store --> win --> works
  store --> os --> ctrlx
  class key,works,ctrlx key
  classDef key fill:#faf6dc,stroke:#a8961f,color:#1f2328
```

| Gekauft bei | Läuft auf | Wo die Lizenz liegt | Rolle des LumiScan Key |
| --- | --- | --- | --- |
| HD Vision Systems | Windows 11 oder Ubuntu 24.04 | Auf dem LumiScan Key | Trägt die Lizenz. Engineering-Apps benötigen jedes Jahr ein Lizenz-Update. |
| ctrlX Store (Bosch Rexroth) | Windows 11 | In ctrlX WORKS | Zusätzlich erforderlich. Er schützt die Software vor Reverse Engineering, trägt aber nicht die Lizenz. Er wird nur aktualisiert, wenn Sie ein weiteres LumiScan-Produkt hinzufügen. |
| ctrlX Store (Bosch Rexroth) | ctrlX OS auf einer ctrlX CORE oder einem IPC (Runtimes, nativ auf ctrlX OS) | Im License Manager von ctrlX OS | Wird nicht verwendet. |

Weiter mit der Seite für Ihren Weg:

- [Gekauft bei HD Vision Systems](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/path-hdvs.html)
- [Gekauft im ctrlX Store, Betrieb unter Windows](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/path-ctrlx-windows.html)
- [Gekauft im ctrlX Store, Betrieb auf ctrlX OS](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/path-ctrlx-os.html)

> [!NOTE]
> Wenn Sie mehrere LumiScan-Produkte verwenden, kann jedes einem anderen Weg folgen. Ein im ctrlX Store gekauftes LumiScan Annotation Framework ist zum Beispiel in ctrlX WORKS auf Ihrem Windows-PC lizenziert, LumiScan AI Object Matching auf einer ctrlX CORE dagegen mit einer ctrlX-Lizenz dort.

# Der LumiScan Key – LumiScan Lizenzierung

URL: https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/lumiscan-key.html

Der LumiScan Key ist der USB-Lizenzstick für LumiScan-Software. Technisch ist er ein CodeMeter-Container der WIBU-SYSTEMS AG. In allen Dokumenten und in der Kommunikation von HD Vision Systems heißt er LumiScan Key.

## Den Key erkennen {#recognising-the-key}

CodeMeter Control Center zeigt im Reiter **License** alle Lizenzcontainer an, die auf dem PC verfügbar sind. Der LumiScan Key erscheint dort als **CmStick/C** mit einer Seriennummer der Form `3-1234567`. Die Seriennummer ist auch auf dem Key aufgedruckt.

![CodeMeter Control Center](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/_images/cc-license-tab.png)

*Abbildung 1. Der LumiScan Key (CmStick/C) im Reiter License von CodeMeter Control Center*

Weitere Einträge, zum Beispiel **MVTec SW Container**, gehören zu Software anderer Hersteller und sind für die LumiScan-Lizenzierung nicht relevant.

Auf einem PC ohne grafische Oberfläche zeigt `cmu --list` dieselben Informationen (siehe [Installation prüfen](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/installing-codemeter.html#checking-the-installation)).

## Aufgaben des Keys

Je nach Lizenzierungsweg hat der LumiScan Key eine von zwei Aufgaben:

- **Lizenzträger:** Bei Software, die Sie bei HD Vision Systems gekauft haben, liegen die Lizenzen auf dem Key. Ein PC kann die lizenzierten Produkte nur nutzen, solange der Key verfügbar ist.
- **Softwareschutz:** Bei Apps aus dem ctrlX Store, die unter Windows 11 laufen, liegt die Lizenz in ctrlX WORKS. Der Key ist trotzdem erforderlich, weil er die Software vor Reverse Engineering schützt. Er enthält keine zweite Lizenz, und Sie bezahlen nicht doppelt.

Welche Aufgabe für Sie gilt, steht unter [Welcher Lizenzierungsweg gilt](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/which-licensing-path.html).

## Ein Key für mehrere Produkte

Ein einzelner LumiScan Key kann Lizenzen für mehrere LumiScan-Produkte tragen. Wenn Sie ein weiteres Produkt kaufen, ergänzt HD Vision Systems es mit einem Lizenz-Update auf Ihrem vorhandenen Key (siehe [Lizenzanforderung erstellen](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/requesting-a-licence-update.html)). Für das neue Produkt benötigen Sie keinen zusätzlichen Key.

## Ein Key pro Gerät {#one-key-per-device}

Für jedes Gerät, auf dem LumiScan-Software gleichzeitig läuft, benötigen Sie einen eigenen LumiScan Key. Um die Software zum Beispiel gleichzeitig auf drei PCs zu betreiben, benötigen Sie drei Keys.

Die Keys sind nicht an ein Gerät gebunden. Sie können einen LumiScan Key jederzeit zwischen verschiedenen Geräten austauschen, zum Beispiel von einem Test-PC an den Produktions-PC (siehe [Key an einem anderen PC verwenden](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/moving-the-key.html)).

Sind die Lizenzen auf einem Key bereits belegt, meldet die Anwendung `User maximum reached!` (siehe [Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/troubleshooting.html#user-maximum-reached)).

## Umgang mit dem Key

- Bewahren Sie den Key sicher auf. Die Lizenzen sind auf ihm gespeichert; ein verlorener Key bedeutet verlorene Lizenzen.
- Ziehen Sie den Key nicht ab, während eine LumiScan-Anwendung läuft oder ein Lizenz-Update geschrieben wird.
- Bleibt der Key an einer Maschine gesteckt, sichern Sie ihn gegen versehentliches Abziehen, zum Beispiel mit einer kurzen, im Schaltschrank befestigten USB-Verlängerung.

# CodeMeter Runtime installieren – LumiScan Lizenzierung

URL: https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/installing-codemeter.html

Jeder PC, der einen LumiScan Key verwendet, benötigt die CodeMeter Runtime der WIBU-SYSTEMS AG. Das gilt für beide Lizenzierungswege mit Key: für Software, die Sie bei HD Vision Systems gekauft haben, und für Software aus dem ctrlX Store, die unter Windows 11 läuft.

LumiScan-Software benötigt die CodeMeter Runtime **9.00 oder neuer**. Diese Mindestversion gilt für alle LumiScan-Produkte. Ist eine ältere Version installiert, aktualisieren Sie sie, bevor Sie LumiScan-Software installieren oder starten.

> [!TIP]
> Anwendungen, die nativ auf ctrlX OS laufen, benötigen keine CodeMeter Runtime (siehe [Gekauft im ctrlX Store, Betrieb auf ctrlX OS](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/path-ctrlx-os.html)).

## Windows 11

1. Laden Sie die **CodeMeter User Runtime für Windows** von der [Anwendersoftware-Seite der WIBU-SYSTEMS AG](https://www.wibu.com/de/support/anwendersoftware/anwendersoftware.html) herunter.

2. Führen Sie das Installationsprogramm aus und folgen Sie den Anweisungen des Herstellers. Dafür sind Administratorrechte erforderlich.

3. Stecken Sie den LumiScan Key in einen freien USB-Anschluss.

   Die LED am Key blinkt kurz, und Windows erkennt das neue USB-Gerät.

4. Öffnen Sie **CodeMeter Control Center**, zum Beispiel über die Windows-Suche.

   ![Windows-Suche mit CodeMeter Control Center](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/_images/cc-windows-search.png)

   Der LumiScan Key erscheint im Reiter **License** als **CmStick/C** (siehe [Den Key erkennen](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/lumiscan-key.html#recognising-the-key)).

## Ubuntu 24.04

1. Laden Sie die **CodeMeter User Runtime für Linux** als `.deb`-Paket für Ihre Architektur (x86_64 oder arm64) von der [Anwendersoftware-Seite der WIBU-SYSTEMS AG](https://www.wibu.com/de/support/anwendersoftware/anwendersoftware.html) herunter.
2. Installieren Sie das Paket:
   ```bash
   sudo apt install ./codemeter_*.deb
   ```
3. Prüfen Sie, ob der CodeMeter-Dienst läuft:
   ```bash
   systemctl status codemeter
   ```
4. Stecken Sie den LumiScan Key in einen freien USB-Anschluss.

## Installation prüfen {#checking-the-installation}

Auf beiden Systemen zeigt das Kommandozeilenwerkzeug `cmu` die installierte Version und die angeschlossenen Container. Unter Windows heißt es `cmu32` und steht in der **CodeMeter-Eingabeaufforderung** zur Verfügung.

```bash
cmu --version
cmu --list
```

`cmu --list` führt den LumiScan Key mit seiner Seriennummer auf. Meldet der Befehl `0 CmContainer(s) listed`, siehe [Key wird nicht erkannt](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/troubleshooting.html#key-not-detected).

## Virtuelle Maschinen und Container {#virtual-machines-and-containers}

Der LumiScan Key ist ein USB-Gerät. Läuft LumiScan-Software in einer virtuellen Maschine, reichen Sie das USB-Gerät an die virtuelle Maschine durch und installieren Sie die CodeMeter Runtime dort.

Läuft LumiScan-Software in einem Container, betreiben Sie die CodeMeter Runtime mit dem Key auf dem Host und lassen Sie die Software im Container über das Netzwerk darauf zugreifen. Aktivieren Sie dazu in CodeMeter WebAdmin auf dem Host den Netzwerkserver (**Configuration › Server › Server Access**). Die Software erreicht den Key dann über TCP-Port 22350.

# Gekauft bei HD Vision Systems – LumiScan Lizenzierung

URL: https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/path-hdvs.html

Dieser Weg gilt für LumiScan-Software, die Sie direkt bei HD Vision Systems gekauft haben und unter Windows 11 oder Ubuntu 24.04 betreiben. Die Lizenzen liegen auf Ihrem LumiScan Key.

## Was Sie benötigen

- Einen LumiScan Key für jedes Gerät, auf dem die Software gleichzeitig läuft. Keys können zwischen Geräten ausgetauscht werden (siehe [Ein Key pro Gerät](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/lumiscan-key.html#one-key-per-device)).
- CodeMeter Runtime 9.00 oder neuer (siehe [CodeMeter Runtime installieren](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/installing-codemeter.html)).

## Engineering-Apps und Runtimes

| Produktart | Lizenz | Was Sie tun müssen |
| --- | --- | --- |
| Engineering-Apps<br> (zum Beispiel LumiScan Annotation Framework, LumiScan Training Framework, LumiScan VGR Engineering) | Jahresabonnement. Es besteht aus einer einmaligen Einstiegsgebühr und einer jährlichen Lizenzgebühr, die Wartung und Updates enthält. | Einmal aktivieren, dann jedes Jahr mit einem Lizenz-Update verlängern. Die Verlängerung setzt ein gültiges Abonnement voraus. Ohne gültiges Abonnement kann die App nicht mehr genutzt werden. |
| Runtimes und Vision Apps<br> (zum Beispiel LumiScan VGR, LumiScan CamDriver, die Code Reader) | Einmalkauf, unbefristete Nutzung. | Einmal aktivieren. Keine Verlängerung. |

## Lizenzen aktivieren

Wurde Ihr LumiScan Key bereits mit Ihren Lizenzen geliefert, stecken Sie den Key ein und starten Sie die Software.

So ergänzen Sie Lizenzen auf dem Key, zum Beispiel für ein weiteres Produkt:

1. [Erstellen Sie eine Lizenzanforderung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/requesting-a-licence-update.html) und senden Sie sie an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com).
2. [Spielen Sie das Lizenz-Update ein](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/importing-a-licence-update.html), das Sie von HD Vision Systems erhalten.

## Jedes Jahr: Engineering-Lizenzen verlängern

Engineering-Lizenzen laufen ein Jahr. Verlängern Sie sie vor dem Ablauf, wie unter [Engineering-Lizenzen verlängern](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/renewing-engineering-licences.html) beschrieben.

# Gekauft im ctrlX Store, Betrieb unter Windows – LumiScan Lizenzierung

URL: https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/path-ctrlx-windows.html

Dieser Weg gilt für LumiScan-Software, die Sie im ctrlX Store von Bosch Rexroth gekauft haben und unter Windows 11 betreiben: für Engineering-Apps (zum Beispiel LumiScan Annotation Framework) ebenso wie für Runtimes (zum Beispiel LumiScan VGR oder eine Vision App auf einem Windows-IPC).

Sie benötigen zwei Dinge mit unterschiedlichen Aufgaben:

|   | Aufgabe | Verlängerung |
| --- | --- | --- |
| Lizenz in ctrlX WORKS | Berechtigt Sie zur Nutzung der App. | Wie mit Bosch Rexroth vereinbart. |
| LumiScan Key | Schützt die Software vor Reverse Engineering. Er trägt nicht die Lizenz. | Keine. Er wird nur aktualisiert, wenn Sie ein weiteres LumiScan-Produkt hinzufügen. |

## Was Sie benötigen

- Die Lizenz für die App, gekauft im ctrlX Store und aktiviert in ctrlX WORKS. Folgen Sie dazu der Dokumentation von Bosch Rexroth zu ctrlX WORKS.
- Einen LumiScan Key für jeden Windows-PC, auf dem die Software gleichzeitig läuft. Sie kaufen ihn im Bosch Rexroth Store; er wird mit einer Grundeinrichtung geliefert. Keys können zwischen PCs ausgetauscht werden (siehe [Ein Key pro Gerät](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/lumiscan-key.html#one-key-per-device)).
- CodeMeter Runtime 9.00 oder neuer (siehe [CodeMeter Runtime installieren](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/installing-codemeter.html)).

## Einrichten

1. Installieren Sie die CodeMeter Runtime und stecken Sie den LumiScan Key ein (siehe [CodeMeter Runtime installieren](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/installing-codemeter.html)).
2. Aktivieren Sie die App-Lizenz in ctrlX WORKS.
3. Installieren und starten Sie die LumiScan-App.

## Ein weiteres LumiScan-Produkt hinzufügen

Wenn Sie ein weiteres LumiScan-Produkt für Windows 11 im ctrlX Store kaufen, muss Ihr LumiScan Key einmalig dafür freigeschaltet werden:

1. [Erstellen Sie eine Lizenzanforderung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/requesting-a-licence-update.html) aus Ihrem LumiScan Key.
2. Senden Sie sie an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com), zusammen mit Ihrer ctrlX-Store-Bestellnummer und dem hinzugefügten Produkt.
3. [Spielen Sie das Lizenz-Update ein](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/importing-a-licence-update.html), das Sie von HD Vision Systems erhalten.

Auf diesem Weg gibt es kein jährliches Update des LumiScan Key.

# Gekauft im ctrlX Store, Betrieb auf ctrlX OS – LumiScan Lizenzierung

URL: https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/path-ctrlx-os.html

Dieser Weg gilt für LumiScan-Runtimes und Vision Apps, die Sie im ctrlX Store von Bosch Rexroth gekauft haben und nativ auf ctrlX OS betreiben, entweder auf einer ctrlX CORE oder auf einem IPC mit ctrlX OS (zum Beispiel einem ctrlX IPC von Bosch Rexroth). Der LumiScan Key und die CodeMeter Runtime werden nicht verwendet.

## So funktioniert es

- Jede LumiScan-App benötigt eine eigene ctrlX-Lizenz. Die Teilenummer steht in der [Lizenzübersicht](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/licence-reference.html) und auf der Seite **Requirements** des App-Handbuchs.
- Sie kaufen die Lizenz im ctrlX Store und aktivieren sie im License Manager von ctrlX OS. Folgen Sie dazu der Dokumentation von Bosch Rexroth zu ctrlX OS.
- Die Lizenz muss auf dem ctrlX-OS-Gerät verfügbar sein, auf dem die App läuft.

## Verhalten der Apps

- Beim Start reserviert die App die benötigten Lizenzen. Während sie läuft, erneuert sie sie alle 30 Minuten.
- Fehlt eine benötigte Lizenz, beendet sich die App kurz nach dem Start. Der Grund steht im Systemprotokoll von ctrlX OS.
- Steht eine Lizenz während des Betriebs nicht mehr zur Verfügung, beendet sich die App.
- Manche Apps benötigen mehr als eine Lizenz, zum Beispiel benötigt LumiScan CamDriver eine Lizenz pro Kamera. Siehe [Zählregeln](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/licence-reference.html#counting-rules).

# Lizenzanforderung erstellen – LumiScan Lizenzierung

URL: https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/requesting-a-licence-update.html

Sie können Lizenzen auf Ihrem LumiScan Key hinzufügen oder erweitern, ohne den Key einzuschicken. Der Ablauf besteht aus drei Schritten:

**Ein Lizenz-Update anfordern: Anforderung, Update, Einspielen**

```mermaid
%% Ein Lizenz-Update anfordern. Mermaid rendert es im Browser; bearbeiten und Vorschau unter https://mermaid.live
sequenceDiagram
  participant P as Ihr PC + LumiScan Key
  participant H as HD Vision Systems
  Note over P: 1 · Anforderung erstellen<br/>3-1234567.WibuCmRaC
  P->>H: E-Mail an licenses@hdvisionsystems.com
  Note over H: 2 · Update erstellen<br/>passend nur zu diesem Key
  H->>P: E-Mail zurück an Sie
  Note over P: 3 · Update einspielen<br/>3-1234567.WibuCmRaU
```

1. Sie erstellen eine Lizenzanforderungsdatei (`.WibuCmRaC`) und senden sie an HD Vision Systems.
2. HD Vision Systems sendet Ihnen eine passende Lizenz-Update-Datei (`.WibuCmRaU`).
3. Sie [spielen die Lizenz-Update-Datei](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/importing-a-licence-update.html) auf den LumiScan Key ein.

Die Lizenzanforderungsdatei beschreibt nur den aktuellen Zustand Ihres LumiScan Key. Sie enthält keine personenbezogenen Daten und verändert Ihre Lizenzen nicht.

> [!IMPORTANT]
> Eine Lizenz-Update-Datei passt nur zu dem LumiScan Key und dem Zustand, aus dem die Lizenzanforderung erstellt wurde. Jede Lizenz-Update-Datei kann nur einmal eingespielt werden. Spielen Sie bis zum Import des Updates von HD Vision Systems keine anderen Lizenz-Updates auf diesen LumiScan Key ein.

## Voraussetzungen

- Die CodeMeter Runtime ist installiert (siehe [CodeMeter Runtime installieren](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/installing-codemeter.html)).
- Der LumiScan Key ist an den PC angeschlossen.

## Anforderung in CodeMeter Control Center erstellen

1. Öffnen Sie **CodeMeter Control Center**, zum Beispiel über die Windows-Suche.

2. Wählen Sie im Reiter **License** links Ihren LumiScan Key aus und klicken Sie auf **License Update**.

   ![Reiter License mit ausgewähltem LumiScan Key und hervorgehobener Schaltfläche License Update](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/_images/cc-license-tab.png)

   Der CmFAS-Assistent öffnet sich.

3. Klicken Sie auf der Willkommensseite auf **Next**.

   ![Willkommensseite des CmFAS-Assistenten](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/_images/cmfas-welcome.png)

4. Wählen Sie **Create license request** und klicken Sie auf **Next**.

   ![CmFAS-Assistent mit ausgewählter Option Create license request](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/_images/cmfas-create-request.png)

5. Wählen Sie **Extend existing license** und klicken Sie auf **Next**.

   ![CmFAS-Assistent mit ausgewählter Option Extend existing license](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/_images/cmfas-extend-existing.png)

6. Aktivieren Sie **HD Vision Systems GmbH (6000380)** und klicken Sie auf **Next**.

   ![Herstellerliste im CmFAS-Assistenten mit ausgewähltem Eintrag HD Vision Systems GmbH (6000380)](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/_images/cmfas-select-vendor.png)
   > [!NOTE]
   > Wird **HD Vision Systems GmbH (6000380)** nicht angezeigt, ist in Schritt 2 nicht der LumiScan Key ausgewählt. Schließen Sie den Assistenten und beginnen Sie erneut mit Schritt 2.

7. Prüfen Sie den Speicherort und den Dateinamen und klicken Sie auf **Commit**.

   Der vorgeschlagene Dateiname enthält die Seriennummer des LumiScan Key, zum Beispiel `3-1234567.WibuCmRaC`. Behalten Sie diesen Namen bei, damit die Datei eindeutig zugeordnet werden kann.

   ![CmFAS-Assistent mit dem Dateinamen der Lizenzanforderung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/_images/cmfas-request-filename.png)

   Die Lizenzanforderungsdatei wird am angegebenen Speicherort erstellt.

   ![Symbol der erstellten .WibuCmRaC-Datei](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/_images/request-file-created.png)

8. Senden Sie die Datei `.WibuCmRaC` per E-Mail an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com). Geben Sie in der E-Mail Ihre Bestell- oder Angebotsnummer und die gewünschten LumiScan-Produkte an.

## Anforderung über die Kommandozeile erstellen {#command-line}

Auf einem PC ohne grafische Oberfläche, zum Beispiel Ubuntu 24.04 ohne Desktop, verwenden Sie `cmu`. Unter Windows heißt es `cmu32` und steht in der **CodeMeter-Eingabeaufforderung** zur Verfügung.

1. Lassen Sie die Seriennummer des LumiScan Key anzeigen:
   ```bash
   cmu --list
   ```
2. Erstellen Sie die Lizenzanforderung. Ersetzen Sie `3-1234567` durch die Seriennummer Ihres LumiScan Key:
   ```bash
   cmu --context 6000380 --serial 3-1234567 --file 3-1234567.WibuCmRaC
   ```
3. Senden Sie die Datei `.WibuCmRaC` wie oben beschrieben per E-Mail an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com).

# Lizenz-Update einspielen – LumiScan Lizenzierung

URL: https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/importing-a-licence-update.html

Nach der Bearbeitung Ihrer [Lizenzanforderung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/requesting-a-licence-update.html) erhalten Sie von HD Vision Systems eine Lizenz-Update-Datei (`.WibuCmRaU`). Der Dateiname enthält die Seriennummer des LumiScan Key, für den das Update bestimmt ist.

> [!IMPORTANT]
> Ziehen Sie den LumiScan Key nicht ab, während das Lizenz-Update geschrieben wird.

## Mit dem CmFAS-Assistenten einspielen

1. Speichern Sie die Datei `.WibuCmRaU` auf dem PC, an dem der LumiScan Key angeschlossen ist.

2. Prüfen Sie, ob die Seriennummer im Dateinamen mit der Seriennummer Ihres LumiScan Key übereinstimmt.

3. Öffnen Sie **CodeMeter Control Center**.

4. Wählen Sie im Reiter **License** links Ihren LumiScan Key aus und klicken Sie auf **License Update**.

   Der CmFAS-Assistent öffnet sich.

5. Klicken Sie auf der Willkommensseite auf **Next**.

6. Wählen Sie **Import license update** und klicken Sie auf **Next**.

   ![CmFAS-Assistent mit ausgewählter Option Import license update](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/_images/cmfas-import-update.png)

7. Klicken Sie auf **…**, wählen Sie die Datei `.WibuCmRaU` aus und klicken Sie auf **Commit**.

   ![CmFAS-Assistent mit dem Pfad der Lizenz-Update-Datei](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/_images/cmfas-update-filename.png)

   Das Lizenz-Update wird auf den LumiScan Key geschrieben.

8. Klicken Sie auf **Finish**.

Die neuen Lizenzen stehen sofort zur Verfügung. Bereits laufende LumiScan-Anwendungen müssen gegebenenfalls neu gestartet werden, damit sie die neuen Lizenzen verwenden.

## Über das Menü einspielen

Sie können die Lizenz-Update-Datei auch ohne den CmFAS-Assistenten einspielen:

1. Wählen Sie in CodeMeter Control Center **File > Import License…**.

   ![Menü File von CodeMeter Control Center mit dem Eintrag Import License](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/_images/cc-file-import-license.png)

2. Wählen Sie die Datei `.WibuCmRaU` aus und klicken Sie auf **Öffnen**.

   ![Dateidialog mit ausgewählter .WibuCmRaU-Datei](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/_images/import-file-dialog.png)

> [!TIP]
> Sie können die Datei `.WibuCmRaU` auch per Drag & Drop in das Fenster von CodeMeter Control Center ziehen.

## Über die Kommandozeile einspielen

Auf einem PC ohne grafische Oberfläche verwenden Sie `cmu` (unter Windows: `cmu32` in der **CodeMeter-Eingabeaufforderung**). Ersetzen Sie `3-1234567` durch die Seriennummer Ihres LumiScan Key:

```bash
cmu --import --file 3-1234567.WibuCmRaU
```

Schlägt der Import mit Fehler 705 fehl, siehe [Fehler 705 beim Import](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/troubleshooting.html#error-705).

# Engineering-Lizenzen verlängern – LumiScan Lizenzierung

URL: https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/renewing-engineering-licences.html

Engineering-Apps, die Sie bei HD Vision Systems gekauft haben, werden als Jahresabonnement lizenziert. Die Lizenz auf Ihrem LumiScan Key läuft ein Jahr und muss jedes Jahr mit einem Lizenz-Update verlängert werden.

> [!NOTE]
> Diese Seite gilt nur für Engineering-Apps, die Sie bei HD Vision Systems gekauft haben. Runtimes werden einmal gekauft und nicht verlängert. Bei Software aus dem ctrlX Store benötigt der LumiScan Key kein jährliches Update (siehe [Gekauft im ctrlX Store, Betrieb unter Windows](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/path-ctrlx-windows.html)).

## Ablaufdatum prüfen

- **In CodeMeter WebAdmin:**
  1. Klicken Sie in CodeMeter Control Center auf **WebAdmin**.
  2. Öffnen Sie **Container > Licenses** und wählen Sie Ihren LumiScan Key aus.
  3. Das Ablaufdatum wird für jede Lizenz angezeigt.

- **Über die Kommandozeile:** Ersetzen Sie `3-1234567` durch die Seriennummer Ihres LumiScan Key:
  ```bash
  cmu --list-content --serial 3-1234567
  ```

  Der Eintrag **Expiration Time** jeder Lizenz zeigt ihr Ablaufdatum.

## Verlängern

Eine Verlängerung setzt ein gültiges Abonnement voraus. HD Vision Systems stellt das Lizenz-Update nur aus, solange Ihr Abonnement für die Engineering-App aktiv ist, die jährliche Lizenzgebühr für das kommende Jahr also vereinbart ist. Wurde Ihr Abonnement gekündigt oder ist es ausgelaufen, wenden Sie sich zuerst an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com), um das Abonnement zu erneuern.

Wir empfehlen, die Verlängerung etwa vier Wochen vor dem Ablaufdatum zu beginnen.

1. [Erstellen Sie eine Lizenzanforderung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/requesting-a-licence-update.html) aus Ihrem LumiScan Key.
2. Senden Sie sie an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com). Schreiben Sie in der E-Mail, dass Sie Ihre Engineering-Lizenzen verlängern möchten, und geben Sie Ihre Kunden- oder Bestellnummer an.
3. [Spielen Sie das Lizenz-Update ein](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/importing-a-licence-update.html), das Sie von HD Vision Systems erhalten.

Die Verlängerung wird auf den Key geschrieben. Sie müssen die Software nicht neu installieren.

## Wenn das Abonnement abgelaufen ist

Ohne gültiges Abonnement kann die Engineering-App nicht mehr genutzt werden. Ihre Projekte und Daten sind davon nicht betroffen. Sobald Ihr Abonnement wieder gültig ist und Sie die Verlängerung eingespielt haben, ist die App wieder nutzbar.

# Key an einem anderen PC verwenden – LumiScan Lizenzierung

URL: https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/moving-the-key.html

Die Lizenzen auf dem LumiScan Key sind nicht an ein Gerät gebunden. Sie können einen Key jederzeit zwischen verschiedenen Geräten austauschen; für jedes Gerät, auf dem die Software gleichzeitig läuft, wird ein Key benötigt (siehe [Ein Key pro Gerät](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/lumiscan-key.html#one-key-per-device)).

So nutzen Sie LumiScan-Software an einem anderen PC:

1. Schließen Sie alle LumiScan-Anwendungen auf dem bisherigen PC.
2. Ziehen Sie den LumiScan Key ab.
3. Installieren Sie auf dem anderen PC die CodeMeter Runtime 9.00 oder neuer (siehe [CodeMeter Runtime installieren](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/installing-codemeter.html)) und die LumiScan-Software.
4. Stecken Sie den LumiScan Key ein und starten Sie die Software.

Sie müssen dafür weder HD Vision Systems kontaktieren noch ein Lizenz-Update anfordern.

> [!NOTE]
> Bei Apps aus dem ctrlX Store, die unter Windows 11 laufen, liegt die Lizenz in ctrlX WORKS. Für den Umzug dieser Lizenz auf einen anderen PC gelten die Regeln von Bosch Rexroth für ctrlX WORKS. Der LumiScan Key selbst wird wie oben beschrieben umgesteckt.

# Lizenzübersicht – LumiScan Lizenzierung

URL: https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/licence-reference.html

Diese Seite listet die ctrlX-Lizenzen der LumiScan-Apps und die Regeln, wie viele Lizenzen eine App benötigt.

## Teilenummern der ctrlX-Lizenzen

Diese Teilenummern gelten für Apps, die im ctrlX Store gekauft wurden und auf ctrlX OS laufen (siehe [Gekauft im ctrlX Store, Betrieb auf ctrlX OS](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/path-ctrlx-os.html)).

| App | Standard-Lizenz | Advanced-Lizenz |
| --- | --- | --- |
| LumiScan AI Object Matching | `SWL-W-XCx-OBJxMATCHxHDVSx-V2NN` | – |
| LumiScan Area Detector | `SWL-W-XCx-AxxDETECTxHDVSx-V1NN` | – |
| LumiScan Aztec Code Reader | `SWL-W-XCx-AZTECCRDSxHDVSx-V1NN` | `SWL-W-XCx-AZTECCRDAxHDVSx-V1NN` |
| LumiScan Barcode Reader | `SWL-W-XCx-BARxxCRDSxHDVSx-V1NN` | `SWL-W-XCx-BARxxCRDAxHDVSx-V1NN` |
| LumiScan Calibration | `SWL-W-XCx-CALIBRATExHDVSx-V2NN` | – |
| LumiScan CamDriver | `SWL-W-XCx-CAMDRIVERxHDVSx-V2NN` | – |
| LumiScan Cockpit | `SWL-W-XCx-COCKPITxxxHDVSx-V1NN` | – |
| LumiScan Dimensional Inspect | `SWL-W-XCx-DxINSPECTxHDVSx-V1NN` | – |
| LumiScan DMC Reader | `SWL-W-XCx-DMxxxCRDSxHDVSx-V1NN` | `SWL-W-XCx-DMxxxCRDAxHDVSx-V1NN` |
| LumiScan Object Finder | `SWL-W-XCx-OBJECTxFDxHDVS-V1NN` | – |
| LumiScan QR Code Reader | `SWL-W-XCx-QRxxxCRDSxHDVSx-V1NN` | `SWL-W-XCx-QRxxxCRDAxHDVSx-V1NN` |
| LumiScan Template Finder | `SWL-W-XCx-TEMPLxFDxxHDVS-V1NN` | – |
| LumiScan Text Reader | `SWL-W-XCx-TEXTxxRDSxHDVSx-V1NN` | `SWL-W-XCx-TEXTxxRDAxHDVSx-V1NN` |

Die letzte Gruppe einer Teilenummer ist die Lizenzversion. Version 2 von LumiScan AI Object Matching, LumiScan Calibration und LumiScan CamDriver benötigt die Lizenz mit `-V2NN`. Lizenzen mit der Endung `-NNNN` gehören zu früheren Versionen und funktionieren mit Version 2 nicht.

## Zählregeln {#counting-rules}

| App | Benötigte Lizenzen |
| --- | --- |
| LumiScan CamDriver | Eine Lizenz pro angeschlossener Kamera. Drei Kameras benötigen drei Lizenzen. |
| LumiScan Area Detector, LumiScan Object Finder, LumiScan Template Finder, LumiScan Text Reader | Eine Lizenz pro zehn Module. Das elfte Modul benötigt eine zweite Lizenz. |
| Alle anderen Apps | Eine Lizenz pro App-Instanz, für beliebig viele Module. |

## Standard und Advanced {#standard-and-advanced}

Die Code Reader (Aztec, Barcode, DMC, QR) und der Text Reader sind als Standard und Advanced erhältlich:

- Eine Advanced-Lizenz wird immer zusammen mit einer Standard-Lizenz verwendet. Für Advanced-Funktionen benötigen Sie beide.
- Ist eine Advanced-Lizenz verfügbar, verwendet die App sie automatisch.
- Ein Modul erhält seine Stufe beim Anlegen. Eine neu hinzugefügte Advanced-Lizenz gilt für danach angelegte Module oder nach einem Neustart für alle Module.
- Steht die Advanced-Lizenz während des Betriebs nicht mehr zur Verfügung, arbeitet die App standardmäßig mit den Standard-Funktionen weiter. Die Einstellung `licenseFallback` im Abschnitt `system` der App-Konfiguration ändert dieses Verhalten (`USE_BASIC`, `SKIP`, `STOP_APP`).

## Engineering-Apps und Runtimes

Bei Software, die Sie bei HD Vision Systems gekauft haben, liegen alle Lizenzen auf dem LumiScan Key:

- Engineering-Apps: Jahresabonnement, verlängert mit einem Lizenz-Update (siehe [Engineering-Lizenzen verlängern](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/renewing-engineering-licences.html)).
- Runtimes und Vision Apps: Einmalkauf, keine Verlängerung.

# FAQ zur Lizenzierung – LumiScan Lizenzierung

URL: https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/faq.html

Kurze Antworten auf die häufigsten Fragen zur Lizenzierung. Jede Antwort verweist auf die Seite mit dem vollständigen Ablauf. Zu Fehlermeldungen siehe auch [Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/troubleshooting.html).

> [!TIP]
> Jeder Eintrag hat einen festen Anker (zum Beispiel `#faq-one-key-per-device`), sodass Sie direkt darauf verlinken können.

## Welche Lizenz brauche ich?

### Welcher Lizenzierungsweg gilt für mich? {#faq-which-path}

Das hängt davon ab, wo Sie die Software gekauft haben und wo sie läuft:

- Bei HD Vision Systems gekauft, Betrieb unter Windows 11 oder Ubuntu 24.04: Die Lizenz liegt auf Ihrem LumiScan Key.
- Im ctrlX Store gekauft, Betrieb unter Windows 11: Die Lizenz liegt in ctrlX WORKS, zusätzlich ist ein LumiScan Key erforderlich.
- Im ctrlX Store gekauft, Betrieb unter ctrlX OS (ctrlX CORE oder IPC mit ctrlX OS): ctrlX-Lizenz im License Manager von ctrlX OS, kein LumiScan Key.

Details: [Welcher Lizenzierungsweg gilt](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/which-licensing-path.html).

### Wo finde ich die Lizenz-Teilenummer meiner App? {#faq-which-key-code}

Die ctrlX-Teilenummern (zum Beispiel `SWL-W-XCx-CAMDRIVERxHDVSx-V2NN`) und die Zählregeln stehen in der [Lizenzübersicht](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/licence-reference.html). Auch die Seite **Requirements** bzw. **Voraussetzungen** jedes Produkthandbuchs nennt die benötigte Lizenz.

### Wie viele Lizenzen benötigt eine App? {#faq-how-many-licences}

LumiScan CamDriver benötigt eine Lizenz pro angeschlossener Kamera. LumiScan Area Detector, Object Finder, Template Finder und Text Reader benötigen eine Lizenz pro zehn Module. Alle anderen Apps benötigen eine Lizenz pro App-Instanz. Siehe [Zählregeln](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/licence-reference.html#counting-rules).

### Was ist der Unterschied zwischen Standard und Advanced? {#faq-standard-advanced}

Die Code Reader (Aztec, Barcode, DMC, QR) und der Text Reader gibt es als Standard und Advanced. Eine Advanced-Lizenz wird immer zusammen mit einer Standard-Lizenz verwendet. Ist eine Advanced-Lizenz verfügbar, verwendet die App sie automatisch, sonst arbeitet sie mit den Standard-Funktionen. Siehe [Standard und Advanced](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/licence-reference.html#standard-and-advanced).

## Der LumiScan Key

### Was ist der LumiScan Key? {#faq-what-is-key}

Der USB-Lizenzstick für LumiScan-Software, ein CodeMeter-Container der WIBU-SYSTEMS AG. CodeMeter Control Center zeigt ihn als **CmStick/C** mit einer Seriennummer wie `3-1234567`; die Seriennummer ist auch auf dem Key aufgedruckt. Siehe [Der LumiScan Key](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/lumiscan-key.html).

### Brauche ich einen LumiScan Key pro PC? {#faq-one-key-per-device}

Ja. Für jedes Gerät, auf dem LumiScan-Software gleichzeitig läuft, benötigen Sie einen eigenen LumiScan Key. Für drei gleichzeitig betriebene PCs benötigen Sie drei Keys. Siehe [Ein Key pro Gerät](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/lumiscan-key.html#one-key-per-device).

### Kann ich meinen LumiScan Key an einem anderen PC verwenden? {#faq-move-key}

Ja. Keys sind nicht an ein Gerät gebunden und können jederzeit zwischen Geräten ausgetauscht werden. Schließen Sie die LumiScan-Anwendungen, ziehen Sie den Key ab, stecken Sie ihn am anderen PC (mit installierter CodeMeter Runtime) ein und starten Sie die Software. HD Vision Systems müssen Sie dafür nicht kontaktieren. Siehe [Key an einem anderen PC verwenden](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/moving-the-key.html).

### Kann ein Key Lizenzen für mehrere Produkte tragen? {#faq-several-products}

Ja. HD Vision Systems ergänzt weitere Produkte mit einem Lizenz-Update auf Ihrem vorhandenen Key. Siehe [Lizenzanforderung erstellen](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/requesting-a-licence-update.html).

### Ich habe die App im ctrlX Store gekauft. Warum brauche ich unter Windows einen LumiScan Key? {#faq-ctrlx-why-key}

Unter Windows 11 liegt die Lizenz in ctrlX WORKS, und der LumiScan Key schützt die Software vor Reverse Engineering. Er enthält keine zweite Lizenz, und Sie bezahlen nicht doppelt. Der Key wird nur aktualisiert, wenn Sie ein weiteres LumiScan-Produkt hinzufügen. Siehe [Gekauft im ctrlX Store, Betrieb unter Windows](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/path-ctrlx-windows.html).

### Brauche ich auf einer ctrlX CORE oder einem ctrlX IPC einen LumiScan Key? {#faq-ctrlx-os-no-key}

Nein. Apps, die nativ unter ctrlX OS laufen - auf einer ctrlX CORE oder einem IPC mit ctrlX OS -, verwenden eine ctrlX-Lizenz im License Manager von ctrlX OS. Weder der LumiScan Key noch die CodeMeter Runtime werden verwendet. Siehe [Gekauft im ctrlX Store, Betrieb auf ctrlX OS](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/path-ctrlx-os.html).

## Installieren und aktivieren

### Welche Version der CodeMeter Runtime benötige ich? {#faq-codemeter-version}

CodeMeter Runtime 9.00 oder neuer, für alle LumiScan-Produkte. Die installierte Version zeigt `cmu --version` (unter Windows `cmu32` in der CodeMeter-Eingabeaufforderung). Siehe [CodeMeter Runtime installieren](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/installing-codemeter.html).

### Wie kommt eine Lizenz auf meinen LumiScan Key? {#faq-request-licence}

1. Erstellen Sie in CodeMeter Control Center eine Lizenzanforderungsdatei (`.WibuCmRaC`) aus dem Key (**License Update** > **Create license request** > **Extend existing license** > **HD Vision Systems GmbH (6000380)**) oder mit `cmu --context 6000380 --serial <Seriennummer> --file <Seriennummer>.WibuCmRaC`.
2. Senden Sie sie mit Ihrer Bestell- oder Angebotsnummer und den gewünschten Produkten an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com).
3. Spielen Sie die Lizenz-Update-Datei (`.WibuCmRaU`) ein, die Sie erhalten.

Siehe [Lizenzanforderung erstellen](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/requesting-a-licence-update.html) und [Lizenz-Update einspielen](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/importing-a-licence-update.html).

### Enthält die Lizenzanforderungsdatei personenbezogene Daten? {#faq-request-personal-data}

Nein. Sie beschreibt nur den aktuellen Zustand Ihres LumiScan Key und verändert Ihre Lizenzen nicht.

### Kann ich den LumiScan Key in einer virtuellen Maschine oder einem Container verwenden? {#faq-vm-container}

Ja. Für eine virtuelle Maschine reichen Sie das USB-Gerät durch und installieren die CodeMeter Runtime in der VM. Für einen Container betreiben Sie die CodeMeter Runtime mit dem Key auf dem Host, aktivieren in CodeMeter WebAdmin den Netzwerkserver und lassen die Software im Container über TCP-Port 22350 darauf zugreifen. Siehe [Virtuelle Maschinen und Container](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/installing-codemeter.html#virtual-machines-and-containers).

## Verlängerung und Abonnement

### Muss ich meine Lizenzen jedes Jahr verlängern? {#faq-renewal-needed}

Nur Engineering-Apps, die Sie bei HD Vision Systems gekauft haben (zum Beispiel LumiScan Annotation Framework, LumiScan Training Framework, LumiScan VGR Engineering). Sie sind ein Jahresabonnement und werden jedes Jahr mit einem Lizenz-Update verlängert. Runtimes und Vision Apps sind ein Einmalkauf und werden nicht verlängert. Siehe [Engineering-Lizenzen verlängern](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/renewing-engineering-licences.html).

### Wann sollte ich die Verlängerung beginnen? {#faq-renewal-when}

Etwa vier Wochen vor dem Ablaufdatum. Eine Verlängerung setzt ein gültiges Abonnement voraus. Das Ablaufdatum sehen Sie in CodeMeter WebAdmin (**Container** > **Licenses**) oder mit `cmu --list-content --serial <Seriennummer>`.

### Was passiert, wenn das Abonnement abläuft? {#faq-subscription-expired}

Die Engineering-App kann nicht mehr genutzt werden. Ihre Projekte und Daten sind davon nicht betroffen. Sobald Ihr Abonnement wieder gültig ist und Sie die Verlängerung eingespielt haben, funktioniert die App wieder - ohne Neuinstallation.

## Fehlerbehebung {#troubleshooting}

Probleme und Fehlermeldungen sind Schritt für Schritt unter [Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/troubleshooting.html) beschrieben:

- [Der Key wird nicht erkannt](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/troubleshooting.html#key-not-detected)
- [HD Vision Systems GmbH fehlt im CmFAS-Assistenten](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/troubleshooting.html#faq-vendor-missing)
- [Fehler 705 beim Einspielen eines Lizenz-Updates](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/troubleshooting.html#error-705)
- [Die App erkennt die neue Lizenz nach dem Einspielen nicht](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/troubleshooting.html#faq-restart-after-update)
- [„User maximum reached!" beim Start einer LumiScan-Anwendung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/troubleshooting.html#user-maximum-reached)
- [Eine Engineering-App startet nicht mehr](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/troubleshooting.html#ts-engineering-app-not-starting)
- [Eine ctrlX-App beendet sich kurz nach dem Start](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/troubleshooting.html#faq-ctrlx-app-stops)

## Kontakt

Fragen zur Lizenzierung und Lizenzanforderungen: [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com). Geben Sie bitte Ihre Firma, die Bestell- oder Rechnungsnummer, die Seriennummer Ihres LumiScan Key und die genaue Fehlermeldung an.

# Fehlerbehebung – LumiScan Lizenzierung

URL: https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/troubleshooting.html

Beginnen Sie mit den [Allgemeine Prüfungen](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/troubleshooting.html#general-checks): Sie helfen bei jedem Lizenzierungsproblem. 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 HD Vision Systems senden, wenn das Problem weiterhin besteht.

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

Prüfen Sie zuerst diese Punkte:

- **Ihr Lizenzierungsweg.** Wo Sie die Software gekauft haben und wo sie läuft, entscheidet, wo die Lizenz liegt: auf dem LumiScan Key, in ctrlX WORKS oder im License Manager von ctrlX OS. Apps, die nativ unter ctrlX OS laufen, verwenden weder den LumiScan Key noch die CodeMeter Runtime. Siehe [Welcher Lizenzierungsweg gilt](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/which-licensing-path.html).
- **Die Version der CodeMeter Runtime.** `cmu --version` zeigt sie (unter Windows `cmu32` in der **CodeMeter-Eingabeaufforderung**). LumiScan-Software benötigt CodeMeter Runtime 9.00 oder neuer. Siehe [CodeMeter Runtime installieren](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/installing-codemeter.html).
- **Der Key ist verfügbar.** Im Reiter **License** von CodeMeter Control Center erscheint der LumiScan Key als **CmStick/C** mit einer Seriennummer der Form `3-1234567`. Auf einem PC ohne grafische Oberfläche führt `cmu --list` ihn auf. Siehe [Den Key erkennen](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/lumiscan-key.html#recognising-the-key).
- **Die Lizenzen auf dem Key und ihr Ablaufdatum.** In CodeMeter WebAdmin (**Container > Licenses**) oder mit `cmu --list-content --serial <Seriennummer>` (Eintrag **Expiration Time**).
- **Auf ctrlX OS: das Systemprotokoll.** Fehlt eine benötigte Lizenz, nennt das Systemprotokoll von ctrlX OS sie.

## Der LumiScan Key und CodeMeter {#key-and-codemeter}

### Problem: Der Key wird nicht erkannt {#key-not-detected}

**Symptome**

CodeMeter Control Center zeigt den LumiScan Key nicht an, oder `cmu --list` meldet `0 CmContainer(s) listed`.

**Mögliche Ursachen**

- Die CodeMeter Runtime ist auf dem PC nicht installiert.
- Der CodeMeter-Dienst läuft nicht. `cmu --list` meldet dann `CodeMeter not running`.
- Der Key wird an seinem USB-Anschluss nicht erkannt, zum Beispiel wenn er an einem Hub steckt.
- In einer virtuellen Maschine: Das USB-Gerät wird nicht an die virtuelle Maschine durchgereicht.
- In einem Container: Die Software erreicht die CodeMeter Runtime auf dem Host nicht.

**Diagnose**

1. Führen Sie `cmu --version` aus (unter Windows `cmu32` in der **CodeMeter-Eingabeaufforderung**) - erwartet: CodeMeter Runtime 9.00 oder neuer ist installiert.
2. Prüfen Sie den CodeMeter-Dienst - erwartet: Unter Windows zeigt die Statuszeile von CodeMeter Control Center **CodeMeter service is running**; unter Ubuntu zeigt `systemctl status codemeter`, dass der Dienst läuft.
3. Stecken Sie den Key in einen freien USB-Anschluss direkt am PC - erwartet: Die LED am Key blinkt kurz, und Windows erkennt das neue USB-Gerät.
4. Führen Sie `cmu --list` aus - erwartet: Der LumiScan Key wird mit seiner Seriennummer aufgeführt.
5. In einer virtuellen Maschine: Prüfen Sie, ob das USB-Gerät an die virtuelle Maschine durchgereicht wird und die CodeMeter Runtime darin installiert ist.
6. In einem Container: Prüfen Sie auf dem Host, ob in CodeMeter WebAdmin der Netzwerkserver aktiviert ist (**Configuration › Server › Server Access**) - erwartet: Die Software erreicht den Key über TCP-Port 22350.

**Lösung**

- **Wenn die CodeMeter Runtime nicht installiert ist:** Installieren Sie CodeMeter Runtime 9.00 oder neuer, wie unter [CodeMeter Runtime installieren](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/installing-codemeter.html) beschrieben.
- **Wenn der CodeMeter-Dienst nicht läuft:** Starten Sie den Dienst.
- **Wenn der Key an seinem USB-Anschluss nicht erkannt wird:** Stecken Sie ihn in einen anderen USB-Anschluss, möglichst direkt am PC statt an einem Hub.
- **Wenn das USB-Gerät nicht an die virtuelle Maschine durchgereicht wird:** Reichen Sie es durch und installieren Sie die CodeMeter Runtime in der virtuellen Maschine.
- **Wenn die Software in einem Container den Key nicht erreicht:** Betreiben Sie die CodeMeter Runtime mit dem Key auf dem Host und aktivieren Sie in CodeMeter WebAdmin auf dem Host den Netzwerkserver. Siehe [Virtuelle Maschinen und Container](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/installing-codemeter.html#virtual-machines-and-containers).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/troubleshooting.html#support-information) genannten Informationen an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com), zusammen mit der Ausgabe von `cmu --version` und `cmu --list` und der Angabe, ob der PC eine virtuelle Maschine ist oder die Software in einem Container läuft.

## Lizenz-Updates {#licence-updates}

### Problem: HD Vision Systems GmbH fehlt im CmFAS-Assistenten {#faq-vendor-missing}

**Symptome**

Wenn Sie eine Lizenzanforderung erstellen, zeigt die Herstellerliste des CmFAS-Assistenten **HD Vision Systems GmbH (6000380)** nicht an.

**Mögliche Ursachen**

- Der LumiScan Key war im Reiter **License** nicht ausgewählt, als Sie auf **License Update** geklickt haben.

**Diagnose**

1. Prüfen Sie den Reiter **License** von CodeMeter Control Center - erwartet: Ihr LumiScan Key (**CmStick/C**) ist links ausgewählt, bevor Sie auf **License Update** klicken.

**Lösung**

- **Wenn der Key nicht ausgewählt war:**

  a. Schließen Sie den Assistenten.

  b. Wählen Sie im Reiter **License** links Ihren LumiScan Key aus und klicken Sie auf **License Update**.

  c. Erstellen Sie die Anforderung erneut, wie unter [Lizenzanforderung erstellen](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/requesting-a-licence-update.html) beschrieben.

Auf einem PC ohne grafische Oberfläche erstellen Sie die Anforderung stattdessen mit `cmu`, siehe [Anforderung über die Kommandozeile erstellen](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/requesting-a-licence-update.html#command-line).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/troubleshooting.html#support-information) genannten Informationen an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com), zusammen mit der Ausgabe von `cmu --list`.

### Problem: Fehler 705 beim Einspielen eines Lizenz-Updates {#error-705}

**Symptome**

CodeMeter meldet Fehler 705, wenn Sie eine Lizenz-Update-Datei (`.WibuCmRaU`) einspielen.

![CodeMeter-Fehlermeldung: Update for CmContainer FirmItem 6000380](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/_images/error-705.jpg)

*Abbildung 1. Fehler 705 beim Einspielen eines Lizenz-Updates*

**Mögliche Ursachen**

- Das Update wurde bereits eingespielt. Jede Lizenz-Update-Datei kann nur einmal verwendet werden.
- Seit dem Erstellen der Lizenzanforderung wurde ein anderes Lizenz-Update auf den LumiScan Key eingespielt: Die Lizenz-Update-Datei passt nicht mehr zum aktuellen Zustand des Keys.
- Das Update ist für einen anderen LumiScan Key bestimmt.

**Diagnose**

1. Prüfen Sie in CodeMeter WebAdmin (**Container > Licenses**) oder mit `cmu --list-content --serial <Seriennummer>`, ob die neuen Lizenzen bereits auf dem Key sind - erwartet: Sind sie aufgeführt, wurde das Update bereits eingespielt.
2. Vergleichen Sie die Seriennummer im Dateinamen mit der Seriennummer Ihres LumiScan Key - erwartet: dieselbe Seriennummer. Die Seriennummer ist auf dem Key aufgedruckt und wird in CodeMeter Control Center angezeigt.
3. Prüfen Sie, ob seit dem Erstellen der Anforderung ein anderes Lizenz-Update auf diesen Key eingespielt wurde.

**Lösung**

- **Wenn das Update bereits eingespielt wurde:** Es ist nichts weiter zu tun. Die neuen Lizenzen sind verfügbar.
- **Wenn zwischenzeitlich ein anderes Update eingespielt wurde oder das Update für einen anderen Key bestimmt ist:** Sind die neuen Lizenzen nicht verfügbar, [erstellen Sie eine neue Lizenzanforderung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/requesting-a-licence-update.html) aus Ihrem LumiScan Key und senden Sie sie an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com). Spielen Sie bis zum Import des neuen Updates keine anderen Lizenz-Updates auf diesen Key ein.

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/troubleshooting.html#support-information) genannten Informationen an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com), zusammen mit dem Namen der Lizenz-Update-Datei.

### Problem: Die App erkennt die neue Lizenz nach dem Einspielen nicht {#faq-restart-after-update}

**Symptome**

Sie haben das Lizenz-Update ohne Fehler eingespielt, aber eine LumiScan-Anwendung verwendet die neue Lizenz nicht.

**Mögliche Ursachen**

- Die Anwendung lief bereits während des Einspielens. Bereits laufende Anwendungen müssen gegebenenfalls neu gestartet werden, damit sie die neuen Lizenzen verwenden.
- Das Update wurde nicht auf den Key geschrieben, siehe [Problem: Fehler 705 beim Einspielen eines Lizenz-Updates](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/troubleshooting.html#error-705).

**Diagnose**

1. Prüfen Sie in CodeMeter WebAdmin (**Container > Licenses**) oder mit `cmu --list-content --serial <Seriennummer>`, ob die neue Lizenz auf dem Key ist - erwartet: Sie ist aufgeführt.
2. Prüfen Sie, ob die Anwendung vor dem Einspielen gestartet wurde.

**Lösung**

- **Wenn die Anwendung bereits lief:** Starten Sie sie neu.
- **Wenn die Lizenz nicht auf dem Key ist:** Spielen Sie das Update erneut ein, wie unter [Lizenz-Update einspielen](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/importing-a-licence-update.html) beschrieben. Schlägt der Import mit Fehler 705 fehl, siehe [Problem: Fehler 705 beim Einspielen eines Lizenz-Updates](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/troubleshooting.html#error-705).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/troubleshooting.html#support-information) genannten Informationen an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com), zusammen mit der Ausgabe von `cmu --list-content --serial <Seriennummer>`.

## Eine Anwendung starten {#starting-an-application}

### Problem: „User maximum reached!" beim Start einer LumiScan-Anwendung {#user-maximum-reached}

**Symptome**

Eine LumiScan-Anwendung meldet beim Start `User maximum reached!`.

**Mögliche Ursachen**

- Alle Lizenzen des LumiScan Key für diese Anwendung sind bereits durch andere Instanzen der Anwendung belegt, die diesen Key verwenden.
- Die Software soll mit einem LumiScan Key gleichzeitig auf mehreren Geräten laufen. Für jedes Gerät, auf dem die Software gleichzeitig läuft, wird ein eigener Key benötigt.

**Diagnose**

1. Prüfen Sie, ob andere Instanzen der Anwendung diesen LumiScan Key verwenden - erwartet: keine, oder weniger, als die Lizenzen auf dem Key erlauben.

**Lösung**

- **Wenn andere Instanzen die Lizenzen belegen:** Schließen Sie sie und klicken Sie auf **Retry**.
- **Wenn die Software gleichzeitig auf mehreren Geräten laufen soll:** Verwenden Sie einen LumiScan Key pro Gerät. Siehe [Ein Key pro Gerät](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/lumiscan-key.html#one-key-per-device).
- **Wenn Sie dauerhaft mehr gleichzeitige Lizenzen benötigen:** Erstellen Sie eine Lizenzanforderung und geben Sie in der E-Mail die gewünschte Anzahl an. Siehe [Lizenzanforderung erstellen](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/requesting-a-licence-update.html).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/troubleshooting.html#support-information) genannten Informationen an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com), zusammen mit der Anzahl der Instanzen, die gleichzeitig laufen sollen.

### Problem: Eine Engineering-App startet nicht mehr {#ts-engineering-app-not-starting}

**Symptome**

Eine bei HD Vision Systems gekaufte Engineering-App, zum Beispiel LumiScan Annotation Framework, LumiScan Training Framework oder LumiScan VGR Engineering, kann nicht mehr genutzt werden.

**Mögliche Ursachen**

- Das Jahresabonnement ist abgelaufen.

**Diagnose**

1. Prüfen Sie das Ablaufdatum der Lizenz - erwartet: Es liegt in der Zukunft.

   a. Klicken Sie in CodeMeter Control Center auf **WebAdmin**, öffnen Sie **Container > Licenses** und wählen Sie Ihren LumiScan Key aus; oder

   b. führen Sie `cmu --list-content --serial <Seriennummer>` aus und lesen Sie den Eintrag **Expiration Time**.

**Lösung**

- **Wenn das Abonnement abgelaufen ist:** Verlängern Sie die Lizenz, wie unter [Engineering-Lizenzen verlängern](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/renewing-engineering-licences.html) beschrieben:

  a. Die Verlängerung setzt ein gültiges Abonnement voraus. Wurde Ihr Abonnement gekündigt oder ist es ausgelaufen, wenden Sie sich zuerst an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com), um das Abonnement zu erneuern.

  b. [Erstellen Sie eine Lizenzanforderung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/requesting-a-licence-update.html) und senden Sie sie an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com). Schreiben Sie in der E-Mail, dass Sie Ihre Engineering-Lizenzen verlängern möchten, und geben Sie Ihre Kunden- oder Bestellnummer an.

  c. [Spielen Sie das Lizenz-Update ein](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/importing-a-licence-update.html), das Sie erhalten.

     Sie müssen die Software nicht neu installieren. Ihre Projekte und Daten sind nicht betroffen.

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/troubleshooting.html#support-information) genannten Informationen an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com), zusammen mit dem Ablaufdatum, das für die Lizenz angezeigt wird.

### Problem: Eine ctrlX-App beendet sich kurz nach dem Start {#faq-ctrlx-app-stops}

**Symptome**

Eine LumiScan-App auf ctrlX OS beendet sich kurz nach dem Start oder während sie läuft.

**Mögliche Ursachen**

- Auf dem ctrlX-OS-Gerät, auf dem die App läuft, fehlt eine benötigte ctrlX-Lizenz.
- Die App benötigt mehr Lizenzen als installiert sind, zum Beispiel benötigt LumiScan CamDriver eine pro Kamera.
- Die Lizenz hat die falsche Version: Version 2 von LumiScan AI Object Matching, LumiScan Calibration und LumiScan CamDriver benötigt die Lizenz mit `-V2NN`. Lizenzen mit der Endung `-NNNN` funktionieren mit Version 2 nicht.
- Eine Lizenz ist nicht mehr verfügbar, während die App läuft. Die App erneuert ihre Lizenzen alle 30 Minuten.

**Diagnose**

1. Lesen Sie das Systemprotokoll von ctrlX OS - erwartet: Es nennt die fehlende Lizenz.
2. Vergleichen Sie die Lizenz mit den Teilenummern und den Zählregeln in der [Lizenzübersicht](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/licence-reference.html) - erwartet: die richtige Teilenummer und so viele Lizenzen, wie die App benötigt.
3. Prüfen Sie den License Manager von ctrlX OS auf dem Gerät, auf dem die App läuft - erwartet: Die Lizenz ist dort verfügbar.

**Lösung**

- **Wenn die Lizenz fehlt oder die falsche Version hat:** Kaufen Sie die Lizenz im ctrlX Store und aktivieren Sie sie im License Manager von ctrlX OS auf diesem Gerät. Folgen Sie dazu der Dokumentation von Bosch Rexroth zu ctrlX OS.
- **Wenn die App mehr Lizenzen benötigt:** Ergänzen Sie Lizenzen, bis sie den [Zählregeln](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/licence-reference.html#counting-rules) entsprechen.
- **Wenn eine Lizenz nicht mehr verfügbar ist:** Stellen Sie sie im License Manager von ctrlX OS wieder bereit und starten Sie die App dann erneut.

Siehe [Gekauft im ctrlX Store, Betrieb auf ctrlX OS](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-licensing-de/1.0.4/troubleshooting.html#support-information) genannten Informationen an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com), zusammen mit den Zeilen des Systemprotokolls von ctrlX OS, die die Lizenz nennen.

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

Besteht das Problem weiter, wenden Sie sich an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com). Geben Sie bitte an:

- Ihre Firma und die Bestell- oder Rechnungsnummer;
- die Seriennummer Ihres LumiScan Key, wenn Ihr Lizenzierungsweg einen verwendet;
- das Produkt und seine Version;
- die genaue Fehlermeldung sowie Datum und Uhrzeit, zu der sie erschien;
- das Betriebssystem: Windows 11, Ubuntu 24.04 oder ctrlX OS mit seiner Version, und ob die Software in einer virtuellen Maschine oder einem Container läuft;
- den Lizenzierungsweg: gekauft bei HD Vision Systems oder im ctrlX Store;
- die Version der CodeMeter Runtime (`cmu --version`) und die Ausgabe von `cmu --list` und `cmu --list-content --serial <Seriennummer>`;
- auf ctrlX OS die Zeilen des Systemprotokolls von ctrlX OS, die die Lizenz nennen;
- bei einem Problem mit einem Lizenz-Update den Namen der Lizenzanforderungsdatei (`.WibuCmRaC`) oder der Lizenz-Update-Datei (`.WibuCmRaU`).
