You can configure the data source, UMS ID, and Distributed UMS settings of the IGEL Universal Management Suite (UMS) through environment variables or an application.yml file. These configuration sources support automated and repeatable deployments without requiring you to configure these settings manually in the UMS Administrator.
This article explains how to prepare the required values, configure the UMS on Linux or Windows, and understand the priority and limitations of the supported configuration sources.
Configuration Process Overview
You can provide UMS settings through environment variables, an application.yml file, or a combination of both. When the UMS Server starts, it evaluates each setting separately and uses the source with the highest priority. When the same setting is defined in more than one source, the UMS Server applies the value from the source with the higher priority.
|
Configuration Source |
Priority |
When to Use It |
|---|---|---|
|
Environment variables |
Highest |
Use for automated deployments or when the deployment system supplies configuration values to the operating system. |
|
|
Second |
Use when you want to maintain the UMS settings in a configuration file. |
|
UMS Administrator |
Lowest |
Use for settings that are not defined through environment variables or |
The configuration process consists of the following stages:
-
Prepare the data source values and UMS ID values on an existing UMS installation.
-
Choose where to define each setting. You can use one source for all supported settings or use different sources for individual settings.
-
Add the prepared values to the selected configuration source and apply to the UMS Server.
-
The UMS Server loads each setting according to the configuration source priority.
Prepare Values for Environment Variables or application.yml
Before configuring the target UMS installation, prepare the required data source and UMS ID values on an existing, running UMS installation. The prepared values can then be supplied through environment variables or added to application.yml.
Use a Linux installation to generate the UMS ID configuration data because the required ums_id_collect_outputs.sh script is available only on Linux. You can use the generated values to configure a target UMS installation on Linux or Windows.
Prepare the Data Source Configuration
Prepare the following properties and values for setting up the data source via a configuration source:
|
Property |
Value to Provide |
|---|---|
|
|
Provide the JDBC connection string. |
|
|
Provide the database user name. |
|
|
Provide the encrypted database password. Encrypt the database password by running Example: The command returns the encrypted password:
|
|
|
Provide the JDBC driver class name. The driver classes used by the implementation are defined in the The following JDBC driver class names are available:
|
|
|
Provide the database type. The database types used by the implementation are defined in the The following database types are available:
|
Example data source configuration:
url: jdbc:postgresql://db_ip_address:5432/db_name
username: db_user
password: <encrypted_database_password>
driver-class-name: org.postgresql.Driver
db-type: postgre
Prepare the UMS ID
-
Create a new UMS ID by using one of the following methods:
-
-
In the UMS Administrator, use Create new Main UMS ID. For details, see UMS ID Backup in the IGEL Administrator.
-
In the UMS Administrator CLI, use
licensing create. For details, see IGEL UMS Administrator Command-Line Interface.
-
-
Register the UMS ID in the IGEL License Portal as described in Registering the UMS.
-
On Linux, run the following script to generate the UMS ID configuration data:
<installation_path>/rmadmin/ums_id_collect_outputs.sh
The log shows the path to the output directory:
[info] Config and artifacts are in:
<installation_path>/IGEL/RemoteManager/rmadmin/config/20251121T132813Z
The output directory contains files similar to the following:
drwx------ 2 root root 4096 Nov 21 14:28 .
drwxrwxr-x 4 root ums_tomcat_user 4096 Nov 21 14:28 ..
-rw------- 1 root root 5321 Nov 21 14:28 ums_id_config.ini
-rw-r--r-- 1 root root 1939 Nov 21 14:28 UMS_ID.crt
-rw------- 1 root root 3886 Nov 21 14:28 ums-id.ksbak
-rw------- 1 root root 5184 Nov 21 14:28 ums-id.ksbak.b64
The ums_id_config.ini file provides the following values for configuration through environment variables or application.yml:
|
Property |
Description |
|---|---|
|
|
Name of the backup file |
|
|
Base64-encoded backup file |
|
|
Password entered when running |
Configure the UMS Through application.yml
The paths referenced below reflect the default UMS installation directories:
-
Linux:
/opt/IGEL/RemoteManager/ -
Windows:
C:\Program Files\IGEL\RemoteManager\
If a custom installation directory was chosen during setup, replace the default path prefix with your custom directory path (for example, <custom_install_path>/rmguiserver/conf/appconfig/application.yml).
-
After installing the UMS, stop the UMS Server.
-
Access the
application.ymlfile:-
On Linux, open
/opt/IGEL/RemoteManager/rmguiserver/conf/appconfig/application.yml. -
On Windows, open
C:\Program Files\IGEL\RemoteManager\rmguiserver\conf\appconfig\application.yml.
-
-
Add the prepared values to
application.ymlin the following format:igel: datasource: url: jdbc:postgresql://db_ip_address:5432/db_name username: db_user password: <encrypted_database_password> driver-class-name: org.postgresql.Driver db-type: postgre ums-id: backup-file-name: UMS-External-ID backup-file-password: <backup_file_password_from_ums_id_config.ini> backup-file-value: <ums_backup_file_value_from_ums_id_config.ini> distributed-ums: true
-
Start the UMS Server.
Configure the UMS Through Environment Variables
Define the prepared environment variables as shown in the following example:
IGEL_DATASOURCE_URL=jdbc:postgresql://db_ip_address:5432/db_name
IGEL_DATASOURCE_USERNAME=db_user
IGEL_DATASOURCE_DB_TYPE=postgre
IGEL_DATASOURCE_DRIVER=org.postgresql.Driver
IGEL_DATASOURCE_PASSWORD=<encrypted_database_password>
IGEL_DISTRIBUTED_UMS=false
IGEL_UMS_ID_BACKUP_VALUE=<ums_backup_file_value_from_ums_id_config.ini>
IGEL_UMS_ID_BACKUP_NAME=UMS-External-ID
IGEL_UMS_ID_BACKUP_PASSWORD=<backup_file_password_from_ums_id_config.ini>
Set the Environment Variables on Linux Before or After Installation
When setting up environment variables before UMS installation:
-
Add the prepared environment variables to
/etc/environment. -
Run the UMS installer.
When setting up environment variables after UMS is already installed:
-
Add the prepared environment variables to
/etc/environment. -
Restart the UMS service.
Use global environment variables instead of user-specific environment variables. The Linux pkexec utility used to run the UMS Administrator restricts the use of environment variables as a security measure.
Set the Environment Variables on Windows Before Installation
-
Before installing the UMS, add each name-value pair to the Windows environment variables.
-
Run the UMS installer.
Limitations of Environment Variable and application.yml Configuration
When a property is defined through a configuration source other than the UMS Administrator, you cannot change that property through the UMS Administrator or the UMS Administrator CLI.
UMS Administrator Application Limitations
The properties configured through environment variables or application.yml cannot be changed through the UMS Administrator. Attempts to change them result in the error messages shown in the table below:
|
Configured Setting |
Restricted Action |
Message Shown |
|---|---|---|
|
Data source |
Under Datasource > Datasource Configurations, the Add, Edit, and Delete buttons do not perform their associated actions. |
|
|
UMS ID |
Under UMS ID Backup, Restore does not restore the backup file. |
|
|
Distributed UMS |
Under Distributed UMS > High Availability UMS > Distributed UMS, changing Enable Distributed UMS does not change the configuration. |
|
UMS Administrator CLI Limitations
The properties configured through environment variables or application.yml cannot be changed through the UMS Administrator CLI. Attempts to change them result in the error messages shown in the table below:
|
Configured Setting |
Restricted Command |
Message Shown |
|---|---|---|
|
Data source |
|
|
|
UMS ID |
|
|
|
Distributed UMS |
|
|