The following article describes the complete procedure for installing the standard UMS (IGEL Universal Management Suite) with an embedded database under Linux. If your required installation differs, you can select individual components, e.g. for a standalone UMS Console installation.

For the supported operating systems, see the "Supported Environment" section of the release notes




The procedure for installing the IGEL UMS under Linux is as follows:

  1. Download the current version of the IGEL Universal Management Suite from the IGEL Download Server.
  2. 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.
  3. 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.
  4. Execute the installation file as root or with sudo:
    sudo ./setup-igel-ums-linux-[Version].bin
    This unzips the files into the /tmp directory, starts the included Java Virtual Machine, and removes the temporary files once the installation has been completed.
  5. Start the installation procedure by pressing Enter.

    You can cancel the installation at any time by pressing the [Esc] key twice.
  6. Read and confirm the license agreement.
  7. Choose whether the installer will install the required dependencies:
    • Now: Installs the necessary dependencies automatically.
    • Manual: Skips the installation. You will have to install the required dependencies manually if this has not already been done.
    • Cancel installer: Aborts the installation procedure.
  8. Under Destination directory, select the directory in which the UMS is to be installed. (Default: /opt/IGEL/RemoteManager)
  9. If you are updating an existing UMS installation: Under Database backup, select a file for the backup of the embedded database, licenses, and certificates. If you have already created a backup, you can select No (continue) in order to skip this step. See also Updating under Linux.
  10. Under Installation type, select the scope of installation:
    Custom file transfer directories are no longer supported. After completing the installation, move the existing files to the ums_filetransfer/ directory and edit Files and Firmware update in the UMS Console to bring them online again. You may also need to amend download addresses in the device configurations and profiles.
  11. Choose whether the UMS Web App should be installed.
  12. Confirm the system requirements dialog if your system fulfills them.
  13. Under Data directory, select the directory in which Universal Firmware Updates and files are to be saved. (Default: /opt/IGEL/RemoteManager)
  14. Under Database selection, select the desired database system.
    • Internal: The embedded database
    • Other: An external database server
    The embedded database is suitable for most purposes. It is included in the standard installation.
    If you manage a large network of devices or a dedicated database system is already in use in your company, it is advisable to use this external database system. The same applies if you integrate the High Availability solution. For more information on using external databases for the IGEL UMS, see Connecting External Database Systems.
  15. Under User name, enter a user name and password for the database connection.
    The credentials for the database connection are created.

    Initially, the credentials entered here are also the credentials of the UMS superuser. After the installation, the credentials for the database user and those for the UMS superuser can be changed independently from each other. For more information about the UMS superuser, see Changing the UMS Superuser.

  16. Specify whether you would like to create shortcuts for the UMS Console and UMS Administrator on the menu.
  17. Check the summary of the installation settings and start the procedure by selecting Start installation.
    If you have selected the standard installation, the UMS Server along with the embedded database will be installed and started.

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

  19. Connect the UMS Console to the UMS Server by entering the login data for the database that you specified during the installation.


TechChannel