Skip to main content
Skip table of contents

How To Remove an IGEL License Completely

Issue

You want to get rid of license expiration messages, or you have other reasons for removing unneeded license files from a device.

Background

Removing a license from the IGEL License Portal (ILP) and the UMS does not remove it from the device. In this guide, you will learn how to remove the license from the IGEL License Portal, sync that to the UMS, and then remove the license from the IGEL device.

Environment

  • IGEL OS 11.01.100 or higher

  • UMS 6.01 or higher

Solution

The procedure varies, depending on whether the licenses have been deployed via Automatic License Deployment (ALD) or manually. Make sure to select the instructions that are appropriate for your case.

Removing the License from the IGEL License Portal (License Has Been Deployed via Automatic License Deployment)

The first step to completely removing a license from a device is to remove it from the IGEL License Portal (ILP).

  1. Identify the unit ID of the device you wish to remove from the Product Pack.

To copy the unit ID from the UMS Console to the clipboard, go to Devices > [device name] > Advanced System Information, select the value of Unit ID, and press [Ctrl] + [C].

  1. Log in to https://activation.igel.com.

  2. Click Search hardware in the left navigation bar, enter the unit ID, and click Search.

    f6b64ae6-d121-4f59-9ece-dd3d67cfb76a.png
    41550598-eef5-4253-a26d-f4836534cd6e.png


    A list of Product Packs the device is associated with is shown.

  3. Click the arrow icon of the license pack you want to remove the device from.

    12f625f7-4534-4f93-9e04-09a7fac4b2b5.png


  4. In the Manage dialog, click the Remove hardware button.

    f0bd1dab-d8cf-4bdc-aa8b-1d182710f8dd.png


  5. Check the box next to the unit ID of the device, confirm that you have read the Terms & Conditions, and click OK.

    17db0a7b-af1f-41b9-9a24-bc204ced842b.png


  6. Continue with Removing the Device License from the UMS.

Removing the License from the IGEL License Portal (License Has Been Deployed Manually)

The first step to completely removing a license from a device is to remove it from the IGEL License Portal (ILP). If the license has been deployed manually, the license file must then be downloaded and registered with the UMS again.

  1. Identify the unit ID of the device you wish to remove from the Product Pack.

To copy the unit ID from the UMS Console to the clipboard, go to Devices > [device name] > Advanced System Information, select the value of Unit ID, and press [Ctrl] + [C].


  1. In your browser, navigate to https://activation.igel.com and log in with your account.

  2. Click Search hardware in the left navigation bar, enter the unit ID, and click Search.

    f6b64ae6-d121-4f59-9ece-dd3d67cfb76a (1).png
    41550598-eef5-4253-a26d-f4836534cd6e (1).png

    A list of Product Packs the device is associated with is shown.

  3. Click the arrow icon of the license pack you want to remove the device from.

    12f625f7-4534-4f93-9e04-09a7fac4b2b5 (1).png


  4. In the Manage dialog, click the Remove hardware button.

    137e1c7e-2850-49e6-8ae0-c4ded63f0690.png


  5. Check the box next to the unit ID of the device, confirm that you have read the Terms & Conditions, and click OK.

  6. If the Product Pack has zero activated licenses after you have removed the hardware, you must add another hardware now. Otherwise, you will not be able to download the license file.

  7. Download the license file and store it on a drive that can be reached by the UMS Server.



  8. Continue with Removing the Device License from the UMS.

Removing the Device License from the UMS

  1. In the UMS Console, open UMS Administration and go to Global Configuration > Licenses > Device Licenses.


  1. Click the Select filter button, enter the unit ID of the device, and click Ok to locate the device you want to remove.

    3cacb19e-8866-4b33-bdf9-f89627fb70a4.png

You can also use the image2021-6-1_10-32-34.png button to navigate to the device if you like.

  1. Select the license you wish to release and then click the minus button in the top right.


  1. Make sure that no Product Pack has Automatic License Deployment (ALD) enabled without conditions. Otherwise, the device may get re-licensed. For details, see Configuring the Distribution Conditions.

  2. Click 7e858634-1cc1-467c-9d94-f6a5faf28919.png to add the updated license file.


  1. In the Select License Files dialog, click 7e858634-1cc1-467c-9d94-f6a5faf28919.png to open the file browser, select your license file, and click Open.

  2. Continue with Removing the IGEL Local License File from Your Device.

Removing the IGEL Local License File from Your Device

Now that you have removed the license from the license portal and the UMS, you can move forward with removing the device's local copy of the license. This will be done via a profile that has the appropriate custom commands.

  1. Download the right profile for your purposes:

Licenses to be removed

Profile

Remove all 90meter add-on licenses

RemoveAllAddon90MeterLicenses.zip

Remove all Enterprise Management licenses

RemoveAllEnterpriseManagementPackLicenses.zip

Remove all Ericom PowerTerm add-on licenses

RemoveAllAddonEricomPowerTermLicenses.zip

Remove all evaluation licenses

RemoveAllEvaluationLicenses.zip

Remove all licenses

RemoveAllLocalLicenses.zip

Remove all Teradici add-on licenses

RemoveAllAddonTeradiciLicenses.zip

Remove all Workspace Edition licenses

RemoveAllWorkspaceEditionLicenses.zip


  1. In the UMS Console, select System > Import  > Import Profiles.

    bdb5858f-b6b6-48e5-adb9-b873ab4132d8.png


  2. Select the zipped profile and click Open.

    529d2ec5-011d-4787-b319-cff43cb7c81e.png


  3. Review the next dialog and, if everything is correct, click Ok.

    f274ef20-e85e-4dfb-ae09-7a6d090c4eba.png


  4. Click Ok to close the confirmation dialog.

    9cc3f358-eb16-4401-9ab3-166bf97163fb.png


  5. In the structure tree, select the removal profile and click the daf703c7-ff8a-4573-8561-5918c70ed108.png icon next to Assigned objects.

You can only assign one removal profile to devices at a time.


  1. Select the devices from which you want to remove the license files and click Ok.

    147d5752-5b10-4ce3-b115-00f2ae4a5a64.png


  2. In the Update time dialog, select Now and click Ok.

    a6ed1421-0e66-4f85-b1c1-30c4c113727b.png


  3. In the structure tree, select the devices from which you want to remove the license files, and then select Reboot from the context menu.

    791c0ac7-fe5f-453e-8a1b-b004267c20e3.png

    During system startup, the license files are removed from the device.

  4. Remove the profile from the device.

    42a89ef7-e364-46cd-9d37-fc1f8cad9644.png

JavaScript errors detected

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

If this problem persists, please contact our support.