Benutzerhandbuch

2.3 Problembehandlung von Lizenzen

Aktualisiert am

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

Vorheriger Artikel 2.2 Lizenzierung
Nächster Artikel 3.1 Kontakt
Noch Fragen? Kontaktieren Sie uns!