In this article, you will learn
- which Error Codes can occur in connection with licenses, and
- how to handle these Error Codes.
1. Introduction
The License Server is responsible for managing and distributing software licenses. The server regularly checks various technical and organizational requirements. If problems occur, the server returns a specific error code. Each error code is unique and points to a clearly defined cause.
The Error Codes can be divided into seven main categories:
- Server Configuration – covers all problems with the basic infrastructure of the License Server, e.g., missing key files or unsupported encryption methods. These errors usually require intervention by the system administrator.
- Workstation Management – concerns incorrect or incomplete configurations of individual workstations in the system, e.g., missing expiration dates, incorrect versions, or disabled entries.
- License Validation – includes errors that occur when a license has expired, is invalid, or incomplete. This also covers problems with signature verification.
- Computer Registration – refers to the recognition and assignment of hardware to a license. Errors occur if devices are unregistered, blocked, or if too many devices have already been activated.
- File Operations – includes errors that can occur when uploading, saving, or importing License Files, e.g., due to incorrect file formats or insufficient access rights.
- 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., incorrect requests or general creation failures.
2. Error Codes – An Overview
Each category contains multiple Error Codes with different causes. Below is a detailed description of all Error Codes, their causes, and the respective effects.
2.1. Server Configuration
There are currently seven Error Codes available in the category Server Configuration:
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
There are currently eight Error Codes available in the category Workstation Management:
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_NIT_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
There are currently eight Error Codes available in the category License Validation:
Error Code | Error Message | Reason | Impact |
---|---|---|---|
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
|
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
There are currently eight Error Codes available in the category Computer Registration:
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 "Install" status. | 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
There are currently six Error Codes available in the category File Operation:
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
There are currently five Error Codes available in the category Security and Verification:
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 has | 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
Three Error Codes are currently available in the category General Operations:
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: Workflow 1.21.0 – 08/2025