If you want to split message flow processing between integration servers in different locations such as IBM® App Connect Enterprise installed on premises and an IBM App Connect installation in a containerized environment, your flows need to communicate by using a switch server and connectivity agents.
A switch server is a special kind of integration server that routes data between the flows. An agentx.json file is used to configure the connectivity agents to connect securely to the switch server.
If you are using an agentx.json file with an integration server that is
deployed in an on-premises system, for secure connectivity between flows deployed in that
integration server and flows running in IBM App Connect on IBM Cloud, you can
migrate that configuration to an integration server in a containerized environment by using the
AgentX configuration type.
If you want to set up connectivity between your integration servers running in an IBM App Connect Enterprise on-premises installation and integration servers running in a
containerized environment with the IBM App Connect Operator, you need to create an instance of a switch
server. When a switch server is created, a
configuration object of type
AgentX is automatically created in the same namespace
with the name
switchServerName-agentx, which can be referenced
when you create an integration server. If you prefer to use an external switch server, you will need
to follow the instructions at iibcreateswitchcfg command. You
can then use the generated agentx.json file to create a configuration of type
An integration server can connect to only one switch server, so you can only use one
configuration of type
AgentX for an integration server. However, multiple
integration servers can connect to the same switch server by using the same configuration object.
- If you are creating the configuration object by using the Red Hat® OpenShift® web console or CLI, you will need to run a Base64 encoder against your agentx.json file and use the output as the value of the spec.data parameter in the configuration custom resource. For more information, see Creating a configuration object.
- If you are using the App Connect Dashboard, you can create the configuration object from the Configuration page or while creating the integration server, as described in Configuration types for integration servers.
For more information about this configuration type, see AgentX type.