Migrating from Talend Dictionary Service 7.x installed with an embedded MongoDB

Migrating from Talend Dictionary Service 7.x installed with an embedded MongoDB - 8.0

Talend Migration and Upgrade Guide

Version

8.0

Language

English

Product

Talend Big Data

Talend Big Data Platform

Talend Data Fabric

Talend Data Integration

Talend Data Management Platform

Talend Data Services Platform

Talend ESB

Talend MDM Platform

Talend Real-Time Big Data Platform

Module

Talend Activity Monitoring Console

Talend Administration Center

Talend Artifact Repository

Talend CommandLine

Talend Data Preparation

Talend Data Stewardship

Talend ESB

Talend Identity and Access Management

Talend JobServer

Talend LogServer

Talend MDM Server

Talend MDM Web UI

Talend Runtime

Talend SAP RFC Server

Talend Studio

Content

Installation and Upgrade

Available in...

Big Data Platform

Data Fabric

Data Management Platform

Data Services Platform

MDM Platform

Real-Time Big Data Platform

Before you begin

You have downloaded Talend Dictionary Service 8.0.

Procedure

Stop your instance of the previous version of Talend Dictionary Service but keep MongoDB running.

Back up the MongoDB instance used for the previous version of Talend Dictionary Service using the following command:

mongodump -h
                        <source_mongodb_host>:<source_mongo_port> -d
                        <source_database> -u <source_mongodb_user> -p
                        <source_mongodb_password> -o <dump_output>

The default value for the embedded MongoDB properties are the following:

Property	Value
`mongodb.host`	`localhost`
`mongodb.port`	`27017`
`mongodb.database`	`dqdict`
`mongodb.user`	`dqdict-user`
`mongodb.password`	`duser`

Example

mongodump -h localhost:27017 -d dqdict -u dqdict-user -p duser -o dump\

Stop your MongoDB instance.
Install Talend Dictionary Service 8.0 with the embedded MongoDB, and do not start the instance.
For more information about the Talend Dictionary Service installation and configuration procedures, see the Talend Installation Guide.
If you have installed Talend Dictionary Service 8.0 in service mode, stop the instance, delete the database and stop MongoDB:
1. Open a mongo shell as Talend Dictionary Service database user and execute the following commands.
  For Linux:
```
cd <install_dir>/mongodb/bin
./mongo dqdict -u dqdict-user -p duser --port 27017
```
  For Windows:
```
<install_dir>\mongodb\bin>mongo dqdict -u dqdict-user -p duser --port 27017
```
2. Switch to Talend Dictionary Service database: use dqdict
3. Drop the database: db.runCommand( { dropDatabase: 1 } )
4. Exit mongo shell: exit
5. Stop MongoDB.
Open the previous version of the <Tomcat>/conf/data-quality.properties file and the new version.

In the new version of the data-quality.properties file, replace the following parameter names with the new names:

Previous parameter name	New parameter name
dq.mongo.host	spring.data.mongodb.host
dq.mongo.port	spring.data.mongodb.port
dq.mongo.username	spring.data.mongodb.username
dq.mongo.password	spring.data.mongodb.password
dq.mongo.database.name	spring.data.mongodb.database
dq.mongo.ssl.enabled	spring.data.mongodb.ssl
dq.mongo.ssl.trust-store	spring.data.mongodb.ssl.trust-store
dq.mongo.ssl.trust-store-password	spring.data.mongodb.ssl.trust-store-password

If you have performed any custom configuration to the previous version of the data-quality.properties file, update the 8.0 version of the file by coping the values from the old configuration file.
Start MongoDB of the 8.0 version.
Restore the backup performed on the MongoDB of the previous version of Talend Dictionary Service, on the 8.0.x MongoDB instance using the following command: mongorestore -h <source_mongodb_host>:<source_mongo_port> -d <source_database> -u <source_mongodb_user> -p <source_mongodb_password> dump\
Example
```
mongorestore -h localhost:27017 -d dqdict -u dqdict-user -p duser dump\          
```
Start Talend Dictionary Service 8.0 by launching, in this order:
- Apache ZooKeeper
- Apache Kafka
- Apache Tomcat (Talend Administration Center server and Talend Identity and Access Management server)
- MongoDB
- MinIO

Results

You are now ready to use Talend Dictionary Service 8.0.