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 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.

    All UMS Servers and UMS Load Balancers must reside on the same VLAN. Network traffic must be allowed over UDP broadcast port 6155, and TCP traffic and UDP broadcast traffic over port 61616. For more information on UMS ports, see UMS Communication Ports.

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

  2. 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.

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

Starting the Installation

  1. Launch the UMS installer.

    You will need administration rights in order to install the IGEL UMS HA.

  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

    Installing UMS Server and UMS Load Balancer on Separate Servers

    If you install HA network components on separate servers, UMS Server must always be installed first. In this case, the IGEL network token, which is required for the integration of further servers into the HA network, will be created. Additionally, the UMS Console and UMS Administrator applications, necessary for the further management of the installation, will be installed too. After configuring and enabling the database via the UMS Administrator, the UMS Server will be available in the HA network.

    If you install an individual UMS Load Balancer, neither the IGEL network token nor UMS Console nor UMS Administrator will be installed. Only the option for uninstalling the UMS will then be set up in the Windows start menu.

  6. Confirm the system requirements dialog if your system fulfills them.
  7. Select the UMS data directoryin which Universal Firmware Updates and files are to be saved.
  8. Enable the option for creating an IGEL network token.

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

    Be sure to keep the IGEL network token in a safe place! It will be needed for all subsequent server installations. If the IGEL network token is lost, the complete installation must be started again.

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

    This function can destroy your UMS installation. Do not import this file unless you know exactly what you are doing.

  11. Specify a folder name for the shortcut.
  12. Read the summary and start the installation process.
  13. Close the UMS installer once the installation is complete.
    The UMS installer creates entries in the Windows software directory and the start menu. A shortcut for the UMS Console will also be placed on the desktop.

Defining the Database Connection

  1. Open the UMS Administrator.

    Default path to the UMS Administrator:

    Linux: /opt/IGEL/RemoteManager/RMAdmin.sh
    Windows: C:\Program Files\IGEL\RemoteManager\rmadmin\RMAdmin.exe

    The IGEL UMS Administrator application can only be started on the UMS Server.


  2. Select Datasource > Add.

  3. Enter the connection properties of the prepared database schema. See also Setting up a Data Source.
  4. 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 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.