The Agent Groups page of the Web Management Console (WMC) allows you to group Jitterbit Agents (runtime servers) so that each Agent in the group behaves consistently with other Agents in the group.

Agent Groups provide for high availability and load balancing of integration operations across Agents within a group. Installing more than one Agent in an Agent Group automatically allows for high availability (active/active). Installing multiple Agents in an Agent Group also automatically allows for load balancing.

By default, a Cloud Agent Group will already be set up when an Organization is created. If you wish to use one or more Local Agent Groups, you will need to set these up for your Organization using the instructions on this page.

NOTE: When you create Local Agent Groups, you will also need to associate them with an Environment. For more information, see Environments.

Access the Agent Groups page from Menu > Agents > Agent Groups.

NOTE: Make sure you are accessing the desired Organization. In the top navigation bar, use the dropdown that appears to the right of your name and to the left of the Help menu to toggle between Organizations.

Managing Agent Groups

Administrators of the Organization manage the Agent Groups for that Organization.

View Agent Groups

The top section of the Agent Groups page contains a table that shows all the Agent Groups for your Organization. 

There are two types of Agent Groups:

Initially, you will see the Jitterbit Cloud Agent Group, which is set up by default. Note that there is only one Cloud Agent Group needed; you cannot add additional Cloud Agent Groups or Cloud Agents. There is also nothing available to edit within the Cloud Agent Group, as Cloud Logging will always be enabled (logs viewable from the Menu > Activities page). You can also sort the table by clicking on any of the column headers.

To add and edit Local Agent Groups, follow the instructions in the next sections.

NOTE: At least one Environment must be created and associated with the selected Agent Group before you will be able to run a project. See Environments for additional information.

Add Agent Groups

To add a new Local Agent group, click the  button. Fill out the prompt as follows:

Your new Agent Group should now appear in the table of Agent Groups.

NOTE: You may be limited to the number of Agent Groups you can create based on your subscription plan. If you require more Agent Groups, please contact your Client Success Manager.

Edit or Remove Agent Groups

On the far right of each Local Agent Group row is an Action dropdown showing the actions you can take for each Local Agent Group. 

NOTE: You cannot view or edit the Jitterbit configuration file for the Jitterbit Cloud Agent Group.

View or Edit Jitterbit Conf

On the far right of each Local Agent Group row is an Action dropdown showing the actions you can take for each Local Agent Group.

The action Jitterbit Conf will be available only if the following conditions are met:

Choose Jitterbit Conf to view the current settings of the jitterbit.conf file in table format. There are two tabs available:

To make changes to the jitterbit.conf file, click the Edit or Add buttons in the top right. A confirmation message will appear with the following notification:

If you click OK, current Agent configuration (excluding the local Postgres Cache Database information and local predefined global variables) will be read and stored in the cloud so that you can view and edit them remotely. Please make sure your company policy allows for this action and that there was no proprietary information stored in the configuration files prior to this. Click Cancel now, if you prefer to edit the configurations directly on the servers.

NOTE: If you do not wish to store the contents of your jitterbit.conf file in the cloud via the Web Management Console, but would still like to make changes to the configuration file, you can do so manually. Please refer to to Editing the Configuration File - jitterbit.conf.

Click OK on the confirmation message to continue. Fields that you can make changes to now become available for you to edit. When you are done, choose one of the following:

NOTE: Viewing and editing the jitterbit.conf configuration file is available only at the Agent Group level, not at the Agent level. This is because all individual Local Agent configuration files should be identical.

NOTE: You cannot view or edit the Jitterbit configuration file for the Jitterbit Cloud Agent Group.

Managing Available Agents

The Available Agents tab in the bottom portion of the page shows each Agent associated with a selected Agent Group.

View Available Agents

The bottom section of the Agent Groups page contains a tab for Available Agents. This table will display all Local Agents for the Local Agent Group selected in the top portion of the page.

In this table, you can see information about each Local Agent including IP address, operating system, version, status, and available actions you can take. You can also sort this table by clicking on any of the column headers.

Add Agents or Download Agent Software

To add a new Local Agent to your selected Local Agent Group, click the  button. In the popup, enter a name for your new Agent.

You should now see your new Local Agent listed in the table of Available Agents. By default, it will have a status of "Unregistered" and will not be available for runtime processing until you download and install the Agent software on the Local Agent.

Prior to downloading and installing Local Agents, please review the following:

To download the Agent software, use the Action dropdown on the far right and select the appropriate download option for your system.

For further instructions on downloading and installing Local Agents, see the following:

NOTE: You can also add Agents and download Agent software via the Agents page. If added from the Agents page, you will also need to select the Local Agent Group that you want to associate the new Local Agent with.
NOTE: You may be limited to the number of Agents you can create based on your subscription plan. If you require more Agents, please contact your Client Success Manager.

Edit or Remove Agents

To edit or remove Local Agents, use the Action dropdown on the far right. These options will be disabled if your Agent is currently in "Running" status. The Agent must be either "Stopped" or "Unregistered" in order to edit or remove the Agent.

Stop Agent or Download Agent Logs

To stop the Local Agent or download Agent logs, use the Action dropdown on the far right. These options will be disabled if your Agent is currently in "Stopped" or "Unregistered" status. The Agent must be in "Running" status in order to stop the Agent or download Agent logs.