Document toolboxDocument toolbox

(12.04.120-en_orig) Installing IGEL UMS on Microsoft Azure

Owned by Sarah Kunth-Wisskirchen
Last updated: Jun 11, 2024 by Harald SallerVersion comment
6 min read

This article describes a standard IGEL Universal Management Suite (UMS) single server installation (not High Availability) along with IGEL Cloud Gateway (ICG). The database is reachable via Azure or is hosted in Azure.


High Availability (HA)

IGEL UMS Server HA is not supported in cloud environments like Azure / AWS as they do not allow broadcast traffic within their networks.

IGEL Requirements

  • Microsoft Azure account
  • UMS 6.07.100 or higher

Creating a Virtual Machine for the IGEL UMS

  1. Log in to Microsoft Azure.

  2. Hover over Resource groups and select Create.


  3. Edit the data as follows:
    • Resource group: Enter a name for the resource group, e.g. "MyResourceGroup".

    • Region: Select a region, according to your preferences. 


  4. Click .
    Your resource group is validated.

  5. Click .
    Your resource group is created.

  6. Click Home to get to the overview.

  7. Hover over Virtual machines and select Create.


  8. Edit the data as follows:
    • Resource group: Select the resource group you have created before.
    • Virtual machine name: Enter a name for the virtual machine on which your UMS is to be installed.
    • Image: Select "Windows Server 2016 Datacenter".
    • Size: Select the size for your virtual machine. If all components will be running at the same time, we recommend “Standard B4ms” (4cpu/16 GiB). The components and their RAM requirements are as follows: 
      • UMS Server: 4 GB
      • UMS Administrator: 2 GB
      • UMS Console: 3 GB
      • UMS Web App: 1 GB
      • Embedded database: 2-3 GB
    • Select inbound ports: Select "HTTP (80)", "HTTPS (443)", and "RDP (3389". As an alternative, you can add the ports later on; see Configuring the Virtual Machine.


  9.  Click .

  10. Click .

Configuring the Virtual Machine

  1. In the sidebar menu, go to Networking.



  2. Click .

  3. Edit the data as follows:
    • Destination port ranges: Enter "8443".
    • Protocol: Select TCP.
    • Name: Change to "Port_8443".

  4. Click .


    After the installation is complete, do not forget to disable ports 3389 and 22!

  5. Select Outbound port rules.


  6. Click .

  7. Using the procedure described in steps 2 and 3, add the following ports:
  8. Review your settings.

Installing the IGEL UMS

  1. Ensure that your virtual machine is running.

  2. Click Connect and then select RDP. 


  3. Enter the displayed data in your RDP client or click  and use the RDP file.

  4. With a web browser, download the UMS installer from the IGEL Download Server > UNIVERSAL MANAGEMENT SUITE > WINDOWS. (Example: setup-igel-ums-windows_6.07.100.exe)

  5. Install the UMS as described in (12.04.120-en_orig) IGEL UMS Installation under Windows with the following settings:
    • Activate Standard UMS.
    • Activate with UMS Console.
    • Deactivate with Embedded Database if you are going to use the external database.
    • Deactivate Only UMS Console.
    • Activate UMS Web App.

  6. When the installation is finished, open the UMS Administrator and follow the instructions under (12.04.120-en_orig) How to Set Up a Data Source in the IGEL UMS Administrator.

Setting the Public Address on the IGEL UMS Server

  1. Start the UMS Console and log in.

  2. Go to UMS Administration > UMS Network > Server, open the context menu and select Edit.


  3. Enter the public ID of your virtual machine (displayed on the overview page) and click Save process configuration.

Create Web Certificates

  1. In the UMS Console, go to UMS Administration > Global Configuration > Certificate Management > Web.

  2. Select your root certificate and then select Create signed certificate from the context menu.


  3. Select Create one end certificate for all (known) servers and then confirm with Ok.


  4. Fill in the details as appropriate.

  5. Click Manage hostnames to verify if the internal IP Address and the public IP address are included.


  6. Review your settings and click Ok.


  7. Select your certificate and then select Assign server from the context menu.


  8. Assign your server to the certificate and confirm with Ok.


  9. Click Assign Certificate to server(s) to confirm.


  10. Check if the certificate is marked as Used.


    At this point, you can safely connect to your UMS from a local machine as well as from remotely installed UMS Consoles. For clarity purposes, we will still use the UMS Console on Azure.

Downloading the Installer for IGEL Cloud Gateway (ICG)

With a web browser, download the ICG installer from the IGEL Download Server > IGEL CLOUD GATEWAY (ICG). (Example: installer-2.02.110.bin) You can do this on the virtual machine or use your local machine and then copy the file to your virtual machine via RDP (clipboard).

Creating a Virtual Machine for IGEL Cloud Gateway (ICG)

  1. In your Azure portal, go to your resource group (in our example: MyResourceGroup) and add a new Ubuntu Server 18.04 LTS.




  2. Edit the settings as follows:
    • Resource group: This must be set to the resource group we have created before (in our example: MyResourceGroup).
    • Virtual machine name: Enter a name for the virtual machine.
    • Size: “D2s v3” (2 CPUs/8 GiB RAM) or higher is recommended.
    • Authentication type: Select Password.

    • Username: Enter a username for SSH access. This user account will be used for ICG installation by the UMS.

      For security reasons, the username should be long (20 to 30 characters) and cryptic.

      Username "icg" Is Reserved

      Do not use "icg" as a username for the remote installer; this is the username under which the Tomcat server is running.

    • Under Password and Confirm password, enter a strong password (20 to 30 characters are recommended)


  3. Click  and review the settings.

  4. Click .

  5. Click  and note the Public IP address.


Configuring the IGEL Cloud Gateway Server

  1. In the sidebar menu, go to Networking.


  2. Click .

  3. Edit the data as follows:
    • Destination port ranges: Enter "8443".
    • Protocol: Select TCP.
    • Name: Change to "Port_8443".

  4. Click .


Installing the IGEL Cloud Gateway

  1. Follow the instructions under Providing the Certificates.

  2. Follow the instructions under Installing the IGEL Cloud Gateway.

Connecting the Devices

Follow the instructions under Connecting the Devices.