Prerequisites
- XDeploy installed on the management server
- Access to license.xloud.tech for key file submission
- Server hardware finalized (CPU, motherboard, and disks should not change after activation)
Activation Status
The status indicator at the top of the XDeploy Key page shows the current activation state of the management platform.| Status | Meaning |
|---|---|
| Active | Valid key installed, all XDeploy tools are unlocked |
| Inactive | No key installed, deployment tools are restricted |
| Expired | Key has passed its expiration date, renewal required |
The activation status is checked automatically each time XDeploy loads. Manual verification is only needed when troubleshooting or after hardware changes.
Activation Process
Request Key
Click Request Key to collect the hardware fingerprint from the management server. The tool gathers:
The collected data is encrypted and packaged into a downloadable
| Data Point | Purpose |
|---|---|
| CPU Sockets | Physical processor count for license binding |
| Total Cores | Aggregate core count across all sockets |
| Hostname | Server identity for license tracking |
.xlic request file. Save this file to your local machine.Submit to Portal
Upload the
.xlic request file to license.xloud.tech. The portal validates the request and generates a signed key file.Key generation is typically immediate for customers with active support agreements. Contact support@xloud.tech if your request is pending for more than 24 hours.
Upload Key
Return to the XDeploy Key page and drag the signed
.xlic key file into the upload area. The maximum file size is 50 KB.The tool validates the digital signature, displays a preview of the key details (customer name, expiration date, licensed features), and installs the key.XDeploy activated. All platform tools are now unlocked and ready for use.
Key Management
Two management actions are available for an installed key:Verify
Re-validates the installed key against the current hardware fingerprint. Use after hardware maintenance, motherboard replacement, or CPU changes to confirm the key remains valid.
Remove
Deletes the installed key from the management server. Requires explicit confirmation before proceeding. After removal, XDeploy reverts to the restricted state until a new key is installed.
Removing the key deactivates XDeploy immediately. All deployment tools, configuration interfaces, and management workflows become restricted. You will need a new key to resume using the platform. Only remove the key if you are decommissioning the server or transferring the license.
Troubleshooting
Key upload rejected with invalid signature
Key upload rejected with invalid signature
Cause: The
.xlic file was corrupted during download or transfer.Resolution: Re-download the signed key file from the license portal. Transfer using a binary-safe method (SCP, SFTP, or direct browser download). Do not open the file in a text editor, as this can alter binary content. Upload the file again.Verification fails after hardware maintenance
Verification fails after hardware maintenance
Cause: The hardware fingerprint changed due to CPU, motherboard, or disk replacement.Resolution: Generate a new key request with the updated hardware fingerprint. Submit the new request to license.xloud.tech and install the returned signed key.
XDeploy shows Inactive despite key upload
XDeploy shows Inactive despite key upload
Cause: The key file may have been uploaded for a different server, or the key has expired.Resolution: Check the key details in the upload preview — confirm the hostname and hardware identifiers match the current server. If the key is expired, request a renewal through the license portal or contact support@xloud.tech.
Next Steps
Bootstrap
Validate hardware requirements and install deployment dependencies
Cluster License
License the deployed cloud cluster for production use