Skip to main content Skip to complementary content

Migrating Talend Data Stewardship 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

Procedure

  1. Stop your instance of the previous version of Talend Data Stewardship but keep MongoDB running.
  2. Copy install_folder/tds/config/data-stewardship.properties to a secure location.
  3. Back up the Talend Data Stewardship database by running the following command:
    mongodump -h source_mongodb_host:source_mongo_port -u mongo_tds_username -p mongo_tds_password -d mongo_tds_database -o backup_location
    For more information, see the MongoDB documentation.
  4. After backing up the MongoDB, stop the instance.
  5. Uninstall the previous version of Talend Data Stewardship.
  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 Data Stewardship database in MongoDB using the following command:
    use tds
  11. Create the following user for the Talend Data Stewardship database in MongoDB:
    • Username: tds-user
    • Password: duser
    To do this, use the following command:
    db.createUser( { user: "tds-user", pwd: "duser", roles: [{ role: "readWrite", db: "tds"}]})
  12. Restore the MongoDB backup by running the following command:
    mongorestore -h mongo_host:mongo_port -u mongo_tds_username -p mongo_tds_password -d mongo_tds_database backup_location
  13. Install Talend Data Stewardship version 8.0.1 R2025-02.
    Ensure that you configure it with the same settings as the previous instance. If you have customized the install_folder/tds/config/data-stewardship.properties file, copy the values from the old configuration file to the new file.
  14. Start Talend Data Stewardship version 8.0.1 R2025-02.

Results

You have migrated your data to Talend Data Stewardship 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

Procedure

  1. Stop your instance of the previous version of Talend Data Stewardship.
  2. Copy install_folder/tds/config/data-stewardship.properties to a secure location.
  3. Optional: If needed, back up the Talend Data Stewardship database by running the following command.
    mongodump -h source_mongodb_host:source_mongo_port -u mongo_tds_username -p mongo_tds_password -d mongo_tds_database -o backup_location
  4. Uninstall the previous version of Talend Data Stewardship.
  5. Install Talend Data Stewardship version 8.0.1 R2025-02.
    • Ensure that you configure it with the same settings as the previous instance. If you have customized the install_folder/tds/config/data-stewardship.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 Data Stewardship version 8.0.1 R2025-02.
  7. Confirm that data is accessible from Talend Data Stewardship. If needed, you can restore the Talend Data Stewardship database by running the following command:
    mongorestore -h mongo_host:mongo_port -u mongo_tds_username -p mongo_tds_password -d mongo_tds_database backup_location

Results

You have migrated your data to Talend Data Stewardship 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!