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 > Enterprise Content Management > Plan for adapter implementation > Migrating to version 7.5.0.3

Migration considerations

WebSphere Adapter for Enterprise Content Management 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 Enterprise Content Management, you must consider some factors that might affect your existing applications.


Compatibility with earlier versions

WebSphere Adapter for Enterprise Content Management version 7.5.0.3 is fully compatible with the custom business objects (XSD files) and data bindings that are created using the adapter Version 7.0.2, version 7.5.0, and version 7.5.0.2 and enables the existing business objects and data bindings to work well in the latest version of the adapter.

Because version 7.5.0.3 of WebSphere Adapter for Enterprise Content Management is fully compatible with Version 7.0.2, version 7.5.0, and version 7.5.0.2, any of your applications that used the previous versions of WebSphere Adapter for Enterprise Content Management runs unchanged when you upgrade to version 7.5.0.3. However, if you want your applications to use features and functionality present in version 7.5.0.3 of the adapter, run the migration wizard.

The migration wizard replaces (upgrades) Version 7.0.2, version 7.5.0, and 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.

The migration wizard does not create components or modify existing components, such as mappers and mediators to work with version 7.5.0.3 of the adapters. If any of your applications embed an adapter that is Version 7.0.2, version 7.5.0, and version 7.5.0.2 and you are upgrading to version 7.5.0.3, and you want your applications to take advantage of the features and functions in version 7.5.0.3, you might need to change to those 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 Integration Designer version 7.5.0.3 only supports the migration of adapters from Version 7.0.2, version 7.5.0, and version 7.5.0.2 to version 7.5.0.3.


Decide whether to upgrade or to upgrade and migrate

If you decide that you want to upgrade the adapter from Version 7.0.2, version 7.5.0, and 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 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 first

Because adapter migration might require you to change those applications that use version 7.5.0.3 of WebSphere Adapter for Enterprise Content Management, 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.

Migrating to version 7.5.0.3 of WebSphere Adapter for Enterprise Content Management