Document toolboxDocument toolbox

(12.05.100-en) Troubleshooting Registration of a Device via Scanning for Devices Fails

The following article explains the possible reasons and solutions for device registration failure in the IGEL Universal Management Suite (UMS) when using the scan and register method. For details on the method, see Scanning the Network for Devices and Registering Devices on the IGEL UMS.


Symptom

Although a device can be scanned from the UMS Console, it cannot be registered on the UMS Server. One of the following error messages will appear in the UMS Console:

  • Cannot connect to remote management server

  • Protocol state invalid

  • Certificate invalid

Problem

This may be caused by

  • the server's firewall blocking the process

  • an already existing UMS certificate on the device

  • some database service hanging

  • network transfer delays or losses affecting the registration process

  • not correct time / date on the device or the UMS Server

Solution

Solving the Firewall Problem

  1. On your system running the UMS Console and UMS Server, add the following port to the Windows firewall as an exception:

    • Name = IGEL RMGUIServer

    • TCP Port = 30001

If you have changed the standard port 30001 in the UMS Administrator, open the firewall accordingly for this port. For more details on ports, see (12.05.100-en) IGEL UMS Communication Ports .

 

  1. Make sure no other firewall within the network is blocking ports 30001 and 30005.

  2. Try to import the device again.

It can also be useful to check the network firewall for SSL inspection.

Solving the Certificate Problem

With OS 11 devices:

→ Delete the server.crt certificate from /wfs/ folder on the device. Try to register the device again.

OR

→ If you know from which UMS Server exactly the device has received the certificate and have access to this UMS Server, you can remove the certificate as described under How to Remove a UMS Certificate from an OS 11 Device.


With OS 11 or OS 12 devices:

→ Reset the device to factory defaults and try to register the device again. For how to reset the IGEL OS device to factory defaults, see https://igel-jira.atlassian.net/wiki/spaces/ENLITEOSP/pages/127849246.

Solving the Database Problem

→ In the UMS Administrator > Datasource, disable the currently active data source and re-activate it again. Try to register the device again.

For details on the UMS Administrator, see The IGEL UMS Administrator.

Checking the Network

→ Check if the network is fine by sending pings from the device console to your UMS Server:
ping -s -c 10 -M do
Start with SIZE =1500 and decrease the size of packages until all packages got transferred without fragmentation or package loss. 1440 / 1400 / 1350 / 1300 are good values to test with.

For "pinging" the UMS Server on a device with IGEL OS, you can use the built-in network tools (see (12.04-en) Network Settings in the IGEL UMS Web App and, for OS 11, https://igel-jira.atlassian.net/wiki/spaces/ENLITEOSP/pages/127843196).

Checking Time and Date

→ Check if the time and date are set correctly on the device and on the UMS Server.

Related Topics

Troubleshooting: Device Registration Fails with Error Message: Unexpected end of input stream

Troubleshooting: Device Registration Behind SonicWall Firewall Fails

Troubleshooting: Device Scan or Online Check Fails