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

Upgrading but not migrating a project

You can upgrade the adapter from an earlier version, to version 7.5.0.3 while choosing not to migrate the adapter project artifacts.

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.

Procedure

1. Import the PI (project interchange) file into the workspace.

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. See http://publib.boulder.ibm.com/infocenter/dmndhelp/v7r5m1/topic/com.ibm.wbpm.wid.imuc.doc/topics/tmigsrcart.html.

3. In the Java™ EE perspective, right-click the project name and click Migrate connector project. The Adapter Migration wizard is displayed.

4. In the Select Projects window, clear the dependent artifact projects, and click Next. A warning window is displayed with the message, “The properties that are not supported in the version of the target adapter will be removed during the migration.”

5. Click OK.

6. In the Review Changes window, review the migration changes that occur during updating the project. 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.

   When v6.x FTP adapter module configured for FTPS protocol, the truststore of the adapter will be configured in NodeDefaultTrustStore in the Security -> SSL Certificates and Key Management -> Key stores and certificates section of Administrative console of the IBM BPM.

   While using v6.x module with FTPS protocol configured, and the adapter is upgraded to version 7.0, the truststore properties needs to be configured in the 'Managed Connection Factory properties' or 'Activation Specification properties'.

   If you prefer to configure the truststore at the Process Administrative Console of the IBM BPM, the following additional steps need to be performed after configuring the truststore in NodeDefaultTrustStore of the IBM BPM Process Administrative Console.

   1. Go to <java-home>/lib/security/java.security where <java-home> is the directory in which the Java file of the IBM BPM is installed.

      For example, C:\IBM\WebSphere\ProcServer\java\jre\lib\security\java.security

   2. Open the file and find the segment similar as below:

      # Default JSSE socket factories
      #ssl.SocketFactory.provider=com.ibm.jsse2.SSLSocketFactoryImpl
      #ssl.ServerSocketFactory.provider=com.ibm.jsse2.SSLServerSocketFactoryImpl
      # WebSphere socket factories (in cryptosf.jar)
      ssl.SocketFactory.provider=com.ibm.websphere.ssl.protocol.SSLSocketFactory
      ssl.ServerSocketFactory.provider=com.ibm.websphere.ssl.protocol.SSLServerSocketFactory

   3. Uncomment the default JSSE socket factories and comment the WebSphere socket factories. The segment is displayed as shown here after this setting:

      # Default JSSE socket factories
      ssl.SocketFactory.provider=com.ibm.jsse2.SSLSocketFactoryImpl
      ssl.ServerSocketFactory.provider=com.ibm.jsse2.SSLServerSocketFactoryImpl
      # WebSphere socket factories (in cryptosf.jar)
      #ssl.SocketFactory.provider=com.ibm.websphere.ssl.protocol.SSLSocketFactory
      #ssl.ServerSocketFactory.provider=com.ibm.websphere.ssl.protocol.SSLServerSocketFactory

   4. Restart the IBM BPM.

Results

The project can now be used with WebSphere Adapter for FTP, version 7.5.0.3.

Migrating to version 7.5.0.3 of WebSphere Adapter for FTP

Related tasks:

Performing the migration

Export the module as an EAR file

Installing the EAR file

Related reference:

Migration considerations