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 from 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, dependent 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].

  2. Log in to https://activation.igel.com.
  3. Click Search hardware in the left navigation bar, enter the unit ID, and click Search.



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

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

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

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

  7. 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].

  2. In your browser, navigate to https://activation.igel.com and log in with your account.
  3. Click Search hardware in the left navigation bar, enter the unit ID, and click Search.



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

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

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

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

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

  8. Download the license file and store it on a drive that can be reached by the UMS Server.
  9. 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.
  2. Click the Select filter button, enter the unit ID of the device, and click Ok to locate the device you want to remove.

    You can also use the  button to navigate to the device if you like.

  3. Select the license you wish to release and then click the minus button in the top right.
  4. 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.
  5. Click  to add the updated license file.
  6. In the Select License Files dialog, click  to open the file browser, select your license file, and click Open.


  7. 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:

    License Files to Be RemovedProfile
    Remove all licenses
    Remove all evaluation licenses
    Remove all Enterprise Management licenses

    Remove all Workspace Edition licenses

    Remove all Ericom PowerTerm add-on licenses

    Remove all 90meter add-on licenses

    Remove all Teradici add-on licenses
  2. In the UMS Console, select System > Import  > Import Profiles.

  3. Select the zipped profile and click Open.

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

  5. Click Ok to close the confirmation dialog.

  6. In the structure tree, select the removal profile and click the icon next to Assigned objects.

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



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

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

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

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