In this article, you will learn
- which error codes may occur in connection with licenses,
- how to these error codes should be handled.
1. Introduction
The License Server is responsible for managing and distributing software licenses. The server regularly checks various technical and organizational requirements. If issues occur, the server returns a specific error code. Each error code is unique and refers to a clearly defined cause.
The error codes are divided into seven main categories:
- Server Configuration – includes all issues related to the core infrastructure of the License Server, e.g., missing key files or unsupported encryption methods. These errors typically require intervention by a system administrator.
- Workstation Management – covers incorrect or incomplete configurations of individual workstations within the system, e.g., missing expiration dates, incorrect versions, or disabled entries.
- License Validation – includes errors that occur when a license is expired, invalid, or incomplete. This also covers issues related to signature verification.
- Computer Registration – relates to the detection and assignment of hardware to a license. Errors occur when devices are nor registered, are blocked, or when too many devices have already been activated.
- File Operations – includes errors that may occur when uploading, saving, or importing License Files, e.g., due to incorrect file formats or missing access permissions.
- Security & Verification – covers issues related to the verification of hardware IDs, digital signatures, and other security-relevant data in the License File.
- General Operations – describes fundamental errors that cannot be assigned to any of the above categories, e.g., invalid requests or general creation failures.
Contact your Support Team
If you encounter any issues or errors with your license, please contact your designated support representative. To facilitate faster resolution, please provide a screenshot of the relevant error message or error code.
2. Error Codes – An Overview
For each category, multiple error codes exist with different underlying causes. Below you will find a detailed description of all error codes, their causes, and their respective impacts.
2.1. Server Configuration
The category Server Configuration currently includes seven error codes:
| Error Code | Error Message | Reason | Impact |
|---|---|---|---|
PRIVATE_KEY_NOT_SET | Private key is not configured on the server. | Private key is not available on the server. | No license generation possible. |
ERROR_READING_PRIVATE_KEY | Unable to read private key. | Private key cannot be read. | License generation fails. |
PUBLIC_KEY_NOT_SET | Public key is not configured on the server. | Public key is not available on the server. | License validation can fail. |
ERROR_READING_PUBLIC_KEY | Unable to read public key. | Public key cannot be read. | License validation fails. |
CRYPTO_ALGORITHM_NOT_FOUND | Cryptographic algorithm [Algorithm Name] is not supported by the server. | Algorithm for encryption is not supported. | License generation is not possible with this method. |
LICENSE_TO_XML_FAILED | License generation failed: Unable to create license file format – XML. | License data cannot be converted to XML. | License file cannot be created. |
CREATE_SIGNATURE_FAILED | License generation failed: Unable to digitally sign the license. | Digital signature cannot be created. | License is not correctly signed. |
2.2. Workstation Management
The category Workstation Management currently includes eight error codes:
| Error Code | Error Message | Reason | Impact |
|---|---|---|---|
WORKSTATION_DELETED | License not available: Workstation [Workstation Name] has been deleted. | Workstation has been deleted in the License Manager. | No license is available. |
WORKSTATION_INACTIVE | License not available: Workstation [Workstation Name] is marked as inactive. | Workstation is inactive. | License is blocked. |
WORKSTATION_MISSING_MAINTENANCE_EXPIRY_DATE | License not created: Workstation [Workstation Name] is missing required maintenance expiry date. | Maintenance expiration date is missing. | License cannot be created. |
PRODUCT_VERSION_NOT_SUPPORTED | Version not supported: Product [Product Name] does not support version [Version]. | Product version is unknown. | License assignment is not possible. |
WORKSTATION_DOES_NOT_EXIST | Workstation not found: Workstation [Workstation Name] does not exist or has been disabled. | Workstation ID does not exist in the License Manager. | License request fails. |
WORKSTATION_NO_REQUIRED_EXPIRED_DATE_SET | License not created: Workstation [Workstation Name] of type [Subscription Type] requires an expiry date but none is configured. | Maintenance expiration date is required but not set. | License generation is blocked. |
WORKSTATION_UNHANDLED_LICENSE_TYPE | License not created: Workstation [Workstation Name] has an unsupported license type [Subscription Type]. | License type is not supported for the Workstation. | License request is denied. |
LICENSE_STATE_INVALID | License not available: Workstation [Workstation Name] has status [Current Status]. | Status of the Workstation prevents the license generation. | License is blocked. |
2.3. License Validation
The category License Validation currently includes eight Error Codes:
| Error Code | Error Message | Reason | Impact |
|---|---|---|---|
MAINTENANCE_EXPIRED_FOR_PRODUCT_VERSION | 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. | Maintenance expired, version is too new. | Access denied. |
LICENSE_EXPIRED | License expired: The license for workstation [Workstation Name] expired on [Expiry Date]. | License has expired. | Access blocked. |
LICENSE_NOT_VALID | License not valid: The license for workstation [Workstation Name] is only valid until [Expiry Date]. | License is about to expire. | Warning is displayed. |
LICENSE_EXPIRED_REQUIRED | License not created: Expiry date is required for workstation [Workstation Name] of type [Subscription Type] but is not configured. | Expiration date is required but not set. | License cannot be created. |
GENERATION_DATE_MISSING | Invalid license: The license for workstation [Workstation Name] is corrupted (missing generation date). | Creation date is missing. | License is invalid. |
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. | Creation date is in the future. | License is invalid. |
VERIFY_SIGNATURE_FAILED | License verification failed: The license signature could not be verified. | Signature verification failed. | License was rejected. |
VERIFY_SIGNATURE_FAILED_MISSING_SINGATURE | Invalid license file: The license file is missing a required digital signature. | Signature is missing. | License cannot be validated. |
2.4. Computer Registration
The category Computer Registration currently includes eight error codes:
| Error Code | Error Message | Reason | Impact |
|---|---|---|---|
HARDWARE_HASH_NOT_REGISTERED | Workstation Machine not registered. Hardware hashes: V1=[Hardware 1], V2=[Hardware 2]. | Hardware is not registered. | Licensing allocation is not possible. |
WORKSTATION_MACHINE_BLOCKED | License not available: This machine marked as BLOCKED. | Workstation is locked. | Access is denied. |
WORKSTATION_MACHINE_DISABLED | License not available: This machine marked as DISABLED. | Workstation is disabled. | Access (temporarily) is denied. |
WORKFSTATION_ACTIVATION_FAILED | Activation failed: No machine is registered for this workstation. | No Workstation is registered. | Activation is not possible. |
WORKSTATION_ACTIVITATION_FAILED_MACHINE_INVALID_STATUS | Activation failed: Machine [Workstation Status] is not in a valid state for activation. | Workstation status for activation is invalid. | Activation is blocked. |
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. | Activation limit is reached. | Activation is denied. |
ACTIVATE_WORKSTATION_MACHINE_FAILED | Activation failed: Machine [Workstation Name] must be in INSTALLING status to be activated. | Computer must be in status "Install". | Activation is blocked. |
REGISTER_WORKSTATION_MASCHINE_FAILED | Registration failed: Cannot register new machine for workstation [Workstation Name] because another machine [Other Workstation Name] is in status INSTALLING. | Registration is blocked because the installation is in progress. | Registration is not possible. |
2.5. File Operations
The category File Operations currently includes six error codes:
| Error Code | Error Message | Reason | Impact |
|---|---|---|---|
LICENSE_FROM_XML_FAILED | Invalid license file: Unable to read the license file format. | XML format is invalid. | License file is not readable. |
UPLOAD_LICENCE_TMP_FAILED_READ_INPUT_STREAM | Upload failed: Unable to read the uploaded license file. | License file cannot be read. | Upload fails. |
UPLOAD_LICENCE_TMP_FAILED_EMPTY_INPUT_STREAM | Upload failed: The license file appears to be empty. | License file is empty. | Upload is rejected. |
UPLOAD_LICENCE_TMP_FAILED_SIGNATURE_VERIFICATION | Upload rejected: The license file signature is invalid. | Signature is invalid. | Upload is not accepted. |
UPLOAD_LICENCE_FAILED | Upload failed: Unable to save the license file to [Storage location]. | License file cannot be saved. | Processing failed. |
LICENSE_ERROR_READ_FILE | License file error: Unable to read the license file. | License file cannot be read. | Processing failed. |
2.6. Security and Verification
The category Security and Verification currently includes five error codes:
| Error Code | Error Message | Reason | Impact |
|---|---|---|---|
LICENSE_ERROR_WORKSTATION_UUID_MISSING | Invalid license file: The workstation UUID is corrupted or missing. | Workstation detection is missing/damaged. | License cannot be validated. |
LICENSE_ERROR_HARDWARE_HASH_MISSING | License validation failed: Hardware hash is missing from the license file. | Hardware hash is missing. | License cannot be validated. |
LICENSE_ERROR_WORKSTATION_MACHINE_HARDWARE_HASH_MISSING | Hardware hash validation failed: This machine cannot generate a hardware hash. | Computer cannot generate a hardware hash. | License validation is not possible. |
LICENSE_ERROR_WORKSTATION_MACHINE_HARDWARE_HASH_INVALID | Error reading license file: Workstation hardware hash does not match the license hardware hash. | Hardware hash does not match. | License is rejected. |
LICENSE_ERROR_WORKSTATION_MACHINE_HARDWARE_HASH_V2_INVALID | Error reading license file: Hardware hash V2 invalid. | New hash standard is invalid. | License validation failed. |
2.7. General Operations
The category General Operations currently includes three error codes:
| Error Code | Error Message | Reason | Impact |
|---|---|---|---|
INVALID_PARAMS |
Invalid request: Required information is missing or incorrect | Request is incomplete or incorrect. | Processing is not possible. |
LICENSE_NOT_CREATED |
License generation failed: Unable to create your license file | License could not be created in the License Manager. | No license is available. |
VALIDATE_LICENCE_FAILED_EMPTY_WORKSTATION_GUID |
Registration required: The workstation is not yet registered | Workstation is not registered. | License operation is blocked. |
Article Update: $PRODUCT_NAME_WORKFLOW 2.0.0 – 04/2026