Troubleshooting Common IGEL Licensing Problems

In this article you will find the most common reasons behind license related problems in the form of a checklist.


You can start your troubleshooting by going through this checklist in any order you see fit:

  • Use the latest available UMS version and OS version. You can download the most recent version from Software Downloads | IGEL.

  • Check if NTP is set, and if time/date is correct on the devices. For more information, see Time and Date and Time and Date in IGEL OS 12.

  • Check if time/date differs on hardware level. Check the BIOS. For more information, please refer to the corresponding documentation of your hardware vendor.

  • Check if the MAC address and unit ID are the same. In case they are not, you can restore the MAC address by running the command get_unit_id -r -f in a terminal and rebooting the system afterwards.

  • Check if the license deployment is set to automatic. For more information, see Setting up Automatic License Deployment (ALD).

  • Check the communication ports. For more information, see IGEL UMS Communication Ports.

  • Check for BIOS updates. 

  • Try deploying the lic file locally. For more information, see Manual License Deployment for IGEL OS.

  • Delete all local licenses. For more information, see How To Remove an IGEL License Completely.

  • On IGEL OS 11, check the output of rm_ping_for_license in Local Terminal.

  • In case you use ALD via ALD Token, it might make sense to delete the ALD token and create a new one, especially when you had a renewal and the expiration date doesn't get updated in your UMS. For more information see Setting up Automatic License Deployment (ALD) with ALD Token.