Skip to main content
Skip table of contents

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

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

CODE
/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

CODE
/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

CODE
/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

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

Prints the current value of the given attribute.

Example:

Set Attribute Value

CODE
/sbin/rmagent-devattrs-set <ATTRIBUTE_NAME> <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

CODE
/sbin/rmagent-devattrs-reset <ATTRIBUTE_NAME>

Resets the given attribute to an empty value.

Example:

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

CODE
/sbin/rmagent-devattrs-sync

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

CODE
/sbin/rmagent-write-device-attributes

The complete set of attributes is sent to the UMS.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.