Migrating to Talend Data Stewardship 8.0.x R2022-07 or later with an embedded 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 Talend Dictionary Service to version 8.0.x R2022-07 or later.

Download the hybrid Talend Data Stewardship 8.0 archive from Talend Cloud's Downloads page.

Procedure

Stop your current Talend Data Stewardship instance but keep MongoDB running.

Back up the MongoDB instance used for the previous version of Talend Data Stewardship using the following command:

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

The default value for the embedded MongoDB properties are the following:

Property	Value
mongodb.host	localhost
mongodb.port	27017
mongodb.database	tds
mongodb.user	tds-user
mongodb.password	duser

Stop the MongoDB instance from the previous version of Talend Data Stewardship.

Information noteNote: For Windows users, you must uninstall the current MongoDB before you install Talend Data Stewardship 8.0.
Install Talend Data Stewardship 8.0 and select the embedded MongoDB option. Do not start the instance.
If you have installed Talend Data Stewardship 8.0 in service mode, stop the MongoDB instance.
Delete the database
1. Open a mongo shell as a Talend Data Stewardship database user and execute the following commands:
```
cd <install_dir>/mongodb/bin 
./mongo tds -u tds-user -p duser --port 27017
```
2. Switch to the Talend Data Stewardship database: use tds
3. Drop the database: db.runCommand( { dropDatabase: 1 } )
4. Exit mongo shell: exit

Restore the MongoDB backup on the new 8.0 MongoDB instance by using the following command:

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

If you have customized the <Data_Stewardship_Path>/conf/data-stewardship.properties file in the previous version, you can copy the values from the old configuration file and add them to the new version. You can then change parameters needed for Talend Cloud and Talend Management Console, as explained in Configuring Talend Data Stewardship after installation.
Delete the <install_dir>/tds/apache-tomcat/data folder from your Talend Data Stewardship 8.0 installation.
Start Talend Data Stewardship 8.0.
Republish semantic types using Talend Dictionary Service API to migrate indexes to Lucene 8.

Results

You have migrated your data to Talend Dictionary Service 8.0. To configure Talend Dictionary Service, follow the instructions in Configuring Talend Data Stewardship.

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