ESB: migration from 6.x.x to 7.3.1
Studio
|
Item |
Description |
Available in |
|---|---|---|
| ESB Studio upgrade | The ESB Studio requires a new installation. You need to export your 6.x, 7.0, 7.1 or 7.2 projects from your local workspace and import the project with the ESB Studio 7.3.1. |
All Talend products with ESB |
| 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. |
All Talend on-premises products with ESB |
| 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. |
All Talend products with ESB |
Runtime
|
Item |
Description |
Available in |
|---|---|---|
| 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. |
All Talend products with ESB |
Talend Administration Center
|
Item |
Description |
Available in |
|---|---|---|
| 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 7.3 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.x containers in addition to 7.x containers. Please also consider to use the new Migration page in Talend Administration Center to compare the project before and after migration. |
All Talend on-premises products with ESB |
| 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 https://syncope.apache.org/docs/reference-guide.html#migration-from-apache-syncope-1-2. 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. |
All Talend on-premises products with ESB |
Compatibility notes on Studio Data Services and Studio Routes
|
Item |
Description |
Available in |
|---|---|---|
| Talend ESB container migration | If you want to run your existing Data Services or
Routes on the new 7.3.1 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.x with Data Services and Routes generated by Talend ESB Studio 6.x and the Talend ESB Infrastructure Services in 7.3.1. |
All Talend on-premises products with ESB |
| 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 7.3.1. |
All Talend on-premises products with ESB |
| 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. |
All Talend products with ESB |
| 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. |
All Talend products with ESB |
|
Studio Routes - Bean/Routine Migration |
The migration from 6.x to 7.3 needs to consider that Beans/Routines are now built on their own (independent of the Route). This is different from 6.x and has a side effect in cases where cConfig is used for both the Route and the Beans to get a related library loaded for Beans. In 7.x the use of cConfig is limited to Routes only (which was also the original use case) while Beans must load external libraries via the Edit Bean Libraries dialog. As all beans are compiled together it is sufficient to assign the libraries needed to one Bean or to assign each library explicitly to the related Bean which needs the library. In version 7.0, 7.1 or 7.2 there is one more limitation which requires to use org.talend.libraries as fixed Group ID and 6.0.0-SNAPSHOT as fixed version in the case the same library is needed by cConfig and Beans. In the above mentioned versions the cConfig can only use the fixed Group ID and version while with 7.3 custom version is allowed and the same dialog and functionality is shared between cConfig and the Edit Bean Libraries dialog. All 7.x versions (7.0 to 7.3) still require a fixed Group ID org.talend.libraries. For Routines, external libraries must be loaded via the Edit Routine Libraries dialog. |
All Talend products with ESB |
| Migration of Studio Jobs using SAP with a Talend Runtime Connection Pool | With Talend Runtime 7.x, it is required that the shared connection pool has a fixed name SAP_CONNECTION_POOL. If you have changed it, you need to update your models to use this fixed value. |
All Talend products with ESB |