Migrating MDM instances - 6.4

Talend MDM Platform Migration Guide

EnrichVersion
6.4
EnrichProdName
Talend MDM Platform
task
Installation and Upgrade
EnrichPlatform
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 Management
Talend Installer
Talend JobServer
Talend Log Server
Talend MDM Server
Talend MDM Web UI
Talend Project Audit
Talend Repository Manager
Talend Runtime
Talend SAP RFC Server
Talend Studio

It is assumed that:

  • you fully understand how to install and configure an MDM server or a cluster of MDM servers;

  • all existing MDM databases have been backed up and can be restored if required.

MDM system objects, master data records and staging data records (if any) are stored in databases. Besides, some MDM objects in Talend Studio such as data models and views deployed to the MDM server also persist in databases.

You can migrate those MDM instances in databases using the dbmigration tool. See Using the dbmigration tool for migration for details.

However, since not everything persists or is stored in a database, you need to manually reimport and redeploy the Jobs and workflows for the migration. See Reimporting and redeploying your Jobs and Reimporting and redeploying your workflows for details.

A workspace of an older version of Talend Studio cannot be reused. From Talend Studio, you need to manually move the repository objects from the source Talend Studio to the target Talend Studio. See Manually moving repository objects in Talend Studio for details.

Before the migration, pay attention to the following:

  • If you want to migrate to an MDM server in a cluster, make sure the cluster is configured properly and all nodes in the cluster are running during the migration. Only a single node in a cluster is used as the source server or the target server.

  • Make sure all changes to the source MDM server and the target MDM server are frozen during the migration. That is, no insert, update, or delete operations will take place during the migration.

  • Make sure the machine hosting the target server has a significant amount of free memory to run the dbmigration tool.

  • Make sure to delete your web browser cache and cookies whenever you change the version, or the Talend Studio. Unpredictable behavior or display errors will occur if you do not.

  • If you want to migrate from 5.6.1 or 5.6.2 to 6.0.1 or later, you have to install a patch. To obtain this patch, contact Talend support.

Talend MDM data models only support certain types, as shown in the following table. When you migrate a project containing unsupported types, errors will occur.

Supported types

Unsupported types

xsd:anyURI

xsd:ENTITIES

xsd:base64Binaryxsd:gDay
xsd:booleanxsd:gMonth
xsd:byte xsd:gMonthDay
xsd:datexsd:gYear
xsd:dateTime xsd:gYearMonth
xsd:decimalxsd:ID
xsd:doublexsd:IDREF
xsd:durationxsd:IDREFS
xsd:floatxsd:language
xsd:hexBinaryxsd:Name
xsd:intxsd:NMTOKEN
xsd:integerxsd:normalizedString
xsd:languagexsd:QName
xsd:longxsd:token
xsd:negativeInteger-
xsd:nonNegativeInteger-
xsd:nonPositiveInteger-
xsd:normalizedString-
xsd:positiveInteger-
xsd:short-
xsd:string-
xsd:time-
xsd:token-
xsd:unsignedByte-
xsd:unsignedInt-
xsd:unsignedLong-
xsd:unsignedShort-