To perform an update under Linux, proceed as follows:

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.

  1. Download the current version of the IGEL Universal Management Suite from the IGEL Download Server.
  2. Log in as root.

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

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

  5. Execute the installation file.
    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.

    You can cancel the installation at any time by pressing the [Esc] key twice.
  6. Read and confirm the license agreement.
  7. Read the explanation of the installation process.
  8. Under Destination directory, select the directory in which the UMS is to be installed. (Default: /opt/IGEL/RemoteManager)
  9. 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.
  10. Under Installation type, select the scope of installation:
    • Complete: UMS Server and UMS Console
    • Client only: UMS Console only
    • HA net: High Availability configuration (requires a license)
  11. Select the Runlevels in which the UMS server is to run.
  12. Specify whether you would like to create shortcuts for the UMS Console and UMS Administrator in the menu.
  13. Check the summary of the installation settings and start the procedure by selecting Start installation.

    During a UMS upgrade, e.g. from 5.08 to 5.09, the database schema is changed by the installer. With large production databases, this process can last up to 2 hours. Do not abort the installation during this time.

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

  15. Connect the UMS Console to the UMS Server with the help of the existing access data.