Document toolboxDocument toolbox

(12.06.100-en) Installing the First Server in an HA Network

Owned by Emese Pogany
Oct 25, 2024
6 min read

Prerequisites

  • A set of servers with the operating system supported by the UMS; see the "Supported Environment" section of the release notes.

  • A database system supported by the UMS; see the "Supported Environment" section of the release notes.

  • All installation requirements described under HA: Installation Requirements are fulfilled.

  • The current version of the UMS is downloaded from the IGEL Download Server.

For the first installation, it is advisable to use a server without an existing UMS installation.

Instructions

To install the UMS High Availability (HA) Extension on the first server, follow the instructions in the order given:

  1. Preparing the Database

  2. Preparing the Servers

  3. Starting the Installation

  4. Defining the Database Connection

  5. Checking the Installation

  6. Saving the IGEL Network Token

Preparing the Database

→ Create a database schema and a user for the UMS. Use the relevant DBMS program and its documentation. See also Connecting External Database Systems.

Preparing the Servers

  1. Verify that each server can "see" the other servers via the network.

  • High Availability with IGEL UMS Load Balancers: All UMS Servers and UMS Load Balancers must reside on the same VLAN.

  • For High Availability (UMS HA) with IGEL UMS Load Balancers, network traffic must be allowed over UDP broadcast port 6155, and TCP traffic and UDP broadcast traffic over port 61616. For further port configuration, see IGEL UMS Communication Ports.

  • The network configuration on Windows Servers must have the TCP/IPv6 option enabled for UMS 12.

  • IGEL UMS HA installation with IGEL UMS Load Balancers is not supported in cloud environments like Azure / AWS as they do not allow broadcast traffic within their networks. The HA installation without IGEL UMS Load Balancers (as well as the Distributed UMS) is, however, supported in cloud environments as of UMS version 6.10.

 

  1. Verify that the time on all servers is synchronized.

To avoid problems with your HA installation, make sure that the time on the servers of the HA network does not differ by more than one minute. After each manual time reset, the HA services on the relevant server must be restarted.

 

  1. For Linux systems, make the directory /root writable for the user root.

Starting the Installation

  1. Launch the UMS installer.

     

  2. Read and confirm the License Agreement.

  3. Read the Information regarding the installation process.

  4. Select a path for the installation.

  5. Depending on your desired HA network configuration, select the components to be installed: UMS Server + UMS Load Balancer or UMS Server.

 

 

  1. Confirm the system requirements dialog if your system fulfills them.

  2. Select the UMS data directory, in which Universal Firmware Updates and files are to be saved.

  3. Enable the option for creating an IGEL network token.

    image-20240617-111328.png

  4. Specify a directory for saving the IGEL network token. The directory must be writeable for the administrator.

 

  1. Optional: Under Import existing keystore, you can load the tc.keystore file from an existing UMS installation.

 

  1. If the internal Windows firewall is active on your host: Review the settings under Windows firewall settings and change them where necessary. Each port that is activated here will be set as rule in the Windows firewall. 

 

  1. Under Select Start Menu Folder, specify a folder name for the shortcut.

  2. Under Select Additional Tasks, specify whether you would like to create shortcuts for the UMS Console and UMS Administrator on the desktop.

  3. Read the summary and start the installation process.

  4. Close the UMS installer once the installation is complete.
    The UMS installer creates entries in the Windows software directory and the start menu. If this was selected, shortcuts for the UMS Console and UMS Administrator will also be placed on the desktop.

Defining the Database Connection

  1. Open the UMS Administrator.

 

  1. Select Datasource > Add.

  2. Enter the connection properties of the prepared database schema. See also How to Set Up a Data Source in the IGEL UMS Administrator.

  3. Click Activate to enable the data source. See also Activating a Data Source.

Checking the Installation

  1. Check if all processes are running. For the list of UMS HA processes, see IGEL UMS HA Services and Processes.

  2. In the UMS Console, go to UMS Administration > UMS Network and check the items Server and Load Balancer if the complete UMS HA Extension has been chosen for the installation.

Saving the IGEL Network Token

→ Save the IGEL network token, i.e. the file IGEL-Network.token, on a storage medium which will be accessible when installing further HA servers (e.g. on the network or on a portable storage medium such as a USB stick). Always keep the IGEL network token well protected.

Next Step

>> Proceed with adding a further server to the HA installation, see Adding Further Servers to the HA Network.