Document toolboxDocument toolbox

(12.04.120) Devices - View and Manage Your Endpoint Devices in the IGEL UMS Web App

Owned by Harald Saller
Last updated: Aug 23, 2024 by Emese Pogany
7 min read

In the Devices area of the IGEL Universal Management Suite (UMS) Web App, you can manage devices registered on the UMS Server. All devices registered on the UMS Server are shown.

Device changes made in the UMS Console are immediately available in the UMS Web App, and vice versa.

Menu path: UMS Web App > Devices

You can structure the Devices area by creating directories and subdirectories. When doing so, you should bear in mind that each device can only be stored in a single directory. 

Avoid placing too many devices in one folder. If the user interface feels sluggish, refer to the tips regarding the folder structure under Performance Optimizations in IGEL UMS.

Directory Level:

Device Level:



1

Directory Tree

Shows all created directories and subdirectories. The format (x/y) specifies 1) the number of devices contained directly in the directory and 2) the total number of devices in the directory & all subdirectories of this directory.

2

Device list

Shows all devices directly contained in the directory selected in the Directory Tree.

  • Paging for the navigation in the device list

  • Defining the number of devices to be displayed on one page

  • Filtering devices by Name, Product ID, Unit ID, Version, and IP Address

  • Sorting devices by Name, Product ID, Unit ID, Version, and IP Address

  • Right-click on the device opens a context menu.

3A

Directory information

Details for the directory selected in the Directory Tree


[Directory Name]: The name of the selected directory


Properties: Properties of the selected directory, e.g. the full Directory Path, Number of contained devices


Assigned Objects: Directly and indirectly assigned objects, e.g. profiles, files, firmware updates, etc. For details, see Assigning Objects in the IGEL UMS Web App.

3B

Device information

Details for the device selected in the device list

Status display

The status of the selected device. For icons showing the device's status, see Status Displays below.

[Device Name]

The name of the selected device. It does not need to be identical to the name of the device in the network. The name of a device does not need to be unique and can be used a number of times.
To rename the device, click , type a new name, and press [Enter]. For other renaming options, see How to Rename IGEL OS Devices.

 

Properties

Properties of the selected device, e.g. Last IP, MAC Address, Unit ID, Last Contact, etc. 

The unit ID serves as a unique identifier of an endpoint device in the UMS. With IGEL devices, IGEL zero clients, devices converted with the IGEL UDC/OSC, and devices with the IGEL UMA, the unit ID is set to the MAC address of the device.
If the device is a UD Pocket, the unit ID is set to the serial number (without spaces and special characters), preceded by the prefix consisting of the USB vendor and product ID.

 

[Directory Path]

Full directory path for the selected device

 

Custom Properties
Allows changing such customizable properties as Site, Department, device attributes. To edit the properties, click .

 

Custom Device Attributes

Device attributes are currently configured only in the UMS Console under UMS Administration > Global Configuration > Device Attributes.

Whether you can change the values for the device attributes via the UMS Web App depends on your configuration of the Global Overwrite Rule and/or Overwrite Rule for a specific device attribute, see Managing Device Attributes for IGEL OS Devices in the IGEL UMS.

Tabs

The following tabs are displayed only if data is available:

  • Licenses

  • Network Adapter

  • Installed Apps

  • User Login History

 

Assigned Objects

Shows the directly and indirectly assigned objects, e.g. profiles, apps, files, etc. For details, see How to Assign Objects in the IGEL UMS Web App.

 

System Information
Shows such properties as CPU Type, Memory Size, Device Type, etc. To copy a property's value, click .

 

Licenses
Details on the licenses for the selected device. To copy a value, click .

 

Network Adapter
Displays information about all available network adapters of a device. The section is available for devices with IGEL OS 11.07.100 or higher. For details, see the section "Network Adapters" under View Device Information in the IGEL UMS.

 

Installed Apps
Shows all apps present on the IGEL OS 12 device, their status and time when the device delivers the message about the app status. For details, see Checking Installed Apps via the IGEL UMS Web App.

 

User Login History
Shows up to 10 last user logins if the logging is enabled. For details on the logging activation, and the logged information, see the section "User Login History" under View Device Information in the IGEL UMS.

