Document toolboxDocument toolbox

How to Update the IGEL UMS under Linux

Owned by Christina Loher (Deactivated)
Last updated: Aug 26, 2024 by Emese Pogany
3 min read

Before starting the update of the IGEL Universal Management Suite (UMS), read IGEL UMS Update.

Create a backup of the database before updating a previously installed version of the UMS. Otherwise, you risk losing all database content.

 

To perform an update under Linux, proceed as follows:

  1. Download the current version of the IGEL Universal Management Suite from the IGEL Download Server.

For integrity and security purposes, it is recommended to verify the checksum of the downloaded software.

image-2023-5-10_12-21-8.png

 

  1. Open a terminal emulator such as xterm and switch to the directory in which the installation file setup-igel-ums-linux-[Version].bin is located.

  2. Check whether the installation file is executable. If not, it can be made executable with the following command:
    chmod u+x setup*.bin

You will need root/sudo rights to carry out the installation.

 

  1. Execute the installation file as root or with sudo:
    sudo ./setup-igel-ums-linux-[Version].bin
    The installer unzips the files into the /tmp directory, starts the included Java Virtual Machine, and removes the temporary files once the installation has been completed.

  2. Start the installation procedure by pressing Enter.

You can cancel the installation at any time by pressing the [Esc] key twice.

 

  1. Read and confirm the license agreement.

  2. Under Database backup, select a file for the backup of the existing embedded database. If you have already created a backup, you can select No (continue) in order to skip this step.

  1. Under Installation type, select the scope of installation:

  2. Choose whether the UMS Web App should be installed. See Important Information for the IGEL UMS Web App.

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

  4. Under Confirm server IP address, confirm or enter the IP address of the UMS Server. This IP address will be used for the creation of the UMS Server certificate on the initial startup.
    This dialog is shown only on the first installation of a UMS version that includes this feature.

If you do not adjust the IP address during the installation of the UMS, the web certificate of your UMS Server will contain the wrong IP, which results in problems with device registration, etc. To solve the issue, a new web certificate will have to be generated. See Troubleshooting Invalid Web Certificate and Errors by Device Registration after the Installation of the IGEL UMS 12 on Linux .

 

  1. Specify whether you would like to create shortcuts for the UMS Console and UMS Administrator in the menu.

  2. Check the summary of the installation settings and start the procedure by selecting Start installation.

 

  1. Once the installation procedure is complete, open the UMS Console via the menu or with the command /opt/IGEL/RemoteManager/RemoteManager.sh

It is generally NOT recommended to execute the command RemoteManager.sh with sudo. On Red Hat Enterprise Linux 8, RemoteManager.sh can be executed only without sudo.

 

  1. Connect the UMS Console to the UMS Server with the help of the existing access data.
    To connect to the UMS Web App, see How to Log In to the IGEL UMS Web App.