General

IBM Engineering Integration Hub replaces Engineering Lifecycle Optimization - Integration Adapters Tasktop Edition. To receive a detailed guide for migrating from Integration Adapters Tasktop Edition to Engineering Integration Hub, please contact your IBM account manager or technical subject matter expert.

Before you begin the migration process, please ensure that you have upgraded your version of Integration Adapters Tasktop Edition to the correct version that matches the Engineering Integration Hub version in use.

Integration Adapters Tasktop Edition Version	Engineering Integration Hub Version
1.2.0.28	7.0.2.2
1.2.0.27	7.0.2.1
1.2.0.26 1.2.0.25	7.0.2
1.2.0.24	N/A

Connect with IBM Support if in you need any information about which version you must use.

If you have already migrated to IBM Engineering Integration Hub, follow the instructions at Upgrading to upgrade to this version.

Product upgrade Notes

Extensions

The JavaScript engine that used to run the extension scripts is upgraded, and extensions must be reviewed and updated for the following cases:

• String length checks are now only accessible as a property. Existing function calls such as "hello".length() must be expressed as property access: "hello".length.
• JavaScript String object functions must be used instead of any corresponding Java String methods.
• Creating or running a JavaScript thread migth fail under certain circumstances. It is not recommended to write multithreaded extension scripts.
• Declaring or implementing a Java Interface or abstract Class from within a JavaScript extension is no longer supported.
• The following functions earlier available in the Java global object are no longer available:
  • Java.isJavaFunction
  • Java.isJavaMethod
  • Java.isScriptObject
  • Java.isScriptFunction

Repositories

Existing on-premise users will need to create new roles and groups in Keycloak to use this feature. To do this:

• Log in to the User Administration Console as the root user.
• On the 'Roles' page, create two new roles, 'RepositoryWriteAccess' and 'NonRepositoryWriteAccess'.
• On the 'Groups' page, create a group named 'NonRepositoryUsers'. Under Role Mappings, add 'TasktopTroubleshootingUser' and 'NonRepositoryWriteAccess' to the assigned roles.
• Then, create a group named 'RepositoryOnlyUsers'. Under Role Mappings, add the associated roles 'TasktopTroubleshootingUser' and 'RepositoryWriteAccess' to the assigned roles.

Connector-Specific Upgrade Notes

Microsoft Project Server

Upon upgrading, the connector will reset the enableNTLM boolean repository option to false. Please migrate to a more secure authentication protocol as NTLM support will be removed in an upcoming release.