4

Device commands

Device commands, e.g. power control commands, firmware updates, etc., are executed for an individual directory or an individual device. The status of the command execution is shown under Messages image-20240614-113558.png

→ Click image-20240614-113604.png to view all available device commands.

For details on the device commands, see Device Commands below.

Status Displays

The UMS monitors the status of the devices by regularly sending UDP packets. In accordance with the preset, this occurs every 3 seconds. For information on how to change the interval for the online check, see Devices - Managing Devices in the IGEL UMS.

When the device is connected via IGEL Cloud Gateway (ICG), a cloud symbol icon image-20240823-081714.png is added to the device.

 

The exclamation mark indicates that changes, i.e. new configurations, files, profiles, etc., have not yet been transferred to the device.

Icons for an IGEL OS Device

The following icons show the status of an IGEL OS device:

The device is online.

The device is offline.

The device is being updated.

The status of the device is unknown or has not yet been processed.

Device Commands

The following commands can be executed for an individual device as well as for an individual directory (with the exception of shadowing and configuration editing). 

If a user does not have sufficient rights, the command icons are grayed out. For information on permissions in the UMS, see Access Rights.

image-20240614-113919.png  Edit configuration

Allows you to edit configuration parameters for the selected device.

Here, you edit the device setup as you would if you were working at the endpoint device itself.

image-20240614-113923.png  Shadow

Shadowing: Launches a VNC session for the highlighted device if shadowing is enabled for this device, see (12.4-en) Shadow Settings in IGEL OS 12 .

For details on shadowing in the UMS, see Shadowing - Observe IGEL OS Desktop via VNC and IGEL UMS and Devices: Secure Shadowing Communication Flow.

image-20240614-113926.png  Assign object

Assigns / detaches an object, e.g. a profile, a file, etc. For details, see Assigning Objects in the IGEL UMS Web App.

image-20240614-113930.png  Reboot

Restarts the highlighted device.

image-20240614-113934.png  Shutdown

Shuts down the highlighted device.

image-20240614-113937.png  Wake up

Starts the highlighted device via the network (Wake-on-LAN).

For details on configuring Wake-on-LAN in the UMS, see Wake on LAN.

image-20240614-113943.png  Suspend

Puts the highlighted device into suspend mode.

image-20240614-113946.png  Send settings

Reads out the complete last device configuration from the UMS database and sends it to the highlighted device.

image-20240614-113949.png  Receive settings

Reads the local configuration of the highlighted device, sends it to the UMS, and writes it to the database.

image-20240614-113952.png  Reset to factory defaults

Resets the highlighted device to the factory defaults; see Resetting a Device to Factory Defaults via the IGEL UMS Web App.

For other methods of resetting a device to factory defaults, see https://igel-jira.atlassian.net/wiki/spaces/ENLITEOSP/pages/127849246  and https://igel-jira.atlassian.net/wiki/spaces/ENLITEOSP/pages/127811286 .

image-20240614-113955.png  Update

OS 11: Carries out a firmware update on the highlighted IGEL OS 11 device.

OS 12: Triggers the activation of the assigned app version for the selected IGEL OS 12 devices. The Update command is only needed if System > Update > Activate app after the installation is disabled; see How to Configure the Background App Update in the IGEL UMS Web App.

image-20240614-113959.png  Update on shutdown

Only for OS 11: Updates the firmware when the highlighted IGEL OS 11 device is shut down.

image-20240614-114002.png  Refresh system information

Refreshes the system information for the highlighted device.

image-20240614-114005.png  Refresh license information

Refreshes the license information for the highlighted device.

image-20240614-114008.png Export as Profile

Exports device settings, see Exporting Device Settings as a Profile in the IGEL UMS Web App.

image-20240614-114012.png  Send message

Sends a message to the highlighted device; see Sending a Message to Devices via the IGEL UMS Web App.

Specific Device Commands

Opens a menu of the specific device commands that are available for the folder or device.

Which commands are available depends on the following criteria:

  • The device has IGEL OS 12.3 or higher

  • An app that supports specific device commands is installed on the device.

Â