IBM BPM, V8.0.1, All platforms > Authoring services in Integration Designer > Services and service-related functions > Access external services with adapters > Configure and using adapters > IBM WebSphere Adapters > Oracle E-Business Suite > Plan for adapter implementation > Migrating to version 7.5.0.3

Migration considerations

WebSphere Adapter for Oracle E-Business Suite version 7.5.0.3 may have some features and updates that might affect your existing adapter applications. Before migrating applications that use WebSphere Adapter for Oracle E-Business Suite, you must consider some factors that might affect your existing applications.


Compatibility with earlier versions

Since the version 6.1.x, version 6.2.x, version 7.0.x, version 7.5.0, and version 7.5.0.2 of the adapter were based on WebSphere Adapter for JDBC, the artifacts generated using those versions are not compatible with the latest adapter version. If you want your applications created using version 6.1.x, version 6.2.x, version 7.0.x and version 7.5.0 and version 7.5.0.2, of the adapter to use the features and functions present in version 7.5.0.3, run the migration wizard to migrate the adapter artifacts too to the latest version.

Because the version 7.0 of WebSphere Adapter for Oracle E-Business Suite is not fully compatible with version 7.5.0.2, you have to modify some artifacts manually.

For example, the 'resourceAdapter name' property in .import file must be changed from "XXXX.IBM WebSphere Adapter for Oracle" to "XXXX.IBM WebSphere Adapter for Oracle E-Business Suite." It is recommended to run the migration wizard for both adapter and the adapter artifacts to avoid manual changes being done to the artifacts.

The migration wizard replaces (upgrades) version 6.1.x, version 6.2.x, version 7.0.x, version 7.5.0, or version 7.5.0.2 of the adapter with version 7.5.0.3 and enables version 7.5.0.3 features and functionality for use with your applications.

If the artifacts within a module have inconsistent versions, the entire module is marked as unavailable for migration and cannot be selected. Version inconsistencies are recorded in the workspace log, as they indicate that a project might be corrupted.

The adapter migration wizard in IBM Integration Designer Version 7.5.1 only supports the migration of adapters from version 6.1.x, version 6.2.x, version 7.0.x, version 7.5.0, and version 7.5.0.2 to version 7.5.0.3. It does not support the adapter migration from lower versions to any of the versions before version 7.5.0.3.


Decide whether to upgrade or to upgrade and migrate

The default processing of the migration wizard is to upgrade the adapter and to migrate the application artifacts so that the applications can use features and functions available in version 7.5.0.3 of the adapter. When you choose to upgrade the adapter by selecting a project of version 7.5.0.2, the wizard automatically selects the associated artifacts for migration.

If you decide that you want to upgrade the adapter from version 6.1.x, version 6.2.x, version 7.0.x, version 7.5.0, or version 7.5.0.2 to version 7.5.0.3, but you do not want to migrate the adapter artifacts, you can do so by clearing the adapter artifacts from the appropriate area of the migration wizard.

Running the migration wizard without selecting any adapter artifacts installs and upgrades your adapter. As the artifacts are not migrated, your applications cannot take advantage of the features and capabilities that exist in version 7.5.0.3 of the adapter.


Migrating multiple adapters referred within a project

When a module contains one or more connector projects and each of them refer to different adapters (for example, a module project that contains connector projects referring to Oracle and SAP adapters), the migration wizard identifies the artifacts belonging to each adapter and migrates the artifacts without disrupting the artifacts of the other adapters.

When you select the module project and launch the migration wizard:

If you select the connector project and launch the migration wizard:


Run the migration wizard in a test environment

Because adapter migration might require you to change those applications that use version 7.5.0.3 of WebSphere Adapter for Oracle E-Business Suite, you must always perform the migration in a development environment first and test your applications before deploying the application to a production environment.

The migration wizard is fully integrated with the development environment.


Deprecated features

A deprecated feature is one that is supported but no longer recommended and that might become obsolete. The following feature from earlier versions of WebSphere Adapter for Oracle E-Business Suite have been deprecated in Version 6.1.x, version 6.2.x, version 7.0.xand Version 7.5.0 and version 7.5.0.2 and might require changes to your applications:

Migrating to version 7.5.0.3 of WebSphere Adapter for Oracle E-Business Suite