Skip to main content Skip to complementary content

Migrating to Talend Data Stewardship 8.0.x 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.x.

Upgrade Talend Administration Center. For more information, see Upgrading Talend Administration Center.

Procedure

  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 more information, see the MongoDB documentation.
    After backing up the MongoDB, stop the instance.
  3. Install and start MongoDB 4.x.
    Talend Data Stewardship 8.0 supports MongoDB version 4.x and 3.6.
  4. Delete the database:
    1. Open a mongo shell as a Talend Data Stewardship database user and execute the following commands.
      For Linux:
      cd <install_dir>/mongodb/bin
./mongo tds -u tds-user -p duser --port 27017
      For Windows:
      <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
  5. 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 the previous version of Talend Data Stewardship, if you have customized the <Data_Stewardship_Path>/config/data-stewardship.properties file, you can copy the values from the old configuration file to the new file.
  6. Install Talend Data Stewardship 8.0 and select the external MongoDB option. Make sure to configure it with the same settings as the previous instance and link it to your Talend Administration Center.
    If you have installed Talend Data Stewardship 8.0 in service mode, stop the instance of MongoDB.
  7. Delete the <install_dir>/tds/data folder from your Talend Data Stewardship 8.0 installation.
  8. Start Talend Data Stewardship 8.0.
  9. Republish semantic types using Talend Dictionary Service API to migrate indexes to Lucene 8.
    For more information, see Republishing semantic types to Talend Data Stewardship and Talend Data Preparation through REST APIs.

Results

You are now ready to use Talend Data Stewardship 8.0.

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