Migrating from Talend Data Preparation 1.x/2.x installed with an external MongoDB - 7.0

Talend Data Fabric Migration and Upgrade Guide

English (United States)
Talend Data Fabric
Talend Activity Monitoring Console
Talend Administration Center
Talend Artifact Repository
Talend CommandLine
Talend Data Preparation
Talend Data Stewardship
Talend DQ Portal
Talend ESB
Talend Identity and Access Management
Talend JobServer
Talend Log Server
Talend MDM Server
Talend MDM Web UI
Talend Repository Manager
Talend Runtime
Talend SAP RFC Server
Talend Studio
Installation and Upgrade

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 Preparation. See Migrating to Talend Dictionary Service 7.0.x.

You have downloaded Talend Data Preparation 2.5.


  1. Stop your instance of Talend Data Preparation 1.x/2.x but keep MongoDB running.
  2. Backup your MongoDB, while it is still running, using the following command: mongodump -h <source_mongodb_host>:<source_mongo_port> -d <source_database> -u <source_mongodb_user> -p <source_mongodb_password> -o <dump_output>
    For more information; see the MongoDB documentation.
  3. Stop your MongoDB instance.
  4. Install MongoDB 3.4.2 and start it.
    Talend Data Preparation 2.5 uses the 3.4.2 version of MongoDB.
  5. Install Talend Data Preparation 2.5 with the external MongoDB, and configure it with the same settings as your 1.x/2.x instance, especially the links to your Talend Administration Center and point to MongoDB 3.4.2.
    For more information about the Talend Data Preparation installation and configuration procedures, see Installing and configuring Talend Data Preparation.
  6. If you have performed any custom configuration to the 1.x/2.x version of the <Data_Stewardship_Path>/conf/data-stewardship.properties file, update the 2.5 version of the file by coping the values from the old configuration file.
  7. To retrieve the content of the dataset storage folder used for Talend Data Preparation 1.x/2.x, and migrate it to version 2.5, complete the next step according to the your situation:
    • If you have never modified the value of the dataset.content.store.file.location property, copy the content of the <Data_Preparation_Path>/data/store/datasets/content folder used in 1.x/2.x, and paste it in the 2.5 installation folder, following the same path.
    • If you have set a custom value for the dataset.content.store.file.location property, make sure that you set the same value in the application.properties file for the 2.5 version.
  8. Start Talend Data Preparation 2.5.
  9. Stop Talend Data Preparation 2.5.
    These two steps are necessary for the migration process to work.
  10. Start the MongoDB instance of Talend Data Preparation.
  11. Drop the database of the Talend Data Preparation 2.5 MongoDB:
    1. Open a mongo shell as Talend Data Preparation database user and execute the following commands:
      cd <install_dir>/mongodb/bin
      ./mongo dataprep -u dataprep-user -p dprep --port 27017
    2. Switch to Talend Data Preparation database: use dataprep
    3. Drop the database: db.runCommand( { dropDatabase: 1 } )
    4. Exit mongo shell: exit
  12. Restore the backup performed on the 1.x/2.x MongoDB, on the 2.5 MongoDB instance using the following command: mongo_path>/bin/mongorestore -h <mongo_host>:<mongo_port> -u <mongo_tdp_username> -p <mongo_tdp_password> -d <mongo_tdp_database> <backup_location>
  13. Start Talend Data Preparation 2.5.


You are now ready to use Talend Data Preparation 2.5.