IBM Operational Decision Manager parameters

Configuration parameters are used to install Operational Decision Manager for production on Red Hat OpenShift.

Operational Decision Manager for production parameters

The ODM configuration parameters are optional in a custom resource file that includes the decisions pattern. 

shared_configuration:
    sc_deployment_patterns: decisions

If a parameter is absent or has no value, then it means that the operator and decisions pattern refer to the default value. You can overwrite the default value by entering a new value in your custom resource. The data source parameters that are mandatory or "Required" must always be present and you must enter a valid value.

Note: Memory and CPU example values correspond to the small deployment profile. For more information about the available profiles, see System requirements.
Table 1. Data source configuration parameters (datasource_configuration)
Parameters Description Default/Example values Required
dc_odm_datasource.dc_database_type Parameters that locate a Db2®, PostgreSQL, SQLserver, or Oracle database and the credentials to connect to it. db2 Yes
dc_odm_datasource.database_servername The server name must be an accessible address, such as an IP, hostname, or Kubernetes service name. db2forodm Yes
dc_odm_datasource.dc_common_database_port   50000 Yes
dc_odm_datasource.dc_common_database_name No default values. The valid values for the database type are: db2, sqlserver, postgresql, and oracle. db2db Yes
dc_odm_datasource.dc_common_database_instance_secret   SecretName Yes
dc_odm_datasource.dc_common_database_url The URL of the external database (currently only with Oracle) that is used for ODM. If defined, it is used in replacement of databaseName/port/serverName

Example: "jdbc:oracle:thin:@serverName:port:databaseName"

 empty No
dc_odm_datasource.dc_common_ssl_enabled To secure the database connection by using SSL. The default is true. true No
dc_odm_datasource.dc_ssl_secret_name If SSL is used to secure the database connection, specify the name of the SSL secret. myDcSslSecret Yes, if SSL is enabled.

dc_odm_decisioncenter_datasource.database_type

Provide the database type from your infrastructure.

 The possible values are "db2" / "postgres" / "sqlserver" / "oracle". Yes
dc_odm_decisioncenter_datasource.database_servername Provide the database server name or IP address of the database server.   Yes
dc_odm_decisioncenter_datasource.database_port Provide the database server port. For Db2, the default is "50000". For Oracle, the default is "1521". Yes
dc_odm_decisioncenter_datasource.database_name Provide the name of the database for ODM. For example: "ODMDB" Yes
dc_odm_decisioncenter_datasource.database_instance_secret The name of the secret that contains the credentials to connect to the database.   Yes
dc_odm_decisioncenter_datasource.database_url The URL of the Decision Center external database (currently only with Oracle) that is used for ODM. If defined, it is used in replacement of databaseName/port/serverName

Example: "jdbc:oracle:thin:@serverName:port:databaseName"

 empty No
dc_odm_decisioncenter_datasource.ssl_enabled Set to true when the database is using SSL. true  
dc_odm_decisioncenter_datasource.ssl_secret_name If SSL is used to secure the database connection, specify the name of the SSL secret.   Yes
dc_odm_decisionserver_datasource.database_type Provide the database type from your infrastructure. The possible values are "db2" / "postgres" / "sqlserver" / "oracle". Yes
dc_odm_decisionserver_datasource.database_servername Provide the database server name or IP address of the database server.   Yes
dc_odm_decisionserver_datasource.database_port Provide the database server port. For Db2, the default is "50000". For Oracle, the default is "1521" Yes
dc_odm_decisionserver_datasource.database_name Provide the name of the database for ODM. For example: "ODMDB" Yes
dc_odm_decisionserver_datasource.database_instance_secret The name of the secret that contains the credentials to connect to the database.   Yes
dc_odm_decisionserver_datasource.database_url The URL of the Decision Server external database (currently only with Oracle) that is used for ODM. If defined, it is used in replacement of databaseName/port/serverName

Example: "jdbc:oracle:thin:@serverName:port:databaseName"

 empty No
dc_odm_decisionserver_datasource.ssl_enabled Set to true when the database is using SSL. true  
dc_odm_decisionserver_datasource.ssl_secret_name If SSL is used to secure the database connection, specify the name of the SSL secret.   Yes
Table 2. Optional ODM configuration parameters (odm_configuration)
Parameters Description Default/Example values
customization.authSecretRef Customize user authentication and management by overriding the default basic registry or by using an LDAP connection. You must create a secret and enter the name of the secret in this field. myAuthSecretRef
customization.bai_kafka_topic Specify the name of the Kafka topic to which Operational Decision Manager sends events. For more information, see Event processing walkthrough. icp4ba-bai-odm-ingress
customization.labels Provide custom labels for all Operational Decision Manager Kubernetes resources. The values must meet the Kubernetes labels requirements. For more information, see this documentation.

