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

Talend Migration and Upgrade Guide

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
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
Installation and Upgrade
Last publication date
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.


  1. Stop your instance of the previous version of Talend Dictionary Service but keep MongoDB running.
  2. Backup your MongoDB, while it is still running, 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>


    mongodump -h localhost:27017 -d dqdict -u dqdict-user -p duser -o dump\
  3. Stop your MongoDB instance.
  4. Install MongoDB 4.4 and start it.
    Talend Dictionary Service 8.0 uses the 4.4 version of MongoDB.
  5. Restore MongoDB, open a command prompt window and execute the following command: <mongo_path>/bin/mongorestore -h <mongo_host>:<mongo_port> -u <mongo_dq_username> -p <mongo_dq_password> -d <mongo_dq_database> <backup_location>


    mongorestore -h localhost:27017 -d dqdict -u dqdict-user -p duser dump\       
  6. Install Talend Dictionary Service 8.0 with the external MongoDB, and configure it with the same settings as your instance of the previous version of Talend Dictionary Service, especially the links to your Talend Administration Center and point to MongoDB 4.4.
    For more information about the Talend Dictionary Service installation and configuration procedures, see Installing and configuring Talend Dictionary Service.
  7. Open the previous version of the <Tomcat>/conf/data-quality.properties file and the new version.
  8. 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
  9. 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.
  10. 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


You are now ready to use Talend Dictionary Service 8.0.