User Manual

License Troubleshooting

Updated on

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

Previous Article Offline License Activation