To remove a label, you must set it to null.

 {}

Example:

customization: 
  labels: 
    key: value
    isSomething: "true"
customization.nodeAffinity Specify the node selector term match expression list to manage node affinity. 

odm_configuration:
  customization:
    nodeAffinity:
    - key: topology.kubernetes.io/zone
      operator: In
      values:
        - eu-west-3b
customization.trusted_certificate_list Specify a list of secrets that encapsulate certificates in PEM format to be included in the truststore. This list of certificates is merged with the Cloud Pak certificate list that is defined by the shared configuration trusted_certificate_list parameter. For more information, see Shared configuration. [mycompany-secret, service1-secret, service2-secret]
debug When the value is set to true, the parameter activates a trace for Operational Decision Manager in the operator pod. The parameter is directly under the odm_configuration heading in the custom resource YAML file. false

decisionCenter.autoscaling.enabled

decisionCenter.autoscaling.minReplicas

decisionCenter.autoscaling.maxReplicas

decisionCenter.autoscaling.targetAverageUtilization

Enable and configure autoscaling for Decision Center.

For more information, see Autoscaling.

false

2

3

75
decisionCenter.customlibPvc Specify the name of the persistent volume claim (PVC) that locates the customized Decision Center JAR files. myDcLibPvc
decisionCenter.disableAllAuthenticatedUser By default, all authenticated users have the rtsUsers role. To restrict the rtsUsers role, set this parameter to true. false
decisionCenter.enabled To enable Decision Center. true
decisionCenter.jvmOptionsRef Specify the name of the ConfigMap that has the defined JVM options. If left empty, the default JVM options are used. myDcJvmConfigMap
decisionCenter.labels Provide custom labels for the Decision Center Kubernetes resources. The values must meet the Kubernetes labels requirements. For more information, see this documentation.

To remove a label, you must set it to null.

 {}

Example:

decisionCenter: 
  labels: 
    key: value
    isSomething: "true"
decisionCenter.loggingRef Specify the name of the ConfigMap that has the defined logging options. If left empty, the default logging options are used. myDcLogConfigMap
decisionCenter.nodeAffinity Specify the node selector term match expression list to manage node affinity. 

decisionCenter:
  nodeAffinity:
  - key: topology.kubernetes.io/zone
    operator: In
    values:
      - eu-west-3c
decisionCenter.persistenceLocale The persistence locale for Decision Center. The default value is en_US.

Possible values are: "ar_EG" (Arabic - Egypt), "zh_CN" (Chinese - China), "zh_TW" (Chinese - Taiwan) "nl_NL" (Netherlands), "en_GB" (English - United Kingdom), "en_US" (English - United States), "fr_FR" (French - France), "de_DE" (German - Germany), "iw_IL" (Hebrew - Israel), "it_IT" (Italian - Italy), "ja_JP" (Japanese - Japan) , "ko_KR" (Korean - Korea), "pl_PL" (Polish - Poland), "pt_BR" (Portuguese - Brazil), "ru_RU" (Russian - Russia), "es_ES" (Spanish - Spain).

 en_US
decisionCenter.replicaCount The number of Decision Center pods.

The default value is set to 1. For high availability, use a value of 2 so a backup pod is ready to immediately take over if a failure occurs.

This parameter is ignored if decisionCenter.autoscaling.enabled is set to true.

 1

decisionCenter.resources.limits.cpu

decisionCenter.resources.limits.memory

decisionCenter.resources.requests.cpu

decisionCenter.resources.requests.memory

decisionCenter.resources.limits.ephemeral-storage

decisionCenter.resources.requests.ephemeral-storage

The CPU/Memory/Ephemeral Storage resource requests/limits for Decision Center.

For more information, see Managing Resources for Containers.

2

4096Mi

500m

1500Mi

2G

1G
decisionCenter.tagOrDigest Set a specific image tag or digest. For example, setting the value to 22.0.2-IF001 helps to identify the image that is used is for the first interim fix. A sha256:<digestValue> can be used to pull an interim fix.

If left empty, the digest corresponding to the operator is used. For more information, see Digests versus image tags.

 22.0.2

Valid version numbers can be found and copied from the custom resource pattern templates.
decisionCenter.webConfigRef Specify the name of the configMap that customizes the context-param properties in the web.xml file. If left empty, the default context-param properties are used. empty

