Migrating to Talend Data Stewardship 8.0.x with an embedded MongoDB

Migrating to Talend Data Stewardship 8.0.x with an embedded MongoDB - 8.0

Talend Migration and Upgrade Guide

Version

8.0

Language

English

Product

Talend Big Data

Talend Big Data Platform

Talend Data Fabric

Talend Data Integration

Talend Data Management Platform

Talend Data Services Platform

Talend ESB

Talend MDM Platform

Talend Real-Time Big Data Platform

Module

Talend Activity Monitoring Console

Talend Administration Center

Talend Artifact Repository

Talend CommandLine

Talend Data Preparation

Talend Data Stewardship

Talend ESB

Talend Identity and Access Management

Talend JobServer

Talend LogServer

Talend MDM Server

Talend MDM Web UI

Talend Runtime

Talend SAP RFC Server

Talend Studio

Content

Installation and Upgrade

Last publication date

2023-09-14

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

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.

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>

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.

Note: For Windows users, you must uninstall the current MongoDB before you install Talend Data Stewardship 8.0.x.
Install Talend Data Stewardship 8.0.x and select the embedded MongoDB option. Do not start Talend Data Stewardship, but start MongoDB.
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

Restore the MongoDB backup on the new 8.0.x MongoDB instance by using 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>

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.
Delete the <install_dir>/tds/apache-tomcat/data folder from your Talend Data Stewardship 8.0.x installation.
Start Talend Data Stewardship 8.0.x.
ⓘ
Available in:
Big Data Platform
Data Fabric
Data Management Platform
Data Services Platform
MDM Platform
Real-Time Big Data Platform
Republish semantic types using Talend Dictionary Service API to migrate indexes to Lucene 8.
For more information, see Talend Dictionary Service Administration Guide.

Results

You are now ready to use Talend Data Stewardship 8.0.x.