ESB: migration V6.4.x to 6.5.x - 6.5

Talend Data Fabric Release Notes

Talend Big Data
Talend Big Data Platform
Talend Open Studio for Big Data
Talend Real-Time Big Data Platform
Installation and Upgrade




ESB Studio upgrade

The ESB Studio requires a new installation. You need to export your 6.4.x projects from your local 6.4.x workspace and import the project with the ESB Studio 6.5.x.
Remote project upgrade If you use a shared (remote) Project you need to upgrade Talend Administration Center first, and then connect to your remote project without further actions required.

Studio project upgrade

Studio projects can be used without any manual migration. When the Data Services, Jobs and Routes are opened in the ESB Studio, the components that need changes will be upgraded automatically.




ESB Runtime upgrade

The ESB Runtime (OSGi Container) requires a new installation. See also Compatibility notes on Studio Data Services and Studio Routes for details.

Talend Administration Center



Talend Administration Center upgrade

Talend Administration Center requires a new installation. Please follow the migration chapter in the Talend Migration Guide.

The ESB related pages in Talend Administration Center 6.5 are not backward compatible with older versions of the containers except the ESB Conductor, which still supports the deployment and undeployment of tasks into 6.4.x, 6.3.x, 6.2.x, 6.1.x, 6.0.x, 5.6.x and 5.5.x containers in addition to 6.5 containers.

Please also consider to use the new Migration page in Talend Administration Center to compare the project before and after migration.

ESB Identity and Access Management migration

From 6.4.1 onwards, the Talend Identity Management (Talend IDM) service (based on Apache Syncope) provided with Talend ESB in the add-ons/tidm folder is no longer available within the Talend ESB package. The Talend Identity Management (Talend IDM) service is now replaced by a more general Talend Identity and Access Management (Talend IAM) service, which uses port 9080 by default instead of 8080. The Identity Service URL in the ESB Identity and Access Management part of the Talend Administration Center Configuration Page need to be updated accordingly. If you used Talend ESB with Talend Identity Management (based on Apache Syncope 1.2) before, you must either re-enter the users and roles (which are now the Groups in Syncope 2.0.2), or follow the migration steps for Apache Syncope 1.2 to Apache Syncope 2.0 as described in Talend ESB used Users / Roles and User to Role assignments in Syncope 1.2. Now in Syncope 2.0.2 (the currently version in Talend IAM ) you will have Users / Groups and User to Group assignments after the migration or in case you re-enter the users manually. Make sure that Groups are used in the place of Roles before in Syncope 1.2.

Compatibility notes on Studio Data Services and Studio Routes



Talend ESB container migration

If you want to run your existing Data Services or Routes on the new 6.5.x Container, you need to re-build, re-publish and re-deploy the Studio models to use the latest code changes.

We support the mixed installation and use of Talend ESB container 6.4.x/6.3.x/6.2.x/6.1.x/6.0.x/5.6.x with Data Services and Routes generated by Talend ESB Studio 6.4.x/6.3.x/ 6.2.x/6.1.x/6.0.x/5.6.x and the Talend ESB Infrastructure Services in 6.5.x.

Service Registry migration

The Service Registry migration from versions older than 6.4.1 requires an export of all artifacts in the older version Service Registry (using the TAC Service Registry UI or the related tregistry:export command). Then this full export can be used to import the Service Registry content into a new Service Registry installation done for 6.5.1.

Talend Runtime migration

Due to a change in the container/etc/org.talend.esb.job.saml.policy file to use an SHA2 instead of SHA1 algorithm suite, if you run on previous versions of Talend Runtime older than 6.4.1, you need an updated policy using the Basic128Sha256 AlgorithmSuite. This only affects clients who need to communicate with a provider from 6.4.1 onwards and who use the design time SAML Token authentication option (tESBConsumer > Authentication > SAML Token ). Clients and providers that use the Service Registry are not affected by this change as they get the policies from the Service Registry.

Studio Routes migration

From 6.3.1 onwards, the cMessageEndpoint Libraries are not shipped with the ESB Studio anymore. For more information about how to use Routes generated by ESB Studio older than 6.3.1, see the <Studio_Home>/esb/Readme_cMessageEndpoint_Libraries.txt for details.