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 > SAP Software > Plan for adapter implementation > Migrating to version 7.5.0.3
Migration considerations
WebSphere Adapter for SAP Software 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 SAP Software, you must consider some factors that might affect your existing applications.
Compatibility with earlier versions
When migrating to version 7.5.0.3 of WebSphere Adapter for SAP Software, always run the migration wizard after importing the old project into your IBM Integration Designer workspace.
This will modify the old artifacts and make them compatible with the WebSphere Adapter for SAP Software version 7.5.0.3. The migration tool works with artifacts that are generated using WebSphere Adapter for SAP Software version 6.1.x, version 6.2.x, version 7.0.x and version 7.5.0 and version 7.5.0.2
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.
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.5.0.2 or earlier 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 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 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 perform an upgrade of the adapter and to migrate the application artifacts so that the applications can use features and functions in version 7.5.0.3 of the adapter. When you choose to upgrade the adapter by selecting a project, 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, each of which references to different adapters (for example, a module project that contains connector projects referring to JDBC and SAP adapters), the migration wizard identifies the artifacts belonging to each adapter and migrates these artifacts without disrupting the artifacts of other adapters.
When you select the module project and launch the migration wizard:
- The Source connector field lists the connector projects with the selected module project.
- The Dependent artifact projects area lists only the selected module project.
If you select the connector project and launch the migration wizard:
- The Source connector field lists only the selected connector project.
- The Dependent artifact projects area lists all projects which reference the selected connector project, including the module project.
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 SAP Software, 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
If you currently have Version 6.1.x, version 6.2.x, version 7.0.xand Version 7.5.0 and version 7.5.0.2 of the adapter installed, review the deprecated features and note if there are any compatibility conflicts between the versions before upgrading the adapter.
A deprecated feature is one that is supported but no longer recommended and that might become obsolete. The following features from earlier versions of WebSphere Adapter for SAP Software have been deprecated in version 7.5.0.2 and might require changes to your applications:
- The IgnoreBAPIReturn property is no longer a Managed Connection Factory property. It is now set as part of the interaction spec.
- The DataDelimiter property has been removed from the application-specific information for Query interface for SAP Software business objects.
Migrating to version 7.5.0.3 of WebSphere Adapter for SAP Software
Related tasks: