Migrating MongoDB for Talend Data Stewardship - 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 Stewardship. 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 Stewardship MongoDB. For more information, see Migrating MongoDB for Talend Dictionary Service.


  1. Stop your instance of the previous version of Talend Data Stewardship but keep MongoDB running.
  2. Back up your MongoDB by running the following command.

    For Linux:

    <mongo_path>/bin ./mongodump -h <source_mongodb_host>:<source_mongo_port> -u <mongo_tds_username> -p <mongo_tds_password> -d <mongo_tds_database> -o <backup_location>

    For Windows:

    <mongo_path>/bin>mongodump -h <source_mongodb_host>:<source_mongo_port> -u <mongo_tds_username> -p <mongo_tds_password> -d <mongo_tds_database> -o <backup_location>

    For example: mongodump -h localhost:27017 -u tdsuser -p tds -d tds -o dump\

  3. Stop the MongoDB instance.
  4. Uninstall MongoDB 4.4.
  5. Install MongoDB 5 or 7. For more information about the MongoDB installation, see the MongoDB documentation.
  6. Start the new MongoDB version.
  7. Restore the MongoDB backup by running the following command.

    For Linux:

    <mongo_path>/bin ./mongorestore -h <mongo_host>:<mongo_port> -u <mongo_tds_username> -p <mongo_tds_password> -d <mongo_tds_database> <backup_location>  

    For Windows:

    <mongo_path>/bin>mongorestore -h <mongo_host>:<mongo_port> -u <mongo_tds_username> -p <mongo_tds_password> -d <mongo_tds_database> <backup_location>

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

  8. Start Talend Data Stewardship.