Migrating from Talend Dictionary Service 6.3.x installed with an embedded MongoDB - 6.4

Talend Data Services Platform Migration Guide

Talend Data Services Platform
Installation and Upgrade
Talend Activity Monitoring Console
Talend Administration Center
Talend Artifact Repository
Talend CommandLine
Talend Data Preparation
Talend Data Stewardship
Talend DQ Portal
Talend ESB
Talend Identity Management
Talend Installer
Talend JobServer
Talend Log Server
Talend Project Audit
Talend Repository Manager
Talend Runtime
Talend SAP RFC Server
Talend Studio


The Talend Dictionary Service migration must be performed before attempting to migrate Talend Data Stewardship or Talend Data Preparation.

Before you begin:

  • You have downloaded Talend Dictionary Service 6.4.

  1. Install Talend Dictionary Service 6.4.x 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 6.4 in service mode, stop the instance and MongoDB and delete the database as follows:

    1. Open a mongo shell as Talend Dictionary Service database user and execute the following commands:

      cd <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:


  2. If you have performed any custom configuration to the 6.3 version of the <Tomcat>/conf/data-quality.properties file, update the 6.4 version of the file by coping the values from the old configuration file.

  3. Stop your instance of Talend Dictionary Service 6.3.x but keep MongoDB running.

  4. Back up the MongoDB instance used for Talend Dictionary Service 6.3.x.

    To backup your MongoDB, open a command prompt window and execute 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:

    Table 1. 


  5. Stop MongoDB of Talend Dictionary Service 6.3 and start MongoDB of the 6.4. version.

  6. Restore the backup performed on the 6.3.x MongoDB, on the 6.4.x MongoDB instance.

    To restore your MongoDB, open a command prompt window and execute the following command:

    mongorestore -h <source_mongodb_host>:<source_mongo_port> -d<source_database> -u <source_mongodb_user> -p <source_mongodb_password> dump\

  7. Recreate the MongoDB indexes by executing the following commands:

    cd ./<install_dir>/dq_dict/database


  8. Start Talend Dictionary Service 6.4.x.

  9. Go to the <pathToTheInstallationFolder>/dq_dict/database/functionalMigration folder and execute the functionalMigration.batfunctionalMigration.sh script.

    When prompted, enter the login name and the password for the dqdict MongoDB database user:

    • Login: dqdict-user

    • Password: duser

You are now ready to use Talend Dictionary Service 6.4.x.