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.

Include Page
ENLITEUMSP:_Supported OSENLITEUMSP:
_Supported OS


...

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.

    Info

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



  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

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

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



  6. Read and confirm the license agreement.

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

  8. 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.
    Include Page
    ENLITEUMSP:_Update Installations_MDM and Distributed UMS NotificationsENLITEUMSP:
    _Update Installations_MDM and Distributed UMS Notifications


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


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

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

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



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



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

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

    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.



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

Info

It is recommended to check your antivirus software and, if installed, other management software like HP Device Manager for possible conflicts if

  • the installation of the IGEL UMS fails
  • the UMS Server service does not start when the installation is complete, and the manual start of the service fails. For details on how to start services, see IGEL UMS HA Services and Processes.
  • there are problems when connecting the UMS Console to the UMS Server


Info

Include Page
ENLITEUMSP:_SvIncludePlusContent-_UMS 12 Communication PortsENLITEUMSP:
_SvIncludePlusContent-_UMS 12 Communication Ports

For more information on UMS ports, see IGEL UMS Communication Ports.

Include Page
ENLITEUMSP:_Cluster Address for External Load Balancer, Reverse ProxyENLITEUMSP:
_Cluster Address for External Load Balancer, Reverse Proxy

Include Page
ENLITEUMSP:_Register the UMSENLITEUMSP:
_Register the UMS



TechChannel

...