If you can't find the product or version you're looking for, visit support.ataccama.com/downloads

MDM 15.1.0 Upgrade Notes

Database hints changes for PostgreSQL

Applies only to PostgreSQL database users. If you use database hints (see Database Hints), you need to make the following changes to the configuration file (for example, vldb-commands.xml):

Remove the inlistBeforeCommand element.
Remove l.id_list = ? from the template element.

These elements are no longer supported.

Authoring behavior issue fixed

Applies only to Migration Authored Master Records plan. After upgrading, make sure that all entities in the plan have authoring enabled.

contributedConfig.xml file

Applies to cloud deployments.

Make sure that you have the contributedConfig.xml file in the runtime folder.

Data Sources configuration

The MDM data sources are now defined in different files depending on whether they are infrastructural or project-specific. See Data Sources Connection for details.

We recommend defining your data sources in the following way:

Define the following infrastructural data sources in MDM Server application.properties (for more information, see MDM Server Application Properties, section Data source configuration):
- mdc_db
- eh_db
- log_db
- it_db
- mda_cache
- esb_db
- external
Define project-specific data sources depending on your deployment model:
- For self-managed deployments, use mdm.runtimeConfig.
- For cloud deployments, use runtime/datasources.xml.

Runtime properties changes

Applies to self-managed deployments.

New MDM Server application properties were added.

After the upgrade:

Configure the ataccama.one.mdm.config.config-folder property. See MDM Server Application Properties, section MDM solution configuration.
Make sure the default ataccama.one.mdm.config.runtime-folder value corresponds to the actual runtime folder location. For more information, see MDM Server Application Properties, section MDM solution configuration.
Make sure the runtime.properties file is located in one of these folders:
- etc folder in the ataccama.one.mdm.config.config-folder (recommended)
- ataccama.one.mdm.config.runtime-folder

The Java option -Druntime.properties=… previously used to specify the location of the runtime.properties file is no longer supported.

Health check changes

After the upgrade, make sure that the ataccama.authentication.keycloak.admin.enable MDM Web App application property is set to 'true' or not defined. Otherwise, the MDM Web App will fail to start.

Configuration changelog

This section provides the information about the changes in the configuration files that need to be taken into account when upgrading the solution. In certain cases, the newly introduced default is used or some configuration is required.

The following table lists the configuration files that were added, changed, or removed.

Added files Changed files Removed files

Added files	Changed files	Removed files
`contributedConfig.xml` - applies to cloud deployments	MDM Server `application.properties` MDM Web App `application.properties` `runtime.properties` - location change, see Runtime properties changes `mdm.runtimeConfig`	/

contributedConfig.xml - applies to cloud deployments

MDM Server application.properties
MDM Web App application.properties
runtime.properties - location change, see Runtime properties changes
mdm.runtimeConfig

The following table lists the changes in the files: added, changed, and removed properties.

Configuration file Added properties Changed properties Removed properties

Configuration file	Added properties	Changed properties	Removed properties
MDM Server application.properties	Git operations (to learn more, see MDM Server Application Properties, section Git operations): `ataccama.one.mdm.server.git.enabled` `ataccama.one.mdm.server.git.repository` `ataccama.one.mdm.server.git.protocol` `ataccama.one.mdm.server.git.branch` `ataccama.one.mdm.server.git.tag` `ataccama.one.mdm.server.git.destination` `ataccama.one.mdm.server.git.timeout` `ataccama.one.mdm.server.git.sshKey` `ataccama.one.mdm.performance.datasource` `ataccama.one.mdm.server.git.username` `ataccama.one.mdm.server.git.password` Runtime properties changes - applies to self-managed deployment `ataccama.one.mdm.config.config-folder` - the default value is `.`, needs to be adjusted, see MDM Server Application Properties, section MDM solution configuration. `ataccama.one.mdm.config.runtime-folder` - the default value is `${ataccama.one.mdm.config.config-folder}/../runtime`, see MDM Server Application Properties, section MDM solution configuration.	These data sources should be defined here: `mdc_db` `eh_db` `log_db` `it_db` `mda_cache` `esb_db` `external` For more information, see MDM Server Application Properties, section Data source configuration.	`ataccama.one.mdm.db.logging.enabled`
MDM Web App application.properties	`ataccama.one.mda.features.git.operations.enabled`- the default value is `false`, for more information, see MDM Web App Application Properties, section MDM features.	`ataccama.authentication.keycloak.admin.enable` - the value needs to be set to `true` or not defined, see MDM Web App Application Properties, section Keycloak.	/
mdm.runtimeConfig	/	Applies to self-managed deployments: project-specific data sources should be defined here. For more information, see MDM Server Application Properties, section Data source configuration.	/

MDM Server application.properties

Git operations (to learn more, see MDM Server Application Properties, section Git operations):
- ataccama.one.mdm.server.git.enabled
- ataccama.one.mdm.server.git.repository
- ataccama.one.mdm.server.git.protocol
- ataccama.one.mdm.server.git.branch
- ataccama.one.mdm.server.git.tag
- ataccama.one.mdm.server.git.destination
- ataccama.one.mdm.server.git.timeout
- ataccama.one.mdm.server.git.sshKey
- ataccama.one.mdm.performance.datasource
- ataccama.one.mdm.server.git.username
- ataccama.one.mdm.server.git.password
Runtime properties changes - applies to self-managed deployment
- ataccama.one.mdm.config.config-folder - the default value is ., needs to be adjusted, see MDM Server Application Properties, section MDM solution configuration.
- ataccama.one.mdm.config.runtime-folder - the default value is ${ataccama.one.mdm.config.config-folder}/../runtime, see MDM Server Application Properties, section MDM solution configuration.

These data sources should be defined here:

mdc_db
eh_db
log_db
it_db
mda_cache
esb_db
external

For more information, see MDM Server Application Properties, section Data source configuration.

ataccama.one.mdm.db.logging.enabled

MDM Web App application.properties

ataccama.one.mda.features.git.operations.enabled- the default value is false, for more information, see MDM Web App Application Properties, section MDM features.

ataccama.authentication.keycloak.admin.enable - the value needs to be set to true or not defined, see MDM Web App Application Properties, section Keycloak.

mdm.runtimeConfig

Applies to self-managed deployments: project-specific data sources should be defined here. For more information, see MDM Server Application Properties, section Data source configuration.

Was this page useful?