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 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.
- In IBM Integration
Bus on Cloud, click Callable
Flows.
- On the Callable Flows page, click Set up an
agent.
- 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.
- 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.
- Start an IBM Integration Bus command
environment.
- 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
- Click Test Agent to check that the
on-premises agent can connect to the Switch server.
- Click Finish.
- 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 synchronously 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