decisionRunner.autoscaling.enabled

decisionRunner.autoscaling.minReplicas

decisionRunner.autoscaling.maxReplicas

decisionRunner.autoscaling.targetAverageUtilization

Enable and configure autoscaling for Decision Runner.

For more information, see Autoscaling

false

2

3

75
decisionRunner.enabled To enable Decision Runner. true
decisionRunner.jvmOptionsRef Specify the name of the ConfigMap that has the defined JVM options. If left empty, the default JVM options are used. myDrJvmConfigMap
decisionRunner.labels Provide custom labels for the Decision Runner Kubernetes resources. The values must meet the Kubernetes labels requirements. For more information, see this documentation.

To remove a label, you must set it to null.

 {}

Example:

decisionRunner: 
  labels: 
    key: value
    isSomething: "true"
decisionRunner.loggingRef Specify the name of the ConfigMap that has the defined logging options. If left empty, the default logging options are used. myDrLogConfigMap
decisionRunner.nodeAffinity Specify the node selector term match expression list to manage node affinity. 

decisionRunner:
  nodeAffinity:
  - key: topology.kubernetes.io/zone
    operator: In
    values:
      - eu-west-3c
decisionRunner.replicaCount

The number of Decision Runner pods.

The default value is set to 1. For high availability, use a value of 2 so that a backup pod is ready to immediately take over if a failure occurs.

This parameter is ignored if decisionRunner.autoscaling.enabled is set to true.

 1

decisionRunner.resources.limits.cpu

decisionRunner.resources.limits.memory

decisionRunner.resources.requests.cpu

decisionRunner.resources.requests.memory

decisionRunner.resources.limits.ephemeral-storage

decisionRunner.resources.requests.ephemeral-storage

The CPU/Memory/Ephemeral Storage resource requests/limits for Decision Runner.

For more information, see Managing Resources for Containers.

 2

4096Mi

500m

512Mi

200Mi

1G
decisionRunner.tagOrDigest Set a specific image tag or digest. For example, setting the value to 22.0.2-IF001 helps to identify the image that is used is for the first interim fix. A sha256:<digestValue> can be used to pull an interim fix.

If left empty, the digest corresponding to the operator is used. For more information, see Digests versus image tags.

 22.0.2

Valid version numbers can be found and copied from the custom resource pattern templates.
decisionServerConsole.description Specify a description for the Decision Server Console. If left empty, the default description is used. None
decisionServerConsole.jvmOptionsRef Specify the name of the ConfigMap that has the defined JVM options. If left empty, the default JVM options are used. myDscJvmConfigMap
decisionServerConsole.labels Provide custom labels for the Decision Server Console Kubernetes resources. The values must meet the Kubernetes labels requirements. For more information, see this documentation.

To remove a label, you must set it to null.

 {}

Example:

decisionServerConsole: 
  labels: 
    key: value
    isSomething: "true"
decisionServerConsole.loggingRef Specify the name of the ConfigMap that has the defined logging options. If left empty, the default logging options are used. myDscLogConfigMap
decisionServerConsole.nodeAffinity Specify the node selector term match expression list to manage node affinity. 

decisionServerConsole:
  nodeAffinity:
  - key: topology.kubernetes.io/zone
    operator: In
    values:
      - eu-west-3c

decisionServerConsole.resources.limits.cpu

decisionServerConsole.resources.limits.memory

decisionServerConsole.resources.requests.cpu

decisionServerConsole.resources.requests.memory

decisionServerConsole.resources.limits.ephemeral-storage

decisionServerConsole.resources.requests.ephemeral-storage

The CPU/Memory/Ephemeral Storage resource requests/limits for the Decision Server console.

For more information, see Managing Resources for Containers.

2

1024Mi

500m

512Mi

1G

200Mi
decisionServerConsole.title Specify the title name for the Decision Server Console web page. If left empty, the default title name is used. None
decisionServerConsole.tagOrDigest Set a specific image tag or digest. For example, setting the value to 22.0.2-IF001 helps to identify the image that is used is for the first interim fix. A sha256:<digestValue> can be used to pull an interim fix.

If left empty, the digest corresponding to the operator is used. For more information, see Digests versus image tags.

 22.0.2

Valid version numbers can be found and copied from the custom resource pattern templates.

decisionServerRuntime.autoscaling.enabled

decisionServerRuntime.autoscaling.minReplicas

decisionServerRuntime.autoscaling.maxReplicas

decisionServerRuntime.autoscaling.targetAverageUtilization

Enable and configure autoscaling for Decision Server Runtime.

