IBM Integration Bus, Version 10.0.0.5 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS


Preparing the environment to split processing between IBM Integration Bus and IBM Integration Bus on Cloud

When you split message flow processing between IBM® Integration Bus and IBM Integration Bus on Cloud, you must configure a connectivity agent.

About this task

When you split processing between IBM Integration Bus and IBM Integration Bus on Cloud, your flows communicate by using a Switch server and connectivity agent. The Switch server, which routes data, is managed for you by IBM Integration Bus on Cloud. The connectivity agent contains the certificates that your flows require to communicate securely with the Switch server. A connectivity agent must be running in the IBM Integration Bus integration server where you have deployed your on-premises message flows.

The diagram shows an application in Integration Bus, and an application in Integration Bus on Cloud.  The CallableFlowInvoke node in a flow in application 1 in Integration Bus uses a Switch server in the cloud to call the CallableInput node of a flow in application 2 in Integration Bus on Cloud.
The diagram shows an application in Integration Bus on Cloud, and an application in IBM Integration Bus.  The CallableFlowInvoke node in a flow in application 1 in the cloud uses a Switch server in the cloud to call the CallableInput node of a flow in application 2 in Integration Bus.

The Switch server is already created in IBM Integration Bus on Cloud. You must download an agent configuration file from the cloud, and use it to configure the on-premises connectivity agent. Your callable flows use this agent to communicate with each other securely, through the Switch server.

Procedure

To prepare the environment to split processing between IBM Integration Bus and IBM Integration Bus on Cloud, complete the following steps.

  1. In IBM Integration Bus on Cloud, click Callable Flows.
  2. On the Callable Flows page, click Set up an agent.
  3. Optional: If you have not already done so, install IBM Integration Bus version 10.0.0.4 (or later) on premises. This version contains the connectivity agent.

    For more information, see Installing IBM Integration Bus in the IBM Integration Bus product documentation. For development and test purposes, you can download and use IBM Integration Bus for Developers without charge.

  4. Click Download Configuration and save the agent configuration file (agentx.json) to the same computer where IBM Integration Bus version 10.0.0.4 is installed.
  5. Start an IBM Integration Bus command environment.
  6. To use the downloaded file to configure the connectivity agent on premises, run the following mqsichangeproperties command for the integration server that contains your callable flow.
    • On Windows:
      mqsichangeproperties integrationNodeName -e integrationServerName -o ComIbmIIBSwitchManager -n agentXConfigFile -p filepath\agentx.json
    • On Linux:
      mqsichangeproperties integrationNodeName -e integrationServerName -o ComIbmIIBSwitchManager -n agentXConfigFile -p filepath/agentx.json
  7. Click Test Agent to check that the on-premises agent can connect to the Switch server.
  8. Click Finish.
  9. Restart the integration server.

Results

A callable message flow that is deployed to the configured on-premises integration server can now communicate securely with a callable message flow in IBM Integration Bus on Cloud. For more information about developing these message flows, see Developing callable message flows.

You can check that your callable flows are registered with the Switch server by using the Callable Flows view of IBM Integration Bus on Cloud (see Callable Flows view in the IBM Integration Bus on Cloud product documentation).

You can also list the callable flows that are running in the on-premises integration server by using the following mqsireportproperties command:
mqsireportproperties integrationNodeName -e integrationServerName -o CallableFlowManager -r

cl23151_.htm | Last updated 2016-06-25 08:09:15