AgentX configuration

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 AgentX.

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 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.