Skip to main content
Skip table of contents

Migrate a UMS Server with the Same Embedded Database

Use Case

You have a UMS installation with an embedded database and want to migrate to a new UMS Server with the same embedded database. 

General Overview of the Migration Procedure

The migration procedure generally involves the following steps:

  1. Setting the IP address of the new server through profiles (only necessary, if devices find the UMS via IP)

  2. Stopping the IGEL RMGUIServer service on the old server

  3. Backing up the old server. Checklist for the backups:

    (tick) Database

    (tick) Transfer files
    (tick) Server configurations (host-specific server configurations that differ from the defaults are noted down separately)
    (tick) Firmware updates
    (tick) UMS ID

  4. Transferring the created backups to the new server

  5. Adjusting DHCP tag and DNS alias on the new server (only necessary, if devices find the UMS via DNS/DHCP)


On the Old Server

  1. If the devices find the UMS via the IP address, they can only connect to the new server if the IP address of the new server is set before the migration. To set the IP address:

    1. Create an OS 11 and an OS 12 profile with the new UMS server IP. The new server needs to get listed under System > Remote Management. For more information, see IGEL OS Base System > Configuration of IGEL OS 12 Device Settings > System > Remote Management and IGEL OS > IGEL OS Reference Manual > System > Remote Management.

    2. Assign the profiles. 

    3. Check that all devices got their settings by creating a view with the Last Boot Time criterion under Views. For more information, see How to Create a New View in the IGEL UMS.

  2. Stop the service IGEL RMGUIServer (for instructions, see IGEL UMS HA Services and Processes) and set the startup type for it to Disabled in order to prevent accidental parallel operation with the new UMS Server.


  3. Create a backup under UMS Administrator > Backups and copy it to a storage medium. Include all options in the backup. For detailed instructions, see the "Embedded Database" section under Creating a Backup of the IGEL UMS.

The backup of Server configurations includes most configurations of the Settings area in the UMS Administrator application. Exceptions: Web server port, JWS server port, and ciphers – they are host-specific, i.e. stored separately on each server and cannot be part of any backup. Therefore, you should note the values of these settings if they differ from the defaults and, in the case of recovery/migration procedure, they must be changed on each server manually.

  1. Create a backup of the UMS ID in the UMS Administrator > UMS ID Backup. For detailed instructions, see Transferring or Registering the UMS ID.

  2. Create a backup of all the files in the following folder. (You will need to restore them on the new server.)

[IGEL installation directory]/rmguiserver/webapps/ums_filetransfer

  1. In the UMS Console, go to UMS Administration > UMS Network > Server and note the process ID of the server.

On the New Server

  1. Install the UMS on the new server. If possible, use the same database user and password. For the installation instructions, see IGEL UMS Installation.

  2. Under UMS Administrator > Backups, select the folder with your backup and restore the respective backup file with all options. Wait until the UMS Server fully starts, i.e. the UMS Console can connect with it.

  3. Transfer the UMS ID of the previous UMS installation to the new server: UMS Administrator > UMS ID Backup > Restore. Alternatively, you can register the new UMS ID, which was created during the installation of the new server. For detailed instructions, see Transferring or Registering the UMS ID.

It is recommended to use the same UMS ID. The connection to ILP, App Portal and other services are all dependent on the UMS ID, and would be affected if it changes.

  1. If necessary, transfer host-specific server configurations to the new server.

  2. Restore the files to the folder, keeping the folder structure of the old server:

[IGEL installation directory]/rmguiserver/webapps/ums_filetransfer

  1. If the ICG is used: Connect the existing ICGs as described under How to Connect to the ICG after the UMS Server Migration or New Installation with the Same Database.

  2. Restart the service IGEL RMGUIServer. If the devices find the UMS via the IP address, they should connect automatically.

  3. If the devices find the UMS via DNS/DHCP:

    1. Adjust the DHCP tag and the DNS alias igelrmserver with the IP or FQDN of the new UMS Server. See Registering Devices Automatically on the IGEL UMS.

    2. Assign the new server to the old server certificate or create and assign a new certificate with the FQDN of the new server. For more information, see How to Use Your Own Certificates for Communication over the Web Port (Default: 8443) in IGEL UMS.

The configuration of the DHCP tag and the DNS alias is not a setting that can be made within the IGEL software. You must configure these within your individual network environment on the corresponding DHCP and DNS servers.

After the procedure is complete, open the UMS Console and go to UMS Administration > UMS Network > Server to check if there is an entry for the previous UMS Server among the listed components. If so, select the entry and click Delete in the context menu.

JavaScript errors detected

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

If this problem persists, please contact our support.