Erfahren Sie in diesem Artikel,
- welche Fehlercodes im Zusammenhang mit Lizenzen auftreten können und
- wie diese Fehlercodes zu behandeln sind.
1. Einführung
Der Lizenzserver ist für die Verwaltung und Verteilung von Softwarelizenzen zuständig. Dabei überprüft er regelmäßig verschiedene technische und organisatorische Voraussetzungen. Treten Probleme auf, gibt der Server einen spezifischen Fehlercode zurück. Jeder Fehlercode ist eindeutig und verweist auf eine klar definierte Ursache.
Die Fehlercodes lassen sich in sieben Hauptkategorien unterteilen:
- Serverkonfiguration – umfasst alle Probleme mit der grundlegenden Infrastruktur des Lizenzservers, z.B. fehlende Schlüsseldateien oder nicht unterstützte Verschlüsselungsverfahren. Diese Fehler erfordern in der Regel Eingriffe durch den Systemadministrator.
- Workstation-Verwaltung – betrifft fehlerhafte oder unvollständige Konfigurationen einzelner Arbeitsplätze im System, z.B. fehlende Ablaufdaten, falsche Versionen oder deaktivierte Einträge.
- Lizenzvalidierung – enthält Fehler, die auftreten, wenn eine Lizenz abgelaufen, ungültig oder unvollständig ist. Dazu zählen auch Probleme bei der Signaturprüfung.
- Rechnerregistrierung – bezieht sich auf die Erkennung und Zuordnung von Hardware zu einer Lizenz. Hier entstehen Fehler, wenn Geräte nicht registriert, gesperrt oder bereits zu viele Geräte aktiviert sind.
- Dateioperationen – beinhaltet Fehler, die beim Hochladen, Speichern oder Einlesen von Lizenzdateien auftreten können, z.B. durch fehlerhafte Dateiformate oder fehlende Zugriffsrechte.
- Sicherheit & Verifikation – umfasst Probleme bei der Überprüfung von Hardware-IDs, digitalen Signaturen und anderen sicherheitsrelevanten Daten in der Lizenzdatei.
- Allgemeine Vorgänge – beschreibt grundlegende Fehler, die keiner der oben genannten Kategorien zugeordnet werden können, z.B. fehlerhafte Anfragen oder allgemeine Erstellungsausfälle.
2. Fehlercodes im Überblick
Für jede Kategorie existieren mehrere Fehlercodes mit unterschiedlichen Ursachen. Nachfolgend finden Sie eine detaillierte Beschreibung aller Fehlercodes, ihrer Ursachen sowie der jeweiligen Auswirkungen.
2.1. Serverkonfiguration
In der Kategorie Serverkonfiguration stehen derzeit sieben Fehlercodes zur Verfügung:
| Fehlercode | Fehlermeldung | Ursache | Auswirkung |
|---|---|---|---|
PRIVATE_KEY_NOT_SET |
Private key is not configured on the server | Privater Schlüssel ist nicht auf dem Server verfügbar. | Keine Lizenzgenerierung möglich. |
ERROR_READING_PRIVATE_KEY |
Unable to read private key | Privater Schlüssel kann nicht gelesen werden. | Lizenzgenerierung schlägt fehl. |
PUBLIC_KEY_NOT_SET |
Public key is not configured on the server | Öffentlicher Schlüssel ist nicht auf dem Server verfügbar. | Lizenzprüfung kann fehlschlagen. |
ERROR_READING_PUBLIC_KEY |
Unable to read public key | Öffentlicher Schlüssel kann nicht gelesen werden. | Lizenzprüfung schlägt fehl. |
CRYPTO_ALGORITHM_NOT_FOUND |
Cryptographic algorithm [Algorithm Name] is not supported by the server |
Verschlüsselungsalgorithmus wird nicht unterstützt. | Lizenzgenerierung ist mit diesem Verfahren nicht möglich. |
LICENSE_TO_XML_FAILED |
License generation failed: Unable to create license file format – XML | Lizenzdaten können nicht in XML umgewandelt werden. | Lizenzdatei kann nicht erstellt werden. |
CREATE_SIGNATURE_FAILED |
License generation failed: Unable to digitally sign the license | Digitale Signatur kann nicht erstellt werden. | Lizenz wird nicht korrekt signiert. |
2.2. Workstation-Verwaltung
In der Kategorie Workstation-Verwaltung stehen derzeit acht Fehlercodes zur Verfügung:
| Fehlercode | Fehlermeldung | Ursache | Auswirkung |
|---|---|---|---|
WORKSTATION_DELETED |
License not available: Workstation [Workstation Name] has been deleted |
Workstation wurde im Lizenzmanager gelöscht. | Keine Lizenz verfügbar. |
WORKSTATION_INACTIVE |
License not available: Workstation [Workstation Name] is marked as inactive |
Workstation ist inaktiv. | Lizenz gesperrt. |
WORKSTATION_MISSING_MAINTENANCE_EXPIRY_DATE |
License not created: Workstation [Workstation Name] is missing required maintenance expiry date |
Wartungsablaufdatum fehlt. | Lizenz nicht erstellbar. |
PRODUCT_VERSION_NOT_SUPPORTED |
Version not supported: Product [Product Name] does not support version [Version]
|
Produktversion ist nicht bekannt. | Lizenzvergabe nicht möglich. |
WORKSTATION_DOES_NIT_EXIST |
Workstation not found: Workstation [Workstation Name] does not exist or has been disabled |
Workstation-ID existiert im Lizenzmanager nicht. | Lizenzanforderung schlägt fehl. |
WORKSTATION_NO_REQUIRED_EXPIRED_DATE_SET |
License not created: Workstation [Workstation Name] of type [Subscription Type] requires an expiry date but none is configured |
Wartungsablaufdatum ist erforderlich, aber nicht gesetzt. | Lizenzgenerierung blockiert. |
WORKSTATION_UNHANDLED_LICENSE_TYPE |
License not created: Workstation [Workstation Name] has an unsupported license type [Subscription Type]
|
Lizenztyp wird für die Workstation nicht unterstützt. | Lizenzanforderung abgelehnt. |
LICENSE_STATE_INVALID |
License not available: Workstation [Workstation Name] has status [Current Status]
|
Status der Workstation verhindert Lizenzgenerierung. | Lizenz blockiert. |
2.3. Lizenzvalidierung
In der Kategorie Lizenzvalidierung stehen derzeit acht Fehlercodes zur Verfügung:
| Fehlercode | Fehlermeldung | Ursache | Auswirkung |
|---|---|---|---|
MAINTENANCE_EXPIRED_FOR_PRODUCT_VERION |
Maintenance expired: Your maintenance expired on [Expiry Date], but product version [Version] was released on [Release Date]. Extend maintenance or downgrade to a compatible version |
Wartung abgelaufen, Version zu neu. | Zugriff verweigert. |
LICENSE_EXPIRED |
License expired: The license for workstation [Workstation Name] expired on [Expiry Date]
|
Lizenz ist abgelaufen. | Zugriff gesperrt. |
LICENSE_NOT_VALID |
License not valid: The license for workstation [Workstation Name] is only valid until [Expiry Date]
|
Lizenz läuft bald ab. | Warnung angezeigt. |
LICENSE_EXPIRED_REQUIRED |
License not created: Expiry date is required for workstation [Workstation Name] of type [Subscription Type] but is not configured |
Ablaufdatum ist erforderlich, aber nicht gesetzt. | Lizenz nicht erstellbar. |
GENERATION_DATE_MISSING |
Invalid license: The license for workstation [Workstation Name] is corrupted (missing generation date) |
Erstellungsdatum fehlt. | Lizenz ist ungültig. |
GENERATION_DATE_IN_FUTURE |
Invalid license: The license for workstation [Workstation Name] was generated in the future [Future Date] compared to current date [Current date]. Check system clock or obtain new license |
Erstellungsdatum liegt in der Zukunft. | Lizenz ist ungültig. |
VERIFY_SIGNATURE_FAILED |
License verification failed: The license signature could not be verified | Signaturprüfung fehlgeschlagen. | Lieznz wurde abgelehnt. |
VERIFY_SIGNATURE_FAILED_MISSING_SINGATURE |
Invalid license file: The license file is missing a required digital signature | Signatur fehlt. | Lizenz nicht validierbar. |
2.4. Rechnerregistrierung
In der Kategorie Rechnerregistrierung stehen derzeit acht Fehlercodes zur Verfügung:
| Fehlercode | Fehlermeldung | Ursache | Auswirkung |
|---|---|---|---|
HARDWARE_HASH_NOT_REGISTERED |
Workstation Machine not registered. Hardware hashes: V1=[Hardware 1], V2=[Hardware 2]
|
Hardware nicht registriert. | Lizenzvergabe nicht möglich. |
WORKSTATION_MACHINE_BLOCKED |
License not available: This machine marked as BLOCKED | Workstation ist gesperrt. | Zugriff verweigert. |
WORKSTATION_MACHINE_DISABLED |
License not available: This machine marked as DISABLED | Workstation deaktiviert. | Zugriff (temporär) verweigert. |
WORKFSTATION_ACTIVATION_FAILED |
Activation failed: No machine is registered for this workstation | Keine Workstation registriert. | Aktivierung nicht möglich. |
WORKSTATION_ACTIVITATION_FAILED_MACHINE_INVALID_STATUS |
Activation failed: Machine [Workstation Status] is not in a valid state for activation |
Workstationstatus für Aktivierung ungültig. | Aktivierung blockieren. |
ACTIVATE_WORKSTATION_MACHINE_LMS_FAILED |
Activation limit exceeded: Cannot activate machine [Workstation Name] as there are already [Other Workstation Name] other machines activated for this workstation |
Aktivierungslimit erreicht. | Aktivierung abgelehnt. |
ACTIVATE_WORKSTATION_MACHINE_FAILED |
Activation failed: Machine [Workstation Name] must be in INSTALLING status to be activated |
Rechner muss in Status »Installieren« sein. | Aktivierung blockiert. |
REGISTER_WORKSTATION_MASCHINE_FAILED |
Registration failed: Cannot register new machine for workstation [Workstation Name] because another machine [Other Workstation Name] is in status INSTALLING |
Registierung blockiert, da Installation läuft. | Registrierung nicht möglich. |
2.5. Dateioperationen
In der Kategorie Dateioperation stehen derzeit sechs Fehlercodes zur Verfügung:
| Fehlercodes | Fehlermeldung | Ursache | Auswirkung |
|---|---|---|---|
LICENSE_FROM_XML_FAILED |
Invalid license file: Unable to read the license file format | XML-Format fehlerhaft. | Lizenzdatei nicht lesbar. |
UPLOAD_LICENCE_TMP_FAILED_READ_INPUT_STREAM |
Upload failed: Unable to read the uploaded license file | Lizenzdatei kann nicht gelesen werden. | Upload schlägt fehl. |
UPLOAD_LICENCE_TMP_FAILED_EMPTY_INPUT_STREAM |
Upload failed: The license file appears to be empty | Lizenzdatei ist leer. | Upload abgelehnt. |
UPLOAD_LICENCE_TMP_FAILED_SIGNATURE_VERIFICATION |
Upload rejected: The license file signature is invalid | Signatur ungültig. | Upload nicht angenommen. |
UPLOAD_LICENCE_FAILED |
Upload failed: Unable to save the license file to [Storage location]
|
Lizenzdatei kann nicht gespeichert werden. | Verarbeitung fehlgeschlagen. |
LICENSE_ERROR_READ_FILE |
License file error: Unable to read the license file | Lizenzdatei kann nicht gelesen werden. | Verarbeitung fehlgeschlagen. |
2.6. Sicherheit und Verifikation
In der Kategorie Sicherheit und Verifikation stehen derzeit fünf Fehlercodes zur Verfügung:
| Fehlercode | Fehlermeldung | Ursache | Auswirkung |
|---|---|---|---|
LICENSE_ERROR_WORKSTATION_UUID_MISSING |
Invalid license file: The workstation UUID is corrupted or missing | Workstationerkennung fehlt/beschädigt. | Lizenz nicht validierbar. |
LICENSE_ERROR_HARDWARE_HASH_MISSING |
License validation failed: Hardware hash is missing from the license file | Hardware-Hash fehlt. | Lizenz nicht validierbar. |
LICENSE_ERROR_WORKSTATION_MACHINE_HARDWARE_HASH_MISSING |
Hardware hash validation failed: This machine cannot generate a hardware hash | Rechner kann keinen Hardware-Hash erzeugen. | Lizenzvalidierung nicht möglich. |
LICENSE_ERROR_WORKSTATION_MACHINE_HARDWARE_HASH_INVALID |
Error reading license file: Workstation hardware hash does not match the license hardware has | Hardware-Hash stimmt nicht überein. | Lizenz abgelehnt. |
LICENSE_ERROR_WORKSTATION_MACHINE_HARDWARE_HASH_V2_INVALID |
Error reading license file: Hardware hash V2 invalid | Neuer Hash-Standard ungültig. | Lizenzvalidierung fehlgeschlagen. |
2.7. Allgemeine Vorgänge
In der Kategorie Allgemeine Vorgänge stehen derzeit drei Fehlercodes zur Verfügung:
| Fehlercode | Fehlermeldung | Ursache | Auswirkung |
|---|---|---|---|
INVALID_PARAMS |
Invalid request: Required information is missing or incorrect | Anfrage unvollständig oder fehlerhaft. | Verarbeitung nicht möglich. |
LICENSE_NOT_CREATED |
License generation failed: Unable to create your license file | Lizenz konnte nicht im Lizenzmanager erstellt werden. | Keine Lizenz verfügbar. |
VALIDATE_LICENCE_FAILED_EMPTY_WORKSTATION_GUID |
Registration required: The workstation is not yet registered | Workstation nicht registriert. | Lizenzoperation blockiert. |
Artikel Update: Workflow 1.21.0 – 08/2025