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

MDM and RDM Connection

To use another Ataccama module as a data source, you first need to configure the connection between the module and the rest of the platform (specifically, Data Processing Module and Data Processing Engine) and provide the necessary JWT tokens that allow them to identify each other and communicate securely.

To use ONE Glossary in your MDM Web Application, the MDM data source must be defined here.

Prerequisites

Depending on your deployment type, the following configuration options might have already been set during deployment. In that case, use this section to troubleshoot configuration issues if MDM or RDM are not available as data sources in ONE.

MDM

Stop all MDM and ONE services.
In the DPM configuration file (/opt/ataccama/one/dpm/etc/application.properties), add or edit the property plugin.mdm-datasource.ataccama.one.server.grpc.port.

The port provided here must match the value specified in the MDM property ataccama.server.grpc.port. Make sure to update the default port number accordingly.
dpm/etc/application.properties
```
plugin.mdm-datasource.ataccama.one.server.grpc.port=8551
```

Provide the public DPM key to the MDM Server configuration file.

You can find the key in the Data Processing Engine (DPE) or Metadata Management Module (MMM) configuration files.

In the DPE configuration file (/opt/ataccama/dpe/etc/application.properties), find the following set of properties. The deployment (dpm) and key (key1) names are arbitrary and the values might differ in your instance.

dpe/etc/application.properties

ataccama.one.platform.deployments.dpm.uri=http://localhost:8031
ataccama.one.platform.deployments.dpm.name=DPM
ataccama.one.platform.deployments.dpm.module=dpm
ataccama.one.platform.deployments.dpm.environment=dev
ataccama.one.platform.deployments.dpm.security.jwt-keys.key1.name=DPM
ataccama.one.platform.deployments.dpm.security.jwt-keys.key1.fingerprint=OIIVv7h3InJdZ0UngDWk9yuwU2cANjdjN_5spoeY984
ataccama.one.platform.deployments.dpm.security.jwt-keys.key1.content=eyJrdHkiOiJFQyIsImNydiI6IlAtMjU2Iiwia2lkIjoiT0lJVnY3aDNJbkpkWjBVbmdEV2s5eXV3VTJjQU5qZGpOXzVzcG9lWTk4NCIsIngiOiJ6Mm5hRjFOUldPOGMzMHJLX09xVURNTHRwVFdpNEc4bVBYemhCWGRYUEY4IiwieSI6Ilh2bXFaWXFqQ0dxVzI0OTVFUmlUMU9YNDB4cUdOMVJ1akJVU0NsR1VRX28iLCJhbGciOiJFUzI1NiJ9
ataccama.one.platform.deployments.dpm.security.jwt-keys.key1.isRevoked=false
ataccama.one.platform.deployments.dpm.security.roles=IMPERSONATION

In case you prefer to generate new JWT keys instead of using the previously configured ones, you need to update them in all affected modules. For more information about how JWT keys are used and configured, see Generate JWT Keys.

Copy and paste the properties from the previous step to the MDM Server configuration file (/opt/ataccama/mdm-server/etc/application.properties).
Save your changes.

Restart MDM and ONE. Once the applications are running again, you can proceed with step [Create a connection].

RDM

Stop all RDM and ONE services.

Provide the public keys for Data Processing Module (DPM) and DPE to the RDM configuration file.

In the DPM configuration file (/opt/ataccama/dpm/etc/application.properties), find the following set of properties for the public DPE key. The deployment (dpe) and key (key) names are arbitrary and the values might differ in your instance.

dpm/etc/application.properties

ataccama.one.platform.deployments.dpe.uri=http://localhost:8034
ataccama.one.platform.deployments.dpe.name=DPE
ataccama.one.platform.deployments.dpe.module=dpe
ataccama.one.platform.deployments.dpe.environment=dev
ataccama.one.platform.deployments.dpe.security.jwt-keys.key.name=DPE
ataccama.one.platform.deployments.dpe.security.jwt-keys.key.fingerprint=OIIVv7h3InJdZ0UngDWk9yuwU2cANjdjN_5spoeY984
ataccama.one.platform.deployments.dpe.security.jwt-keys.key.content=eyJrdHkiOiJFQyIsImNydiI6IlAtMjU2Iiwia2lkIjoiT0lJVnY3aDNJbkpkWjBVbmdEV2s5eXV3VTJjQU5qZGpOXzVzcG9lWTk4NCIsIngiOiJ6Mm5hRjFOUldPOGMzMHJLX09xVURNTHRwVFdpNEc4bVBYemhCWGRYUEY4IiwieSI6Ilh2bXFaWXFqQ0dxVzI0OTVFUmlUMU9YNDB4cUdOMVJ1akJVU0NsR1VRX28iLCJhbGciOiJFUzI1NiJ9
ataccama.one.platform.deployments.dpe.security.jwt-keys.key.isRevoked=false
ataccama.one.platform.deployments.dpe.security.roles=IMPERSONATION

