Performing the migration

You can migrate a project or EAR file to version 7.5.0.3 using the adapter migration wizard. When the tool is finished, the migration is complete and you can work in the project or deploy the module.

1. Import the PI (project interchange) file for an existing project into the workspace.
   Note: Ensure that you do not modify the contents of the RAR or copy the adapter JAR file outside the connector project.
2. When projects are created in an earlier version of IBM Integration Designer, the Workspace Migration wizard starts automatically and selects the projects to migrate. Follow the wizard and complete the workspace migration. For more information, see http://pic.dhe.ibm.com/infocenter/dmndhelp/v7r5m1/topic/com.ibm.wbpm.wid.imuc.doc/topics/tmigsrcart.html.
3. Change to the Java EE perspective.
4. Right-click the module and select Migrate connector project. For example, the adapter RAR module.
   You can also launch the adapter migration wizard in the following ways:

   • Right-click the project in the Java EE perspective and select Migrate adapter artifacts.
   • From the Problems view, right-click a migration-specific message and select Quick Fix to correct the problem.
5. In the Select Projects window, perform the following steps:
   1. The Source connector field displays the name of the connector project that you are migrating. If you are migrating a module project, this field lists all the connector projects in the module project. Select the source project from the list. For more information, see Migrating multiple adapters referred within a project.
   2. The Target connector field displays the name of the connector to which you are migrating. If you are working with more than one adapter version, this list displays the names of all the compatible connectors. Select the connector you want to migrate.
   3. The Target version field displays the version corresponding to the target connector that you selected in the previous step.
   4. The Dependent artifacts project area lists the adapter artifacts that are migrated. If you are migrating a module project, this area lists only the selected module project. If you are migrating a connector project within the module project, this area lists all projects which reference the selected connector project, including the module project. By default, all the dependent artifact projects are selected. If you do not select a dependent artifact project, that project is not migrated. You can migrate any project that you have not selected at a later time. Previously migrated projects, projects with a current version, and projects that contain errors are unavailable for migration and are not selected. For more information, see Upgrading but not migrating a project.
   5. Click Next. A warning window is displayed with the message, “Properties that are not supported in this version of the target adapter will be removed during the migration”.
   6. Click OK.
6. In the Review Changes window, review the migration changes that occur in each of the artifacts that you are migrating. To view the details, expand each node by clicking the + sign.
7. To complete the migration:
   • Click Finish.
   • If the files that need to be updated during migration are in read-only mode, you will be unable to click on the Finish button. To view these files, click Next. The Update Read-only files window displays the read-only files. To update these files and continue with the migration, click Finish. To exit the wizard without migrating the adapter, click Cancel.

   Before running the migration process, the wizard performs a backup of all projects affected by the migration. The projects are backed up to a temporary folder within the workspace. If the migration fails for any reason, or if you decide to cancel the migration before it completes, the wizard deletes the modified projects and replaces them with the projects stored in the temporary folder.

   Upon completing the migration successfully, all backed up projects are deleted.

8. After completing the migration, the following steps have to be completed for the SAP adapter:
   1. Right click Connection Project (CWYAP_SAPAdapter_Tx or CWYAP_SAPAdapter)
   2. Click Properties
   3. In the left pane, click Java Build Path
   4. Open the Libraries tab in the right pane
   5. Select the JCo 218 jar if it is present and click Remove
   6. Click Add External JARs
   7. Browse and select the JCo3 API jar
   8. Click Open
   9. Click OK on the Properties window
9. If you are migrating an EAR file, optionally create a new EAR file with the migrated adapter and artifacts, and deploy it to IBM Business Process Manager or WebSphere Enterprise Service Bus. For more information about exporting and deploying an EAR file, see the topics devoted to it in this documentation.