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
/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:
![](../../../__attachments/127730583/image2022-3-23_11-22-51.png?inst-v=1988f46b-383c-421a-87c5-1a663c4b07b1)
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:
![](../../../__attachments/127730583/image2022-3-23_11-13-23.png?inst-v=1988f46b-383c-421a-87c5-1a663c4b07b1)
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:
![](../../../__attachments/127730583/image2022-3-23_12-18-3.png?inst-v=1988f46b-383c-421a-87c5-1a663c4b07b1)
Print Attribute Value
/sbin/rmagent-devattrs-get <ATTRIBUTE_NAME>
Prints the current value of the given attribute.
Example:
![](../../../__attachments/127730583/image2022-3-23_12-28-44.png?inst-v=1988f46b-383c-421a-87c5-1a663c4b07b1)
Set Attribute Value
/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:
![](../../../__attachments/127730583/image2022-3-23_13-29-53.png?inst-v=1988f46b-383c-421a-87c5-1a663c4b07b1)
Reset Attribute Value
/sbin/rmagent-devattrs-reset <ATTRIBUTE_NAME>
Resets the given attribute to an empty value.
Example:
![](../../../__attachments/127730583/image2022-3-23_15-18-49.png?inst-v=1988f46b-383c-421a-87c5-1a663c4b07b1)
Send Attributes to UMS If a Value Has Been Changed by Device
/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
/sbin/rmagent-write-device-attributes
The complete set of attributes is sent to the UMS.