Using Structure Tags with IGEL OS Devices

A structure tag is a text string bound to the IGEL OS device that is transmitted to IGEL Universal Management Suite (UMS). When rolling out devices automatically, it can be difficult to assign each device to the desired device folder in the UMS. Using structure tags, newly registered devices will automatically be placed in the structure tree of the UMS based on their structure tag and the corresponding default directory rule.

To use structure tags:

1. Define a structure tag in your Default Directory Rules under UMS Administration > Global Configuration > Default Directory Rules.
   See How to Create a Default Directory Rule.

2. Assign a structure tag to a device. You can do this manually, during onboarding of OS 12 devices, or via DHCP.

Manual Assignment

OS 11

In IGEL OS 11 devices, you can assign the structure tag value manually on the endpoint or through a profile. To assign the value, enter the value in System > Remote Management > Structure tag.

OS 12

In OS 12 devices, you can assign structure tags starting from IGEL OS 12.5.0.

→ To assign the value, use the command tool /sbin/rmagent-set-structure-tag -t <TAG> .

Setting the structure tag via a profile should be avoided as it can cause unwanted side effects.

Example scenario:

There is a default directory rule in place that moves the device to a target UMS folder based on the structure tag value. As the structure tag value is set by the profile, the default directory rule gets activated, and the device is moved to the target UMS folder. As soon as the device is moved to the target folder, it receives the profiles assigned to this folder. If the target folder doesn’t contain the profile value of the structure tag, the device loses the structure tag value. As a result, the device will be moved back to the original folder because the structure tag default directory rule is not fulfilled anymore.

Use the command /sbin/rmagent-get-structure-tag for getting the currently used structure tag value. If the structure tag was already set via the Setup Assistant or via DHCP tag the tool will retrieve the value.

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

Assignment During Onboarding Using Setup Assistant

The structure tag can be entered during the onboarding of the IGEL OS 12 devices. For details, see Onboarding IGEL OS 12 Devices.

DHCP Assignment

To assign a structure tag via DHCP Server, use the appropriate DHCP option, depending on the IGEL OS version of your endpoint devices:

• IGEL OS 11.03.500 or lower: Use DHCP option 226 to distribute the tag value to the devices. Set the DHCP option 226 as a string - not as a DWORD.

• IGEL OS 11.04.100 or higher: As an alternative, you can use the DHCP option 43 (encapsulated vendor-specific options) to send the DHCP option 226 (name: "umsstructuretag") to the right endpoint devices. An endpoint device with IGEL OS 11.04.100 or higher sends option 60 (vendor class identifier) with igel-dhcp-1 as the value.

An IGEL specific DHCP option that is sent in DHCP option 43 overrides a corresponding DHCP option that is sent in the global namespace. The DHCP options 1, 224, and 226 can be embedded in option 43.

You can prevent a DHCP option 226 that has been sent in the global namespace from being interpreted. To achieve this, you must add option 1 (name "exclusive", type Byte, value 1) to DHCP option 43.