Document toolboxDocument toolbox

Remote Management in IGEL OS 12

Owned by Comala Publishing for Confluence Cloud
Last updated: Nov 19, 2024
3 min read

In IGEL OS, endpoint devices are managed using the Universal Management Suite (UMS). This article shows the settings related to the remote management, for example, the configuration of UMS servers and user information dialogs on UMS updates.

Menu path: System > Remote Management

 

image-20240918-103035.png

 

Universal Management Suite

If the device is registered on a UMS Server, its IP address / hostname and Port number will be shown in the list.

The list can contain more than one UMS instance. If the device cannot contact a UMS Server under the hostname igelrmserver, and the DHCP option 244 is not set, the device will go through the entries in the list until it can contact a UMS Server successfully.

 

To manage the list of servers:

 

  • UMS server
    Name or IP of the UMS Server

  • Port number
    Port number of the UMS Server (Default: 8443)

  • Connector type
    The value is automatically defined by the UMS. You can use the Ranking of connectors option under System > Remote Management > Options to define which connection the device should try to establish first based on the connector types.
    Possible values:

    • undefined (default)

    • ums
      Direct connection to the Universal Management Suite.

    • icg
      Connection to the IGEL Cloud Gateway (ICG).



Display “Apply changes” dialog on boot

If new settings were made in the UMS, the device may receive them during the boot procedure. 

☑ During the boot procedure, the Apply changes dialog is displayed and the user can decide whether the new settings are applied immediately. If the user does not allow them to be applied immediately, they will automatically be applied next time the system is restarted. (Default)

☐ The Apply changes dialog will not be shown. The new settings will be applied or ignored depending on the setting under Default action on boot.

 

Timeout

Number of seconds for which the Apply changes dialog is shown. If the timeout is exceeded, the received settings will automatically be applied. (Default: 20)
Setting the value to 0 disables the timeout, and the dialog is shown until the user clicks a button.

 

Default action on boot

Configure the action that is to be performed if the dialog exceeds the timeout or if the timeout is disabled.
Possible values:

  • Apply changed configuration immediately: New settings will take effect immediately, and programs that are running may be restarted. (Default)

  • Ignore changed configuration: New settings will not be applied. The new configuration will be saved on the device, and applied the next time a new configuration is applied.

 

Prompt user on UMS actions

☑ The user is informed through a message window when UMS actions are performed on the device. (Default)

☐ The user is not informed when UMS actions are performed on the device.

 

Timeout

Number of seconds for which the UMS actions information dialog is shown. If the timeout is exceeded, the received settings will automatically be applied. (Default: 20)
Setting the value to 0 disables the timeout, and the dialog is shown until the user clicks on a button.

 

Structure tag

The structure tag is used to sort the device into a directory in accordance with the UMS directory rules. For details see (12.06.100-en) Using Structure Tags with IGEL OS Devices.

Instead of setting the structure tag using this option, the preferable way to manually set the structure tag in the OS12 is using the command tool: /sbin/rmagent-set-structure-tag -t <TAG>

Instead of checking the structure tag here, use the command tool /sbin/rmagent-get-structure-tag for retrieving of the current value of the structure tag in the OS12. Because if the structure tag is set via Setup Assistant or via DHCP tag, the value in the Setup will be empty, but the command will always retrieve the value.

The command line tool /sbin/rmagent-register provides the possibility to set the structure tag using the option -u <TAG>. This tool is used for some scenarios of automatic register with custom scripts.

 

Log message severity

Select the severity level above which device errors are to be transferred to the UMS. Messages with a lower severity are suppressed.
Possible options:

  • off (Default)

  • error

  • warn

  • info

  • debug

 

Show UMS connection status tray icon on desktop

☑ The image-20240716-123133.png icon is displayed in the taskbar, showing the status of the UMS connection. Clicking the icon displays information about the connected UMS server.