AgentA type

Use the AgentA configuration so that an integration runtime can connect to a switch server to enable remote administration.

The agenta.json file

The AgentA configuration provides an agenta.json file that the integration runtime needs to use a switch server and connectivity agents for remote administration. A switch server is a special type of integration server that routes data. Connectivity agents contain the certificates that your flows need to communicate securely with the switch server. An agenta.json file is used to configure the connectivity agents to connect securely to the switch server.

When a switch server is created, a configuration object of type AgentA is created automatically with the name switchServerName-agenta. An integration runtime can connect to one switch server only, so you can select just one AgentA configuration for an integration runtime. However, multiple integration runtimes can connect to the same switch server.

Creating a configuration for the AgentA type by using the configuration panel

To configure your runtime to connect to an external switch server instead of the internal switch server, you can create an AgentA configuration on the Configuration page or when you create a runtime.

  1. Open the Configuration page by clicking the Configuration icon Configuration icon in the navigation pane. Then, click Create configuration. For more information, see Creating configurations on the Configurations page.
  2. From the Create configuration panel, select AgentA from the Type list.
  3. In the Name field, specify a name for this configuration.
  4. In the Description field, specify text that might help you identify the external switch server that is being used.
    Create configuration panel
  5. Complete the AgentA section by completing either of the following steps:
    • Copy the contents of your generated agenta.json file and then paste it into the AgentA text editor.
      AgentA text editor with pasted contents
    • Import your generated agenta.json file from your file system:
      1. Click the Import agenta file icon Import icon.
      2. Click within the boxed area to select the file from a file browser, or drag-and-drop the file.
        Import agenta view

        The name of the imported file is displayed.

      3. If you want to view the file contents, click View file contents to return to the text editor.
        AgentA text editor with imported contents
    Tip: For security reasons, the agenta.json content that you add is available only as REDACTED content after you create the configuration. If you need to update this configuration later, you must upload another agenta.json file.
  6. Click Create. The configuration is added to the configurations table, where you can select it to use with an integration runtime.

Updating or deleting a configuration

If you need to update the content or settings in a configuration, or delete a configuration that's no longer needed, see Creating configurations on the Configurations page.