Migrating from Talend Dictionary Service 6.x or 7.0.x installed with an external MongoDB

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

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>

Example

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

Stop your MongoDB instance.

Install MongoDB 3.4.2 and start it.

Talend Dictionary Service 7.3.x uses the 3.4.2 version of MongoDB.

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>

Example

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

Install Talend Dictionary Service 7.3.x 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 3.4.2.

For more information about the Talend Dictionary Service installation and configuration procedures, see the Talend Installation Guide.

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

Start Talend Dictionary Service 7.3.x by launching, in order:

Apache Zookeeper
Apache Kafka
Apache Tomcat (Talend Administration Center server and Talend Identity and Access Management server)
MongoDB

Optional: Import the following files into Talend Data Preparation or Talend Data Stewardship to perform the functional migration from a previous version of Talend Dictionary Service:

Previous Talend Dictionary Service version	File	Description
6.3.x	<install_dir>/database/functionalMigration/6.3/Phone_number.json	Create the PHONE compound semantic type, which groups FR_PHONE, US_PHONE, UK_PHONE and DE_PHONE semantic types
	<install_dir>/database/functionalMigration/6.3/North_American_state.json	Create the NA_STATE compound semantic type, which groups US_STATE and CA_PROVINCE_TERRITORY semantic types
	<install_dir>/database/functionalMigration/6.3/North_American_state_code.json	Create the NA_STATE_CODE compound semantic type, which groups the US_STATE_CODE and CA_PROVINCE_TERRITORY_CODE semantic types
	<install_dir>/database/functionalMigration/6.3/UK_Phone.json	Update the UK_PHONE semantic type
6.4.x	<install_dir>/database/functionalMigration/6.4/UK_Phone.json	Update the UK_PHONE semantic type

There are no functional migration steps for 6.5.x and 7.0.x. The migration is automated for these versions.

Migrating from Talend Dictionary Service 6.x or 7.0.x installed with an external MongoDB - 7.3

Talend Data Fabric Migration and Upgrade Guide

Before you begin

Procedure

Example

Example

Results