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

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 before migrating Talend Data Stewardship. See Migrating to Talend Dictionary Service 8.0.x
Download Talend Data Stewardship 8.0.1 R2025-02.
Upgrade Talend Administration Center. For more information, see Upgrading Talend Administration Center.

Procedure

Stop your instance of the previous version of Talend Data Stewardship but keep MongoDB running.
Copy install_folder/tds/config/data-stewardship.properties to a secure location.

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.

After backing up the MongoDB, stop the instance.
Uninstall the previous version of Talend Data Stewardship.
Ensure that the embedded MongoDB instance is uninstalled.
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.
Add MongoDB to the PATH environment variable.
Start your external MongoDB instance.
For more information, see MongoDB documentation.
From a MongoDB shell, create the Talend Data Stewardship database in MongoDB using the following command:
```
use tds
```
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"}]})
```

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

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.
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

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 before migrating Talend Data Stewardship. See Migrating to Talend Dictionary Service 8.0.x
Download Talend Data Stewardship 8.0.1 R2025-02.
Upgrade Talend Administration Center. For more information, see Upgrading Talend Administration Center.

Procedure

Stop your instance of the previous version of Talend Data Stewardship.
Copy install_folder/tds/config/data-stewardship.properties to a secure location.

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

Uninstall the previous version of Talend Data Stewardship.
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.
Start Talend Data Stewardship version 8.0.1 R2025-02.
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!

Leave your feedback here