Skip to main content Skip to complementary content
Close announcements banner

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

Before you begin

You have downloaded Talend Dictionary Service 7.3.x.

Procedure

  1. Stop your instance of the previous version of Talend Dictionary Service but keep MongoDB running.
  2. 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\         
  3. Stop your MongoDB instance.
  4. Install Talend Dictionary Service 7.3.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.
  5. If you have installed Talend Dictionary Service 7.3.x 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.
  6. 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.
  7. Start MongoDB of the 7.3.x version.
  8. Restore the backup performed on the MongoDB of the previous version of Talend Dictionary Service, on the 7.3.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\          
  9. 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

Results

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

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – let us know how we can improve!