Migrating MongoDB for Talend Data Preparation - 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

Follow this procedure to upgrade MongoDB 4.4 to MongoDB 5 or 7 and migrate data for Talend Data Preparation. For more information about the compatible versions, see Compatible databases.

Before you begin

  • If you have installed and used Talend Dictionary Service to create custom semantic types or update the predefined ones, you must migrate Talend Dictionary Service MongoDB before migrating Talend Data Preparation MongoDB. For more information, see Migrating MongoDB for Talend Dictionary Service.


  1. Stop your instance of the previous version of Talend Data Preparation and Talend Component Server but keep MongoDB running.
  2. Open the command prompt.
  3. Back up your MongoDB Talend Data Preparation data by running the following command.
    For Linux:
    <mongo_path>/bin ./mongodump -h <source_mongodb_host>:<source_mongo_port> -u <mongo_tdp_username> -p <mongo_tdp_password> -d <mongo_tdp_database> -o <tdp_backup_location>
    For Windows:
    <mongo_path>/bin>mongodump -h <source_mongodb_host>:<source_mongo_port> -u <mongo_tdp_username> -p <mongo_tdp_password> -d <mongo_tdp_database> -o <tdp_backup_location>

    For example: mongodump -h localhost:27017 -u tdpuser -p tdp -d tdp -o dump\

  4. Copy the /data folder and paste it in another repository as a back up. You should not modify this folder.
  5. Stop the MongoDB instance.
  6. Uninstall MongoDB 4.4.
  7. Install MongoDB 5 or 7. For more information about the MongoDB installation, see the MongoDB documentation.
  8. Start the new MongoDB version.
  9. Restore the MongoDB backup by running the following commands.

    For Linux:

    <mongo_path>/bin ./mongorestore -h <mongo_host>:<mongo_port> -u <mongo_tdp_username> -p <mongo_tdp_password> -d <mongo_tdp_database> <tdp_backup_location>

    For Windows:

    <mongo_path>/bin>mongorestore -h <mongo_host>:<mongo_port> -u <mongo_tdp_username> -p <mongo_tdp_password> -d <mongo_tdp_database> <tdp_backup_location>

    For example: ./mongorestore -h localhost:27017 -u tdpuser -p tdp -d tdp -o dump\

  10. Verify the /data folder. If you moved it, you need to restore it.
  11. Start Talend Data Preparation and Talend Component Server.