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


iibcreateswitchcfg command

Use the iibcreateswitchcfg command to create the configuration files that are used to configure the Switch server and connectivity agent for callable flows.

Supported platforms

  • Windows
  • Linux systems

Purpose

You can split message flow processing so that a callable message flow in one location can call another callable flow in another location. A callable flow can call another callable flow in the same integration server or a different integration server. You can also split message flow processing between IBM® Integration Bus and IBM Integration Bus on Cloud. If one of your callable flows is in the cloud, the Switch server is created and managed for you in the cloud. If your callable flow is in a different integration server, you must create a Switch server to route the data between the flows. You use the iibswitch command to create the Switch server.

The iibswitch command requires a configuration file to create the Switch server. If you are splitting flow processing between IBM Integration Bus and IBM Integration Bus on Cloud, you download the agent configuration from the cloud. 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 that enable secure connectivity to the Switch server. You use the mqsichangeproperties command to configure the connectivity agents for each integration server.

Syntax

Syntax for Windows

Read syntax diagramSkip visual syntax diagram
>>-iibcreateswitchcfg--+-------------------------+-------------->
                       '-/output--/host--/fsport-'   

>--+--------------------------------------+--------------------->
   '-/bsport--/adminport--/dname--/keyalg-'   

>--+-----------------------------------------+-----------------><
   '-/keysize--/sigalg--/validity--/password-'   

Syntax for Linux

Read syntax diagramSkip visual syntax diagram
>>-iibcreateswitchcfg--+----------------------------+----------->
                       '- -output-- -host-- -fsport-'   

>--+------------------------------------------+----------------->
   '- -bsport-- -adminport-- -dname-- -keyalg-'   

>--+---------------------------------------------+-------------><
   '- -keysize-- -sigalg-- -validity-- -password-'   

Parameters

output
(Optional) The output directory in which to save the configuration file. The default location is the current directory. You must be able to write to the specified directory.
host
(Optional) The host name of the connection agent. The default host name is localhost.
fsport
(Optional) The front-side port for the connection agent. The default port number is 9011.
bsport
(Optional) The back-side port for the connection agent. The default port number is 9010.
adminport
(Optional) The administration port for the connection agent. The default port number is 9012.
dname
(Optional) The distinguished name for the generated certificates. The default distinguished name is cn=<host>.
keyalg
(Optional) The key algorithm for generated certificates. The default key algorithm is RSA.
keysize
(Optional) The key size for the generated certificates. The default key size is 2048.
sigalg
(Optional) The signature algorithm for the generated certificates. The default signature algorithm is SHA256withRSA.
validity
(Optional) The validity period, in days, for the generated certificates. The default validity is 3 * 365.
password
(Optional) The private key password for the generated certificates. The default password is password.

Examples

Create the configuration files for the connection agent and save them in the temp directory.

Windows platformOn Windows:
iibcreateswitchcfg /output c:\temp
Linux platformOn Linux:
iibcreateswitchcfg -output /temp
If this command is successful, you see the following responses:
Generated self signed certificate file 'c:\temp\adminClient.p12'
Generated switch configuration file 'c:\temp\switch.json'
Generated agentx configuration file 'c:\temp\agentx.json'
The adminClient.p12 file contains certificates and is reserved for future use. switch.json is the configuration file that is used by the iibswitch command to create the Switch server. agentx.json is the configuration file that is used by the mqsichangeproperties command to configure the connectivity agents to connect securely to the Switch server.

cl23147_.htm | Last updated 2017-07-17 12:46:59