Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

...

  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

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

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

  4. Start the installation procedure by pressing Enter.

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

  5. Read and confirm the license agreement.

  6. Under Destination directory, select the directory in which the UMS is to be installed. (Default: /opt/IGEL/RemoteManager)

  7. If you are updating an existing UMS installation: Under Database backup, select a file for the backup of the embedded database. If you have already created a backup, you can select No (continue) in order to skip this step. See also Updating the IGEL UMS under Linux.

    Info

    For Update Installations Only

    • As of UMS 12, the MDM feature is no longer available. Cancel the upgrade to UMS 12 if you still need the MDM feature:

    • Only if you have a Distributed UMS installation: During the update installation, it will be checked whether only one UMS Server is running and the others are stopped. If not, stop all UMS Servers except one and proceed with the update; otherwise, you risk losing data. After the update on this server is complete, you can update the remaining UMS Servers, either simultaneously or one after another.

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

  9. Choose whether theIGEL UMS Web Appshould be installed. See Important Information for the IGEL UMS Web App.

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

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

    Note

    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 (12.06.110-en) Troubleshooting Invalid Web Certificate and Errors by Device Registration after the Installation of the IGEL UMS 12 on Linux.

  12. Under Data directory, select the directory in which Universal Firmware Updates and files are to be saved. (Default: /opt/IGEL/RemoteManager)

    Warning
    Files and firmware updates are stored in the ums_filetransfer directory. Custom file transfer directories are not supported. 

  13. Under Database selection, select the desired database system.

    • Internal: The embedded database

    • Other: An external database server

    Info

    The embedded database is suitable for most purposes. It is included in the standard installation.

    The use of an external database system is recommended in the following cases:

    • You manage a large network of devices.
    • A dedicated database system is already in use in your company.
    • You integrate the High Availability or the Distributed UMS solution.

    For more information regarding the use of the IGEL UMS with external databases, see (12.06.110-en) Connecting External Database Systems.

  14. Under User name, enter a user name and password for the database connection.
    The credentials for the database connection are created.

    Info

    The user name and password are case-sensitive.

    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 (12.06.110-en) Changing the UMS Superuser.

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

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

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

    Info

    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.

  18. Connect the UMS Console to the UMS Server by entering the login data for the database that you specified during the installation. For more information, see Connecting the UMS Console to the IGEL UMS Server.
    To connect to the UMS Web App, see How to Log In to the IGEL UMS Web App.

...