For more information, see Autoscaling.

false

2

3

75
decisionServerRuntime.enabled To enable Decision Server Runtime. true
decisionServerRuntime.jvmOptionsRef Specify the name of the configmap that has the defined JVM options. If left empty, the default JVM options are used. myDsrJvmConfigMap
decisionServerRuntime.labels Provide custom labels for the Decision Server Runtime Kubernetes resources. The values must meet the Kubernetes labels requirements. For more information, see this documentation.

To remove a label, you must set it to null.

 {}

Example:

decisionServerRuntime: 
  labels: 
    key: value
    isSomething: "true"
decisionServerRuntime.loggingRef Specify the name of the configmap that has the defined logging options. If left empty, the default logging options are used. myDsrLogConfigMap
decisionServerRuntime.nodeAffinity Specify the node selector term match expression list to manage node affinity. 

decisionServerRuntime:
  nodeAffinity:
  - key: topology.kubernetes.io/zone
    operator: In
    values:
      - eu-west-3c
decisionServerRuntime.replicaCount The number of Decision Server Runtime pods.

The default value is set to 1. For high availability, use a value of 2 so a backup pod is ready to immediately take over if a failure occurs.

This parameter is ignored if decisionServerRuntime.autoscaling.enabled is set to true.

 1

decisionServerRuntime.resources.limits.cpu

decisionServerRuntime.resources.limits.memory

decisionServerRuntime.resources.requests.cpu

decisionServerRuntime.resources.requests.memory

decisionServerRuntime.resources.limits.ephemeral-storage

decisionServerRuntime.resources.requests.ephemeral-storage

The CPU/Memory/Ephemeral Storage resource requests/limits for Decision Server Runtime.

For more information, see Managing Resources for Containers.

2

4096Mi

500m

512Mi

1G

200Mi
decisionServerRuntime.tagOrDigest Set a specific image tag or digest. For example, setting the value to 22.0.2-IF001 helps to identify the image that is used is for the first interim fix. A sha256:<digestValue> can be used to pull an interim fix.

If left empty, the digest corresponding to the operator is used. For more information, see Digests versus image tags.

 22.0.2

Valid version numbers can be found and copied from the custom resource pattern templates.
decisionServerRuntime.webConfigRef Specify the name of the ConfigMap that contains the web.xml file with the customized context-param properties. If left empty, the default context-param properties are used. empty
decisionServerRuntime.xuConfigRef A ConfigMap with a name that corresponds to the type of configuration that you want to apply. myXuConfigMap
deployment_profile_size Specify a profile size for Operational Decision Manager if it is different from the Cloud Pak deployment profile size. Valid values are:
  • small
  • medium
  • large
 empty
externalCustomDatabase.datasourceRef The data source secret reference. my-customdatasource-secret
externalDatabase.driversUrl Specify the URL of the database driver. You can specify a list of URLs. empty
image.pullPolicy The image pull policy. For more information, see Image pull policy. IfNotPresent
image.repository If not specified, the value set in shared_configuration.sc_image_repository is used. When a private image registry is used, the value must be set to the URL for that location. myimageregistry.com/project_name
image.tag The image tag number. The default is the current version. 22.0.2

Valid version numbers can be found and copied from the custom resource pattern templates.

livenessProbe.failureThreshold

livenessProbe.initialDelaySeconds

livenessProbe.periodSeconds

livenessProbe.timeoutSeconds
The behavior of liveness probes to know when to restart a container.
failureThreshold
Specifies how many times the operator can try before it gives up when a pod starts and the probe fails. Giving up means restarting the pod.
initialDelaySeconds
Specifies the number of seconds after the container starts before the liveness probe is initiated.
periodSeconds
Specifies how often (in seconds) to start the probe.
timeoutSeconds
Specifies the number of seconds after which the liveness probe times out.

4

300

10

30

readinessProbe.failureThreshold

readinessProbe.initialDelaySeconds

readinessProbe.periodSeconds

readinessProbe.timeoutSeconds
The behavior of readiness probes to know when the containers are ready to start accepting traffic.
failureThreshold
Specifies how many times the operator can try before it gives up when a pod starts and the probe fails. Giving up means marking the pod as Unready.
initialDelaySeconds
Specifies the number of seconds after the container starts before readiness probe is initiated.
periodSeconds
Specifies how often (in seconds) to start the probe.
timeoutSeconds
Specifies the number of seconds after which the readiness probe times out.

45

5

5

5
show_scim_connection Enable SCIM datasource in Decision Center to import groups and users. false