Before you begin
ⓘ
Available in:
Big Data Platform
Data Fabric
Data Management Platform
Data Services Platform
MDM Platform
Real-Time Big Data Platform
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 8.0.x.
Download Talend Data Preparation 8.0.x.
Upgrade Talend Administration Center. For more information, see Upgrading Talend Administration Center.
Procedure
- Stop your current Talend Data Preparation instance but keep the MongoDB instance running.
-
Back up your MongoDB by running the following command.
For Linux:
<mongo_path>/bin ./mongodump -h <source_mongodb_host>:<source_mongo_port> -d <source_database> -u <source_mongodb_user> -p <source_mongodb_password> -o <dump_output>For Windows:<mongo_path>\bin>mongodump -h <source_mongodb_host>:<source_mongo_port> -d <source_database> -u <source_mongodb_user> -p <source_mongodb_password> -o <dump_output>The default value for the embedded MongoDB properties are the following:Property Value mongodb.hostlocalhostmongodb.port27017mongodb.databasedataprepmongodb.userdataprep-usermongodb.passwordduser -
Stop the MongoDB instance from the previous version of Talend Data Preparation.
Note: For Windows users, you must uninstall the current MongoDB before you install Talend Data Preparation.
-
Install Talend Data Preparation and select the embedded MongoDB option. Do not start the
instance.
If you have installed Talend Data Preparation in service mode, stop the instance and MongoDB.
-
Delete the database:
-
Open a mongo shell as a Talend Data Preparation database user and execute the following commands.
For Linux:
For Windows:cd <install_dir>/mongodb/bin ./mongo dataprep -u dataprep-user -p duser --port 27017<install_dir>\mongodb\bin>mongo dataprep -u dataprep-user -p duser --port 27017 -
Switch to the Talend Data Preparation database:
use dataprep -
Drop the database:
db.runCommand( { dropDatabase: 1 } ) -
Exit mongo shell:
exit
-
Open a mongo shell as a Talend Data Preparation database user and execute the following commands.
-
Restore the MongoDB backup on the new 8.0 MongoDB instance by using the following
command.
For Linux:
For Windows:<mongo_path>/bin ./mongorestore -h <mongo_host>:<mongo_port> -u <mongo_tdp_username> -p <mongo_tdp_password> -d <mongo_tdp_database> <backup_location><mongo_path>\bin>mongorestore -h <mongo_host>:<mongo_port> -u <mongo_tdp_username> -p <mongo_tdp_password> -d <mongo_tdp_database> <backup_location> - If you customized the <Data_Preparation_Path>/config/application.properties file in the previous version, you can copy the values from the old configuration file and add them to the new version.
-
To retrieve the content of the data-set storage folder used for
the previous Talend Data Preparation and
migrate it to version 8.0, complete the next step according to the your
situation:
- If you have set a custom value for the
dataset.content.store.file.locationproperty, make sure that you set the same value in the application.properties file for the 8.0 version. - If you have never modified the value of the
dataset.content.store.file.locationproperty, copy the content of the <Data_Preparation_Path>/data folder used in 1.x/2.x, and paste it in the 8.0 installation folder, following the same path.
- If you have set a custom value for the
- Start Talend Data Preparation.
-
Republish semantic types using Talend Dictionary Service API to migrate indexes to Lucene 8.ⓘ
Available in:
Big Data Platform
Data Fabric
Data Management Platform
Data Services Platform
MDM Platform
Real-Time Big Data Platform
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 Preparation.