Skip to main content Skip to complementary content
Qlik Resources
Loading SearchUnify's search If you need assistance with your product, please contact Qlik Support.
Qlik Customer Portal
Loading SearchUnify's search If you need assistance with your product, please contact Qlik Support.
Qlik Customer Portal

Migrating Talend Dictionary Service to 8.0.1 R2025-02 or later

Starting with 8.0.1 R2024-05, the embedded MongoDB is no longer provided. The first section describes migration from installations with embedded MongoDB (8.0.1 R2023-10 or before) to a new installation with external MongoDB. The second section applies to installations already using external MongoDB.

Migrating from 8.0.1 R2023-10 or before (with an embedded MongoDB) to 8.0.1 R2025-02 or later

Before you begin

You have downloaded Talend Dictionary Service 8.0.1 R2025-02.

Procedure

  1. Stop your instance of the previous version of Talend Dictionary Service but keep MongoDB running.
  2. Copy <Tomcat>/conf/data-quality.properties to a secure location.
  3. Back up the Talend Dictionary Service database by running the following command: 
    mongodump -h <mongodb.host>:<mongodb.port> -d <mongodb.database> -u
<mongodb.user> -p <mongodb.password> -o <dump_output>
    For more information, see the MongoDB documentation.
    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\
  4. After backing up the MongoDB, stop the instance.
  5. Uninstall the previous version of Talend Dictionary Service.
  6. Ensure that the embedded MongoDB instance is uninstalled.
  7. Download a MongoDB instance from the MongoDB download page and install it.
    • For more information about installing MongoDB, see MongoDB documentation.
    • For more information on the supported MongoDB databases, see Compatible databases.
    • To secure connections with MongoDB using SSL, manually install MongoDB Enterprise Server on your machine. For more information, see MongoDB security page.
  8. Add MongoDB to the PATH environment variable.
  9. Start your external MongoDB instance.
    For more information, see MongoDB documentation.
  10. From a MongoDB shell, create the Talend Dictionary Service database in MongoDB using the following command: 
    use dqdict
  11. Create the following user for the Talend Dictionary Service database in MongoDB:
    • Username: dqdict-user
    • Password: duser
    To do this, use the following command:
    db.createUser( { user: "dqdict-user", pwd: "duser", roles: [{ role: "readWrite", db: "dqdict"}]})
  12. Restore the MongoDB backup by running the following command: 
    mongorestore -h mongodb.host:mongodb.port \
-u mongodb.user \
-p mongodb.password \
-d mongodb.database \
backup_location
  13. Install Talend Dictionary Service version 8.0.1 R2025-02.
    Ensure that you configure it with the same settings as the previous instance. If you have customized the <Tomcat>/conf/data-quality.properties file, copy the values from the old configuration file to the new file.
  14. Start Talend Dictionary Service version 8.0.1 R2025-02.

Results

You have migrated your data to Talend Dictionary Service 8.0.1 R2025-02.

Migrating from 8.0.1 R2024-05 to 8.0.1 R2025-02 or later with an external MongoDB

Before you begin

You have downloaded Talend Dictionary Service 8.0.1 R2025-02.

Procedure

  1. Stop your instance of the previous version of Talend Dictionary Service.
  2. Copy <Tomcat>/conf/data-quality.properties to a secure location.
  3. Optional: If needed, back up the Talend Dictionary Service database by running the following command. 
    mongodump -h <mongodb.host>:<mongodb.port> -d <mongodb.database> -u
<mongodb.user> -p <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\
  4. Uninstall the previous version of Talend Dictionary Service.
  5. Install Talend Dictionary Service version 8.0.1 R2025-02.
    • Ensure that you configure it with the same settings as the previous instance. If you have customized the <Tomcat>/conf/data-quality.properties file, copy the values from the old configuration file to the new file.
    • Ensure that the parameters are correctly configured to connect to your external MongoDB.
  6. Start Talend Dictionary Service version 8.0.1 R2025-02.
  7. Confirm that data is accessible from Talend Dictionary Service. If needed, you can restore the Talend Dictionary Service database by running the following command: 
    mongorestore -h mongodb.host:mongodb.port \
-u mongodb.user \
-p mongodb.password \
-d mongodb.database \
backup_location

Results

You have migrated your data to Talend Dictionary Service 8.0.1 R2025-02.

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 – please let us know!

Leave your feedback here