Install Lucent Sky AVM license

2024/1/22 |

This article describes how to install a Lucent Sky AVM license.

In this article, you will learn how to:

  • Install a Lucent Sky AVM license with online activation using the Web UI and the CLEAR Engine installer.
  • Install a Lucent Sky AVM license with offline activation using the Web UI and the CLEAR Engine installer.
  • Uninstall a Lucent Sky AVM license using the Web UI and the CLEAR Engine installer.
  • Troubleshoot errors that might occur during license installation.

At the end, you will be able to install and uninstall a Lucent Sky AVM license, and troubleshoot errors that might occur during license installation.

Install Lucent Sky AVM license

  • Online activation using the Web UI

    1. Open the Web UI and sign in with an administrator account.
    2. Open Settings, then select License and Usage.
    3. Select Change Product Key, enter your license key in Product Key, then select Change Product Key.
    4. If the activation was successful, you will receive a confirmation and be signed out.
    5. Some license changes require restarting CLEAR Engine. To restart CLEAR Engine, sign in again, open Settings > System, then select Restart Service.

  • Offline activation using the Web UI

    1. Open the Web UI and sign in with an administrator account.
    2. Open Settings, then select License and Usage.
    3. Select Change Product Key, enter your license key in Product Key, select Offline Activation, then select Change Product Key.
    4. The browser will automatically download a Request.txt file. Provide this file to Lucent Sky support. Once you receive a license file from Lucent Sky support, continue with the following steps.
    5. Open Settings, then select License and Usage.
    6. Select Install a License File, select the license file you received from Lucent Sky support, then select Install License File.
    7. If the activation was successful, you will receive a confirmation and be signed out.
    8. Some license changes require restarting CLEAR Engine. To restart CLEAR Engine, sign in again, open Settings > System, then select Restart Service.

  • Online activation using the CLEAR Engine installer

    1. Open PowerShell as administrator.

    2. Enter the following command:

       # Replace <ProductKey> with product key
 $productKey = "<ProductKey>"
 ."C:\ProgramData\Lucent Sky\CLEAR Engine\Maintenance\Current\SkyAnalyzer.Engine.Installer.exe" -aon "$productKey"
    3. Select Yes if you accept the license terms.
    4. A message box will confirm if the activation was successful. If the activation was not successful or a message box did not appear, refer to the log files under the Logs directory for more information on the activation failure.

    5. Some license changes require restarting CLEAR Engine. To restart CLEAR Engine, enter the following command:

       Stop-Service "CLEAR Engine"; Start-Service "CLEAR Engine"

  • Offline activation using the CLEAR Engine installer

    1. Open PowerShell as administrator.

    2. Enter the following command:

       # Replace <ProductKey> with product key
 $productKey = "<ProductKey>"
 ."C:\ProgramData\Lucent Sky\CLEAR Engine\Maintenance\Current\SkyAnalyzer.Engine.Installer.exe" -acr "$productKey"
    3. A dialog box will appear indicating a Request.txt file was created. Provide this file to Lucent Sky support. Once you receive a license file from Lucent Sky support, continue with the following steps.

    4. Enter the following command:

       # Replace <LicenseFilePath> with path to license file
 $licenseFilePath = "<LicenseFilePath>"
 ."C:\ProgramData\Lucent Sky\CLEAR Engine\Maintenance\Current\SkyAnalyzer.Engine.Installer.exe" -aco "$licenseFilePath"
    5. Select Yes if you accept the license terms.
    6. A message box will confirm if the activation was successful. If the activation was not successful or a message box did not appear, refer to the log files under the Logs directory for more information on the activation failure.

    7. Some license changes require restarting CLEAR Engine. To restart CLEAR Engine, enter the following command:

       Stop-Service "CLEAR Engine"; Start-Service "CLEAR Engine"

Uninstall Lucent Sky AVM license

Deactivating CLEAR Engine license allows moving the license to another server.

  • Deactivation using the Web UI

    1. Open the Web UI and sign in with an administrator account.
    2. Open Settings, then select License and Usage.
    3. Select Change Product Key, enter 00000-00000-00000-00000-00000 in Product Key, then select Change Product Key.
    4. Refresh the page to confirm that the license type is Invalid.

  • Deactivation using the CLEAR Engine installer

    1. Open PowerShell as administrator.

    2. Enter the following command:

       ."C:\ProgramData\Lucent Sky\CLEAR Engine\Maintenance\Current\SkyAnalyzer.Engine.Installer.exe" -aon "00000-00000-00000-00000-00000"
    3. On the Web UI, open Settings and select License and Usage.
    4. Confirm that the license type is Invalid.

Troubleshoot errors that might occur during license installation

If errors occurred during license installation, the error messages provided by the Web UI typically has a description accompanied by an error symbol (such as MALFORMED_PRODUCT_KEY), while the error messages provided by the CLI typically has a description accompanied by an error code (such as -11). As the descriptions might change, it is recommended to use the error symbol or the error code to look up the causes and solutions to error.

To learn more about troubleshooting errors occurred during license installation, view the following article in the Lucent Sky Knowledge Base:
Troubleshoot licensing errors