Document toolboxDocument toolbox

(12.05.100-en) How to Scan the Network for Devices and Register Devices on the IGEL UMS

Owned by Emese Pogany
Aug 30, 2024
6 min read

In the following article, you will learn how to register devices on the IGEL Universal Management Suite (UMS) using the Scan for devices function. This function is described for the UMS Console as well as for the UMS Web App.

For an overview of device registration methods, see (12.05.100-en) Registering IGEL OS Devices on the UMS Server .

The scan and register feature can only be used when an endpoint device can open a direct connection to the UMS. Thus, when an external load balancer / reverse proxy is configured, this feature might not be usable; see NGINX: Example Configuration for as Reverse Proxy in IGEL OS with SSL Offloading.

 

In order to find devices in the network, the following requirements must be met:

  • The devices must be switched on and functioning.

  • The firmware for the devices must support the UMS. This is the case with the following devices:

    • IGEL devices with original firmware

    • Devices converted with IGEL OS Creator (OSC)

    • Devices on which IGEL OS was booted via a UD Pocket

    • Devices on which IGEL OS was installed using IGEL Universal Desktop Converter 3 (UDC3)

Scan and Register Function in the UMS Console

To search for devices in the network and register them in the UMS, proceed as follows:

  1. Log in to the UMS Console.


  2. Click on .
    The Scanning for devices window will open.

     

  3. Specify the search area:

    • Local Network of the UMS Server: The UMS Server will send a broadcast message to the network.

       

    • IP Range: The UMS Server contacts each device in the given range.

    • List of IP Ranges: With Edit list, you can specify the IP ranges in which the UMS will search for devices.

    • Use TCP for scanning: If this option is enabled, communication with the devices will take place via TCP. If this option is disabled, UDP will be used.

If TCP is used for searching, the search procedure will take longer; the scan results can be more reliable, however.

 

  1. Click Scan.
    The search results will be shown in the Found devices window. The devices can now be registered.

As soon as you have obtained the search result, you can register new devices.

  1. If you only want to see devices with a specific feature in the Certificate stored, Unit ID, MAC Address, Name, IP Address, or Product column, enter the corresponding character string in the Filter field.
    To sort, simply click the required column name.

 

You won't be able to register a device with Certificate stored = "Yes" unless the UMS has the same certificate. 

"Yes" for Certificate stored indicates that the device has already a server certificate from some UMS, i.e.

 

  1. Select the devices that are to be registered. You have the following options:

    • Manual selection: In the Include column, highlight the devices that are to be registered.

    • Selecting all devices that are not yet registered: Click on Select New Ones. This will highlight all devices that have not yet received a server certificate from the UMS.

  2. Click OK.
    The devices will now be registered in the UMS database. This may take some time.


The result of the procedure and any error messages will be displayed in a new window. The devices will be placed in the Devices directory in the structure tree if no other directory was specified under Put in directory.

Scan and Register Function in the UMS Web App

To search for devices in the network and register them in the UMS, proceed as follows:

  1. Open the UMS Web App and go to Devices.

  2. If you want the devices to be placed in a specific directory during the registration, highlight the required directory in the structure tree. If no specific directory is selected, the devices will be placed in the Devices directory.

  3. Click Scan for devices image-20240617-175019.png .
    The Scanning for Devices window will open.

     

  4. Specify the search area:

    • Local network of the UMS Server: The UMS Server will send a broadcast message to the network.

       

    • IP range: The UMS Server contacts each device in the given range. To specify the IP range, use the format [IP-Start] - [IP-End], e.g. 192.168.0.0 - 192.168.178.210. To specify several IP ranges, press [Enter].

    • Use TCP for scanning: If this option is enabled, communication with the devices will take place via TCP. If this option is disabled, UDP will be used.

       

    • Hide already managed devices: Devices that have already been registered, i.e. that have already a server certificate from some UMS, will not be shown in the search results.

     

  5. Click Scan.
    The search results will be shown. The devices can now be registered.

As soon as you have obtained the search result, you can register new devices.

  1. If you only want to see devices with a specific feature in the Name, Unit ID, MAC Address, IP Address, or Product column, enter the corresponding character string in the Filter field. 
    To filter the results in the Already Managed column, enable or disable Hide already managed devices.

     

 

  1. Select the devices that are to be registered. You have the following options:

    • Manual selection: Select the individual devices that are to be registered.

    • Selecting all devices: This will highlight all devices, but only the devices that have not yet received a server certificate from the UMS will be registered:



  2. Check if the correct directory is selected under Add devices to directory. 

  3. Click Register.
    The devices will now be registered in the UMS database. This may take some time.