IBM App Connect Enterprise, Version 11.0.0.2 Operating Systems: Windows, Linux


iibswitch command

Use the iibswitch command to administer the Switch server for callable flows, or the endpoint connectivity agent for IBM® App Connect on IBM Cloud.

Supported platforms

  • Windows
  • Linux systems

Purpose

You use the iibswitch command in the following scenarios:
  • Preparing your environment for callable message flows, so that you can split message flow; for example, for processing by separate message flows running on different integration servers.
  • Enabling message flows that are running in IBM App Connect on IBM Cloud to connect securely to on-premises endpoints, such as databases.

Preparation for callable flows

You can split message flow processing so that a message flow in one location can call another flow in another location. A flow can call another flow in the same integration server or a different integration server. You can also split message flow processing between IBM App Connect Enterprise and IBM App Connect on IBM Cloud.
The iibswitch command requires a configuration file to create or update the Switch server.
  • If your callable flows are in different integration servers, you must first create the configuration files by running the iibcreateswitchcfg command. This command generates configuration files for the Switch server and for the connectivity agents (agentx) that make secure connections to the Switch server. You use the mqsichangeproperties command to configure the connectivity agents for each integration server.

    For more information about preparing to use callable flows between different integration servers, see Preparing the environment to split processing between different integration servers.

  • If you are splitting flow processing between IBM App Connect Enterprise and IBM App Connect on IBM Cloud, you download the agent configuration from the cloud.

    For more information about preparing to use callable flows across IBM App Connect Enterprise and on IBM Cloud, see Preparing the environment to split processing between IBM App Connect Enterprise and IBM App Connect on IBM Cloud.

You can also use the iibswitch command to start, stop, or delete the Switch server, or to update the Switch server with a new configuration file.

Secure connectivity for callable flows between the cloud and on-premises endpoints

You can run message flows in the cloud by deploying flows that you create in IBM App Connect Enterprise to IBM App Connect on IBM Cloud. Message flows that are deployed to IBM App Connect on IBM Cloud can access on-premises endpoints, such as databases, securely through the Switch server. The Switch server is provided in the cloud. To enable the secure connection, you download a configuration file from IBM App Connect on IBM Cloud. This configuration file is used by the iibswitch command to create and configure an on-premises agent (agentp). The connectivity agent contains the certificates that are required by IBM Integration Bus on Cloud or IBM App Connect on IBM Cloud to connect securely to on-premises endpoints. 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.

Parameters

The iibswitch command can have the following parameters.
create
This parameter creates the object that follows it. Valid objects are switch (Switch server) and agentp (connectivity agent). You must also follow this parameter with the /config parameter on Windows, or the -c parameter on Linux, and the location of the configuration file.

In the following example, you are creating a Switch server by using the generated configuration file, which is in the temp directory.

Windows platformOn Windows:
iibswitch create switch /config c:\temp\switch.json
Linux platformOn Linux:
iibswitch create switch -c /temp/switch.json
update
This parameter updates the object that follows it when you update a configuration file. Valid objects are switch and agentp. You must also follow this parameter with the /config parameter on Windows, or the -c parameter on Linux, and the location of the configuration file.

In the following example, you are updating a connectivity agent by using the downloaded configuration file, which is in the temp directory.

Windows platformOn Windows:
iibswitch update agentp /config c:\temp\agentp2.json
Linux platformOn Linux:
iibswitch update agentp -c /temp/agentp2.json
stop
This parameter stops the object that follows it. Valid objects are switch and agentp.
In the following example, you are stopping the Switch server.
iibswitch stop switch
start
This parameter starts the object that follows it. Valid objects are switch and agentp.
In the following example, you are starting the connectivity agent.
iibswitch start agentp
delete
This parameter deletes the object that follows it. Valid objects are switch and agentp.
In the following example, you are deleting the Switch server.
iibswitch delete switch

cl23146_.htm | Last updated 2018-11-02 14:46:41