Document toolboxDocument toolbox

(12.05.100-en) How to Manage IGEL OS Devices by Device Specific Data - What Device Attributes Can Do for You

Owned by Emese Pogany
Aug 30, 2024
3 min read

Self-defined device attributes can be used to configure devices with the IGEL Universal Management Suite (UMS) according to device-specific data like location, department, or attached hardware.

To use this functionality, you create a custom script on the device that retrieves the desired data and sets the value of the relevant device attribute accordingly.

Note that you must use the UMS internal name of an attribute, not the display name. The UMS internal identifier is displayed in the UMS Console under UMS Administration > Global Configuration > Device Attributes; see also Managing Device Attributes for IGEL OS Devices. 

Also, note that permission to change attribute values must be granted by the UMS. This is the case if the Overwrite Rule is set to Devices or All in the UMS Console under UMS Administration > Global Configuration > Device Attributes; see also Managing Device Attributes for IGEL OS Devices.

The character limit for device attributes is 100 characters. Longer entries will not be synchronized with the UMS.

Environment

For OS 11 Devices

  • IGEL UMS 6.10 or higher

  • Devices with IGEL OS 11.07.100 or higher

For OS 12 Devices

  • IGEL UMS 12.03.100 or higher

  • Devices with IGEL OS 12.3.0 or higher

Command Reference

List All Device Attributes

/sbin/rmagent-devattrs-enum

Lists all device attributes including the current value for this device. The enumeration is ordered according to the attribute's order id. 

Example:

Device Attribute of the Type "List": List All Possible Values

/sbin/rmagent-devattrs-enum-range <ATTRIBUTE_NAME>

Enumerates entries of the given range. The enumeration is ordered according to the range item's order id. 

Example:

Print Attribute Type

/sbin/rmagent-devattrs-get-type <ATTRIBUTE_NAME>

Prints the type of the given attribute. Possible types are:

  • string

  • number

  • date (format: yyyy-mm-dd)

  • range

Example:

Print Attribute Value

Prints the current value of the given attribute.

Example:

Set Attribute Value

Sets the given attribute to the specified value. If the overwrite rule for this attribute does not permit the device to change the value, an error is returned. Note that this command does not check the value type.

Example:

Reset Attribute Value

Resets the given attribute to an empty value.

Example:

Send Attributes to UMS If a Value Has Been Changed by Device

If any of the attribute values have been changed by the device, the complete set of attributes is sent to the UMS. 

Send Attributes to UMS

The complete set of attributes is sent to the UMS.