ONE Desktop ONE DQ&C ONE MDM ONE RDM ONE Runtime Server
latest (16.0.0) 15.4.0 15.3.0 15.2.0 15.1.0 14.5.x 13.9.x 13.8.x 13.7.x 13.6.x 13.5.0 13.4.x 13.3.x 13.2.x
User Community Service Desk Downloads
If you can't find the product or version you're looking for, visit support.ataccama.com/downloads

MDM 16.0.0 Upgrade Notes

Automatic drafts to tasks migration functionality was removed. If you want to upgrade to version 16 from version 13, upgrade to version 15.4.x first.

Java 21 upgrade

Upgrade Java to version 21 on all servers running ONE components (this is typically app and mdm). See the following commands as a reference depending on your OS distribution.

RHEL 9
sudo bash -c 'cat <<EOF > /etc/yum.repos.d/adoptium.repo
[Adoptium]
name=Adoptium
baseurl=https://packages.adoptium.net/artifactory/rpm/centos/9/$(uname -m)
enabled=1
gpgcheck=1
gpgkey=https://packages.adoptium.net/artifactory/api/gpg/key/public
EOF'

sudo yum update ### Update if you haven't already
sudo yum install temurin-21-jdk

### Set the default (use keys to select Java 21)
sudo update-alternatives --config java
Ubuntu
### Add GPG key
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 3B04D753C9050D9A5D343F39843C48A565F8F04B

### Add APT repository
sudo add-apt-repository 'deb https://packages.adoptium.net/artifactory/deb focal main'

### Install temurin-21-jdk
sudo apt install temurin-21-jdk

### Set the default (use keys to select Java 21)
sudo update-alternatives --config java

MDM HTTP server configuration

The following MDM Server application properties used to configure the MDM HTTP server were removed:

  • ataccama.server.http.default.port

  • ataccama.server.http.{listener_name}.path.exclude

  • ataccama.server.http.{listener_name}.path.include

  • ataccama.server.http.{listener_name}.port

After the upgrade, remove these properties from the application.properties file (see MDM Server Application Properties).

These properties are replaced by standard Spring Boot properties, see the official Spring Boot documentation.

Name Default value Description

server.port

8051

The number of the default server port.

management.server.port

8056

The number of the management endpoint HTTP port.

Trailing slashes in API URLs

The default behavior for handling trailing slashes in API URLs has changed. Trailing slashes are now turned off by default, which means that API calls with URLs ending in a forward slash (/) will result in an error.

To enable trailing slashes, set the value of the ataccama.one.mdm.server.backward-compatibility.trailing-slashes and ataccama.one.mda.backward-compatibility.trailing-slashes application properties to true (see MDM Server Application Properties and web-application-reference:mdm:web-app-application-properties.adoc).

Starting from version 17, trailing slashes will no longer be supported. We recommend setting the value to false to ensure smooth upgrade to later versions.

External driver configuration

The ataccama.one.mdm.external.drivers.paths MDM Server application property was removed.

In Ataccama Cloud deployments, PropertiesLauncher properties are used by default (see the official Spring Boot documentation). The loader.path default value is /opt/ataccama/lib-ext,./lib-ext, to maintain the previous behavior. In self-managed deployments, these properties are currently not supported.

Custom JAR files added to the ./lib folder will be ignored.

In Ataccama Cloud deployments, after the upgrade, any custom Helm values referencing the removed property need to be reviewed and updated accordingly.

Migration to JDK_JAVA_OPTIONS

Applies only to MDM Ataccama Cloud deployments. The environment variable JAVA_OPTS has been replaced with JDK_JAVA_OPTIONS (see JDK 9 Release Notes).

REST API endpoint changes

The structure of the REST API endpoint for providing runtime parameters has changed.

Configuration changelog

This section provides 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

/

  • MDM Server application.properties

  • MDM Web App application.properties

  • nme-config.xml

  • runtime.parameters

  • server-manager.properties - the file is now located in the etc folder. If you have this file defined in the /opt/ataccama/manager folder, move it to etc.

/

The following sections list the changes in the files: added, changed, and removed properties.

MDM Server application.properties

Added properties

  • ataccama.one.mdm.nme.history.enabled - the default value is true, see MDM Server Application Properties, section History plugin configuration.

  • ataccama.one.mdm.server.backward-compatibility.trailing-slashes - the default value is false, see [Trailing slashes].

Changed properties

  • ataccama.one.mdm.nme.history.storage-directory - the new property name is ataccama.one.mdm.nme.history.event-persistence.storage-directory, see MDM Server Application Properties, section History plugin configuration.

  • ataccama.one.mdm.nme.history.persistence.class - the new property name is ataccama.one.mdm.nme.history.persistence.type, possible values are VLDB, DB, see MDM Server Application Properties, section History plugin configuration.

Removed properties

  • ataccama.one.mdm.external.drivers.paths

  • ataccama.server.http.default.port

  • ataccama.server.http.{listener_name}.path.exclude

  • ataccama.server.http.{listener_name}.path.include

  • ataccama.server.http.{listener_name}.port

MDM Web App application.properties

Added properties

  • ataccama.authentication.http.public-endpoints.public-pages.endpoint-filter - the default value is =/auth-error/**,/styles/**,/images/**, see MDM Web App Application Properties, section MDM Features.

  • ataccama.one.mda.backward-compatibility.trailing-slashes - the default value is false, see [Trailing slashes].

runtime.parameters

Removed properties

  • nme.tasks.migration.apply-automatically

Was this page useful?