Document toolboxDocument toolbox

(12.01-en) Renaming IGEL OS Devices

By default, if no naming convention is activated and the original hostname of the IGEL OS device has not been changed, the name a device gets upon registration in the UMS is composed of the prefix “ITC” ("TC-", in the case of import with the serial number) and the MAC address of the device.

Example: ITC00E0C520XXXX; TC-00E0C520XXXX

Before renaming/registering the devices, it is recommended, first of all, to pay attention to the following settings in UMS Console > UMS Administration > Global Configuration > Device Network Settings > Adjust Names of Devices. Activate them according to your needs:

Renaming upon Registration

Option 1: Via UMS Console > Device Network Settings > Naming Convention

  1. Before registering the devices, activate and define Naming Convention in the UMS under UMS Administration > Global Configuration > Device Network Settings, see Device Network Settings.

  2. If the network name, i.e. terminal name, of the device, should be adjusted, enable Device Network Settings > Adjust network name if UMS-internal name has been changed.

  3. Save the changes.

    Tip

    If the network name remained unchanged after the device registration is complete, click Other commands > Settings UMS->Device from the device's context menu.

Option 2: Via UMS Console > System > Import > Import Devices (Short or Long Format Only) If the Required Names Are Preliminarily Defined in the Import File

If the Naming Convention option does not suit your needs, you can import the devices with the names that fulfill your requirements. For the general instruction, see (12.01-en) Importing Devices.

  1. When preparing the import file, specify the required device names. See (12.01-en) Import with Short Format or (12.01-en) Import with Long Format

  2. If the network name, i.e. terminal name, of the devices, should be adjusted, enable UMS Administration > Global Configuration > Device Network Settings > Adjust network name if UMS-internal name has been changed.

Option 3: Via IGEL Setup > Accessories > UMS Registration (only for IGEL OS 11 or Earlier)

If the Naming Convention is not activated and you need to register only a small number of devices, you can specify the required name when registering the device as follows:

On the device, open IGEL Setup > Accessories > UMS Registration and specify the device name you need under New host name. For more information, see Using UMS Registration Function.

Option 4: Via IGEL Setup > Network

If the Naming Convention is not activated:

Before registering the device in the UMS, adjust its name locally

  • IGEL OS 12:  under IGEL Setup > Network > Computer name
  • IGEL OS 11 and earlier: under IGEL Setup > Network > LAN Interfaces > Terminal name

When the device is registered, this name will also be used in the UMS.

Renaming Already Registered Devices

Option 1: Via UMS Console > Device Network Settings > Naming Convention

  1. Activate and define Naming Convention in the UMS under UMS Administration > Global Configuration > Device Network Settings, see Device Network Settings.

  2. If the network name, i.e. terminal name, of the device should be adjusted, enable Device Network Settings > Adjust network name if UMS-internal name has been changed.

  3. Save the changes.

  4. To rename the devices, select one of the following options:
    • Rename all devices: All devices registered in the UMS will be renamed in accordance with the naming convention using the existing enumeration.
      Example:


    • Rename and renumber all devices: All devices will be renamed in accordance with the naming convention, this will result in continuous, end-to-end numbering. All names will be reallocated. If numbers have become free because devices were taken out of service, these numbers will be used for other devices.
      Example:

      Tip

      If the network name remained unchanged, click Other commands > Settings UMS->Device from the device's context menu.

Option 2: Via UMS Console > System > Import > Import Devices (Short or Long Format Only) If the Required Names Are Preliminarily Defined in the Import File

If the Naming Convention option does not suit your needs, you can reimport the devices with the names that fulfill your requirements. For the general instruction, see (12.01-en) Importing Devices.

  1. When preparing the import file, specify the required device names. See (12.01-en) Import with Short Format or (12.01-en) Import with Long Format

  2. If the network name, i.e. terminal name, of the devices, should be adjusted, enable UMS Administration > Global Configuration > Device Network Settings > Adjust network name if UMS-internal name has been changed.

Option 3: Via UMS Console > [device's context menu] > Rename or via Setup > Network

If you have to rename individual devices, see Changing the Hostname of an IGEL Device via UMS.

Option 4: Via IGEL Management Interface (IMI)

If you are using IMI, you can rename your devices as described under PUT /v3/thinclients/{tcId}.

General Notes

  • After renaming via UMS, it may be necessary to reboot the endpoint up to three times before the changed network name is displayed correctly. 
  • Scripts under System > Firmware Customization > Custom Commands as well as some DNS or DHCP infrastructure settings may interfere and obstruct the renaming of devices.