Startup configuration reference
This page is a reference of the properties used in Semarchy xDM startup configuration.
Repository datasource
The base configuration must include the repository datasource, used by the application to connect the repository database. This datasource is configured with the properties listed below.
Driver and URL are mandatory properties for the repository datasource. The credentials used for this datasource are those configured for the repository storage. |
The repository datasource uses the same properties as the platform datasources, as well as a connection pool. See datasources for more details about datasource configuration and connection pools. |
Property (Environment variable) | Description |
---|---|
|
JDBC driver class for the repository database. This property is required.
|
|
JDBC URL for the repository database. This property is required.
|
|
Database user to connect the repository database ( |
|
Database user password ( |
|
Maximum number of milliseconds to wait to establish a connection. The default value is 30000 (30 seconds). |
|
Amount of time in milliseconds allowed for a connection to sit in the pool before being retired. The default value is 600000 (10 minutes). |
|
Frequency of the attempts to keep idle connections alive. The default value is 0 (feature disabled). |
|
Maximum lifetime of a connection before it is retired from the pool. The default value is 1800000 (30 minutes). |
|
SQL query used to test or keep a connection alive. The default value is null, and the JDBC test method is used. |
|
Minimum number of idle connections to maintain in the pool. The default value is 1. |
|
Maximum number of idle and in-use connections in the pool. The default value is set to 16. |
|
SQL query executed when creating a connection and adding it to the pool. |
|
Maximum number of milliseconds to wait for a connection test to succeed. The default value is 5000 (5 seconds). |
|
Driver properties. This value is a JSON object containing the driver properties that you want to set. For example:
|
|
Required the first time you connect to Semarchy xDM to create or upgrade the repository and used as an authentication method to let you configure the administrator login and password. |
Repository read-only datasource
The base configuration must also include the repository read-only datasource, used by the application to connect the repository database with read-only credentials. This datasource is used by xDM Discovery built-in profile dashboards.
This datasource is configured with the properties listed below. These properties are similar to those of the repository datasource, and most inherit from the repository datasource configuration.
Username and password are the only mandatory properties for the repository read-only datasource. The credentials used for this datasource are those configured for the repository read-only user. |
Property (Environment variable) | Description |
---|---|
|
Database user to connect the repository database ( |
|
Database user password ( |
|
Minimum number of idle connections to maintain in the pool. The default value is 1. |
|
Maximum number of idle and in-use connections in the pool. The default value is set to 4. |
( |
These properties use by default the value defined in the repository datasource. You can override them here. |
|
Driver properties are inherited from those defined in the repository datasource. A driver property set here replaces the one defined for the repository datasource. |
Identity management
By default, all the enabled identity providers are available on each node of a clustered Semarchy xDM environment. The xdm.idm.availableidps
property allows defining the list of available IDPs on a given node.
Property (Environment variable) | Description |
---|---|
|
Comma-separated list of identity providers that should be available for a given Semarchy xDM node. The names should match the configured identity providers. Use the For example, If this property is not specified, all the valid and enabled identity providers are made available. |
|
Maximum number of login attempts before 24-hour block on user IP address. The default value is set to 5. |
|
Controls the enforcement of the maximum login attempts policy. By default, this property is enabled ( |
Secrets management
Semarchy xDM comes with a default KMS for encrypting secrets, labeled Insecure. This KMS provides encryption capabilities at installation time using a default built-in key.
You can configure stronger encryption in your environments and provide secrets management configuration properties in the startup configuration. For more information, see Secrets managers.
Workflow management
Property (Environment variable) | Description | ||
---|---|---|---|
|
Cron expression to configure the workflow data and metadata purge schedule.
|