Migrating custom integration (CMP) applications

If you have applications that use the IBM® Integration API, check that they access the correct resources.

About this task

Your existing Version 9.0, Version 8.0 and Version 7.0 custom integration applications can connect to Version 10.0 integration nodes.

Procedure

  1. If you are migrating from IBM Integration Bus Version 9.0 or earlier, update your custom integration applications to use the IntegrationAPI.jar file that is included in IBM Integration Bus Version 10.0.
    The IntegrationAPI.jar file replaces the ConfigManagerProxy.jar file that is used in versions before Version 10.0. Existing custom integration applications must be rebuilt to use the IntegrationAPI.jar file, and the IntegrationAPI.jar file must be included in the class path for the applications. For stand-alone applications, the IntegrationAPI.jar file must be supplied with the application.

    You do not have to change the methods that the application uses; the Version 10.0 IBM Integration API includes all deprecated classes and takes appropriate action.

  2. For custom integration applications that connect to an integration node, update the connection details that are used by your custom integration applications to connect to the appropriate integration node.

In IBM Integration Bus Version 10.0, the IBM Integration API connections are no longer dependent on WebSphere® MQ, and so connections are no longer made by using WebSphere MQ queues.

  1. If you are connecting to a remote integration node, update your connection details to use the web administration port; see Configuring the IBM Integration Bus web user interface.
    For information about using SSL on these connections, see Connecting to a remote integration node .
  2. If administration security is enabled, in IBM Integration Bus Version 10.0, user credentials are required for integration applications that use a remote connection. If the connection is local, you must run the application under a user ID that is part of the mqbkrs group. For new integration applications, you can provide user details during application development by using the IBM Integration API IntegrationNodeConnectionParameters class. For existing compiled applications, you must supply the security credentials by using one of the methods that is described in Connecting to an integration node from a custom integration application.