Erfahren Sie in diesem Artikel,
- welche Fehlercodes in 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 werden regelmäßig verschiedene technische und organisatorische Voraussetzungen geprüft. Treten Probleme auf, gibt der Server einen spezifischen Fehlercode zurück. Jeder Fehlercode ist eindeutig und weist auf eine klar definierte Ursache hin.
Die Fehlercodes lassen sich in sieben Hauptkategorien unterteilen:
- Serverkonfiguration – umfasst alle Probleme mit der grundlegenden Infrastruktur des Lizenzservers, wie 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 – beispielsweise fehlende Ablaufdaten, falsche Versionen oder deaktivierte Einträge.
- Lizenzvalidierung – enthält Fehler, die auftreten, wenn eine Lizenz abgelaufen, ungültig oder unvollständig ist. Auch Probleme bei der Signaturprüfung werden hier angeführt.
- 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, beispielsweise durch fehlerhafte Dateiformate oder fehlende Zugriffsrechte.
- Sicherheit & Verifikation – umfasst Probleme mit der Überprüfung von Hardware-IDs, digitalen Signaturen und anderen sicherheitsrelevanten Daten in der Lizenzdatei.
- Allgemeine Vorgänge – beschreibt grundlegende Fehler, die nicht direkt einer der anderen Kategorien zugeordnet werden können, wie fehlerhafte Anfragen oder generelle Erstellungsausfälle.
2. Fehlercodes im Überblick
Für jede Kategorie stehen mehrere Fehlercodes mit unterschiedlichen Ursachen zur Verfügung. Nachfolgenden finden Sie eine detaillierte Beschreibung aller Fehlercodes und deren Ursache sowie die notwendigen Schritte, die eingeleitet werden sollten.
2.1. Serverkonfiguration
In der Kategorie Serverkonfiguration stehen derzeit sieben Fehlercodes zur Verfügung:
Fehlercodes | Fehlermeldung | Ursache | Auswirkung |
---|---|---|---|
PRIVATE_KEY_NOT_SET |
»Private key is not configured on the server« | Privater Schlüssel ist nicht auf dem Server konfiguriert. | Keine Lizenzgenerierung möglich |
ERROR_READING_PRIVATE_KEY |
»Unable to read private key« | Privater Schlüssel kann nicht gelesen werden. | Lizenzgenerieung schlägt fehl |
PUBLIC_KEY_NOT_SET |
»Public key is not configured on the server« | Öffentlicher Schlüssel ist nicht konfiguriert. | 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« |
Angeforderter Verschlüsselungsalgorithmus wird nicht unterstützt. | Lizenzgenerieung mit diesem Verfahren nicht möglich |
LICENSE_TO_XML_FAILED |
»License generation failed: Unable to create license file format – XML« | Lizenzdaten können nicht ins XML-Format 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:
Fehlercodes | Fehlermeldung | Ursache | Auswirkung |
---|---|---|---|
WORKSTATION_DELETED |
»License not available: Workstation [Workstation Name] has been deleted« |
Workstation wurde gelöscht | Keine Lizenz möglich |
WORKSTATION_INACTIVE |
»License not available: Workstation [Workstation Name] is marked as inactive« |
Workstation ist inativ | 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] « |
Produktiversion wird nicht unterstützt | Lizenzvergabe nicht möglich |
WORKSTATION_DOES_NIT_EXIST |
»Workstation not found: Workstation [Workstation Name] does not exist or has been disabled« |
Workstation-ID existiert 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 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 nicht unterstützt | Lizenzanforderung abgelehnt |
LICENSE_STATE_INVALID |
»License not available: Workstation [Workstation Name] has status [Current Status] « |
Status der Workstation verhindert Lizenzgenierung | Lizenz blockiert |
2.3. Lizenzvalidierung
In der Kategorie Lizenzvalidierung stehen derzeit acht Fehlercodes zur Verfügung:
Fehlercodes | 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 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 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 ungültig |
VERIFY_SIGNATURE_FAILED |
»License verification failed: The license signature could not be verified« | Signaturprüfung fehlgeschlagen | Lieznz 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 Rechnerregisitrierung stehen derzeit acht Fehlercodes zur Verfügung:
Fehlercodes | Fehlermeldung | Ursache | Auswirkung |
---|---|---|---|
HARDWARE_HASH_NOT_REGISTERED |
«Workstation Machine not registered. Hardware hashes: V1=[Hardware 1] , V2=[Hardware 2] « |
Hardware nicht regisitriert | Lizenzvergabe nicht möglich |
WORKSTATION_MACHINE_BLOCKED |
»License not available: This machine marked as BLOCKED« | Workstation 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 erreich | 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 | Regisitrierung 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 schlägt fehl |
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:
Fehlercodes | 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 hash« | 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 schlägt fehl |
2.7. Allgemeine Vorgänge
In der Kategorie Allgemeine Vorgänge stehen derzeit drei Fehlercodes zur Verfügung:
Fehlercodes | 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 erstellt werden | Keine Lizenz verfügbar |
VALIDATE_LICENCE_FAILED_EMPTY_WORKSTATION_GUID |
»Registration required: The workstation is not yet registered« | Arbeitsplatz nicht registriert | Lizenzoperation blockiert |
Artikel Update: Workflow 1.21.0 – 08/2025