Document toolboxDocument toolbox

(12.05.100-en) How to Update the IGEL UMS under Linux

Owned by Emese Pogany
Last updated: Aug 30, 2024
4 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.

Oracle

For the proper operation of the UMS with Oracle databases, particularly for the upgrade process, the number of open_cursors for the database must be adjusted. open_cursors is a system setting.

  1. To get the actual value, log in to the database as SYSDBA and execute:
    SQL> select name, value from v$parameter where name = 'open_cursors';

  2. The recommended value for open_cursors is "3000". To set the value, issue the following command as SYSDBA:
    SQL> alter system set open_cursors = 3000 scope=both;

  3. The same command should be added to the SPFILE of the Oracle system in order for the changes to persist on the next reboot.

 

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

 

  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.

 

  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.

 

  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

 

  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.

Â