In the DPE configuration file (/opt/ataccama/dpe/etc/application.properties), find the following set of properties for the public DPM key. The deployment (dpm) and key (key1) names are arbitrary and the values might differ in your instance.

dpe/etc/application.properties

ataccama.one.platform.deployments.dpm.uri=http://localhost:8031
ataccama.one.platform.deployments.dpm.name=DPM
ataccama.one.platform.deployments.dpm.module=dpm
ataccama.one.platform.deployments.dpm.environment=dev
ataccama.one.platform.deployments.dpm.security.jwt-keys.key1.name=DPM
ataccama.one.platform.deployments.dpm.security.jwt-keys.key1.fingerprint=OIIVv7h3InJdZ0UngDWk9yuwU2cANjdjN_5spoeY984
ataccama.one.platform.deployments.dpm.security.jwt-keys.key1.content=eyJrdHkiOiJFQyIsImNydiI6IlAtMjU2Iiwia2lkIjoiT0lJVnY3aDNJbkpkWjBVbmdEV2s5eXV3VTJjQU5qZGpOXzVzcG9lWTk4NCIsIngiOiJ6Mm5hRjFOUldPOGMzMHJLX09xVURNTHRwVFdpNEc4bVBYemhCWGRYUEY4IiwieSI6Ilh2bXFaWXFqQ0dxVzI0OTVFUmlUMU9YNDB4cUdOMVJ1akJVU0NsR1VRX28iLCJhbGciOiJFUzI1NiJ9
ataccama.one.platform.deployments.dpm.security.jwt-keys.key1.isRevoked=false
ataccama.one.platform.deployments.dpm.security.roles=IMPERSONATION

Copy and paste the properties from the previous two steps to the RDM configuration file (/opt/ataccama/rdm/etc/application.properties).
Save your changes.

Restart RDM and ONE. Once the applications are running again, you can proceed with step Create a source.

Create a source

To connect to MDM or RDM:

Navigate to Knowledge Catalog > Sources.
Select Create.
Provide the following:
- Name: The source name.
- Description: A description of the source.
- Deployment (Optional): Choose the deployment type.
  
  You can add new values if needed. See Lists of Values.
- Stewardship: The source owner and roles. For more information, see Stewardship.

Add a connection

Select Add Connection.
In Select connection type, choose either:
- Ataccama Platform Integration > MDM
- Ataccama Platform Integration > RDM
Provide the following:
- Name: A meaningful name for your connection. This is used to indicate the location of catalog items.
- Description (Optional): A short description of the connection.
- URL: The URL where the application is running, for example, http://<host>:<port> or http://<host>:<port>.
  
  Make sure to use the internal URL, not the URL where you access the MDM server or RDM.
  
  For example, for cloud deployments, this is typically the application service name (by default: mdm-server-svc or rdm-svc) and the corresponding port (8051 or 8060 respectively), so the value for this property would be: http://mdm-server-svc:8051/ or http://rdm-svc:8060/.
  
  For on-premise deployments, the host is the internal URL of the server where the MDM server or RDM are running, which is different for each instance of ONE.
In Additional settings, select Allow exporting and loading of Data if you want to export data from this connection and use it in ONE Data or outside of ONE.

Consider the security and privacy risks of allowing the export of data to other locations.

Test the connection

To test and verify whether the data source connection has been correctly configured, select Test Connection.

If the connection is successful, continue with the following step. Otherwise, verify that your configuration is correct and that the data source is running.

Save and publish

Once you have configured your connection, save and publish your changes. If you provided all the required information, the connection is now available for other users in the application.

In case your configuration is missing required fields, you can view a list of detected errors instead. Review your configuration and resolve the issues before continuing.

Was this page useful?