Skip to main content
Skip table of contents

Online UCX Suite Licensing

Imagicle UCX Suite web portal for administrators includes a Licenses menu option under Administration menu. Here you can view the list of all available applications and if they are licensed, in evaluation mode, permanent mode or if the licenses are expired.

This article applies to on-prem UCX Suite only. Imagicle UCX Cloud Suite licensing is fully managed by Imagicle. Please contact Imagicle Support for more details.

Evaluation period

After the first installation/deployment, each application runs for 30 days in evaluation mode. Evaluation may be extended upon request to Imagicle Sales department.

Activation methods

Starting from UCX Suite 2019.Summer.1 release, Imagicle supports cloud-based activation method, using an Activation Token generated by the Imagicle Cloud licensing portal. The existing "offline" activation method", based on "Request String" + "Response Strings" is still available for backward compatibility and it is documented here.

Cloud Licensing

Cloud-based activation method requires UCX Suite server to reach a specific Internet URL: https://api.imagicle.com

If Internet access is controlled by a Proxy Server, then please make sure that it allows a transparent connection to above web URL (i.e. tunnel), not using "Decrypt and Scan" mode. Proxy configuration instructions are available here.

Test Cloud Connection

Open a browser in UCX Suite instance and go to https://api.imagicle.com/test
this message confirms the correct connection to our Cloud.

CODE
{
    "message":"successfully connected!"
}

From Imagicle web portal Admin ⇒ Licenses, it's possible to view current licenses status. See below sample:

image-20250113-084010.png

For every license, the following information are included:

image-20250113-084033.png

¹ License Type

Supported UCX Suite license types are:

  • Perpetual: never expires

  • Subscription: it expires, depending on annual subscription 

  • Evaluation: trial license for evaluation purposes, expiring in 30 days from deployment

  • Unknown: Wrong or not recognized license

² License Status

Each license is associated to own status:

  • Licensed: active license

  • Expiring: trial or subscription license, expiring within 30 days

  • Expired: trial or subscription license, already expired

  • Invalid: invalid license code

Licenses web page shows offline/online activation mode. Moreover, for each node, the following data is shown:

  • Node name

  • Customer name

  • Customer ID

If you are updating a UCX Suite with a release older than 2019.Summer.1, some of above information are not available and subsequently not displayed. See below:

image-20250113-084102.png

Licenses activation

From "Licenses" web page, please click on Activate Now button to initiate the license activation procedure. You are immediately prompted to select desired activation mode:

  • Online Activation: Self-service activation through Imagicle cloud service

  • Offline Activation: Offline activation through Imagicle Delivery team. See here for details.

Online Activation

It requires an "Activation Token", generated from Imagicle Cloud licensing portal. Please make sure you have received a "Smart Account" from Imagicle, otherwise you can request it from above Imagicle Cloud portal.

Once you have the token, pls. enter it in the relevant field "Activation Token". Hit Save to enable licenses or Cancel to go back to initial license screen.

image-20250113-084139.png

If activation is successfull, you are redirected to initial license page, which now shows:

  • ActivationMode: Online

  • Change button which allows to change activation mode or add/remove licenses by updating the Activation Token.

image-20250113-084155.png

If an online-activated UCX Suite can't reach Imagicle Cloud Licensing Portal for a long time, the instance keeps on working as usual until the subscription period expires.

Limitations

  • While updating to latest UCX Suite, from an existing, production 2019.Spring.1 or older release, resulting activation mode is Offline. No need for further activation activities.

  • New UCX Suite installations are configured by default with Online activation.

  • "Licenses" web page is accessible to Admin users only, with level 10 permissions (Complete Management)

  • Replacing an existing activation token with a new one is allowed

  • If an empty Activation Token is configured, all active licenses are removed. If you are within evaluation period, it doesn't make any difference. To re-activate the node, please enter previously removed valid Activation Token.

License renewal upon crash or migration

If your server crashes or your configuration is corrupted, you can resume full operativity by restoring all data and configurations, previously saved with a backup. See here the procedure for data backup/restore.

If you do not have a backup, or if you want to migrate UCX Suite to a new OS or a new hardware, please reinstall Imagicle UCX Suite as described here. A new Activation Token is generated, so you need to run through the activate procedure to enable licenses in new server.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.