Use the iibswitch command to configure an endpoint connectivity agent for IBM® Integration Bus on Cloud.
You can run message flows in the cloud by deploying flows that you create in IBM Integration Bus to IBM Integration Bus on Cloud. Message flows that are deployed to IBM Integration Bus on Cloud can access on-premises endpoints, such as databases, securely. A Switch server in the cloud routes data between your integrations and your on-premises endpoints. Connectivity agents contain the appropriate certificates to allow your flows to connect securely to the Switch server. To configure this connectivity agent, you download a configuration file from IBM Integration Bus on Cloud. This configuration file is used by the iibswitch command to create and configure the on-premises agent (agentp). If you configure more endpoints in the cloud, you download an updated configuration file. Then, you use the iibswitch command to update the on-premises agent with the new configuration. You can also use the iibswitch command to start, stop, or delete the agent.
You run this command in a command environment on IBM Integration Bus.
The Switch server is also used to route data between callable flows. When you split message flow processing between IBM Integration Bus on Cloud and IBM Integration Bus, the Switch server is created and managed for you in the cloud. If you split your flows between different integration servers on IBM Integration Bus, you use the iibswitch command to create and start the Switch server on premises. For more information about the command parameters that are used with callable flows, see iibswitch command in the IBM Integration Bus product documentation.
In the following example, you are configuring a connectivity agent on premises by using the downloaded configuration file, which is in the temp directory.
iibswitch create agentp /config c:\temp\agentp.json
iibswitch create agentp -c /temp/agentp.json
In the following example, you are updating a connectivity agent by using the downloaded configuration file, which is in the temp directory.
iibswitch update agentp /config c:\temp\agentp2.json
iibswitch update agentp -c /temp/agentp2.json
iibswitch stop agentp
iibswitch start agentp
iibswitch delete agentp