The Agents page of the Management Console allows you the option to set up Private Agents (formerly known as Local Agents) as on-premises runtime servers that execute your integration operations. All agents in an Agent Group will be synchronized the same way so that they execute operations consistently. When you create Private Agents, you will also need to associate them with a Private Agent Group. For more information, see Agents > Agent Groups.
To access the Agents page, log in to the Jitterbit Harmony Portal, then click the Harmony Portal menu in the top left:
From the menu, hover over Management Console > Agents and select Agents:
NOTE: Make sure you are accessing the desired organization. In the top navigation bar, use the dropdown that appears between your name and Help to switch between organizations.
Administrators of the organization manage the agents for that organization.
The top section of the Agents page contains a table that shows all of the Private Agents (formerly known as Local Agents) within the organization:
This table displays information about each Private Agent, including its IP address, operating system, agent version, agent status, and the available actions you can take. You can sort this table by clicking on any column header with the exception of the Action header.
Viewing Conflicts with the Jitterbit Configuration File
If you have remote agent configuration enabled (Organizations page under Actions > Edit Organization Policies) and there is a conflict between the remote agent configuration and local agent configuration file, you will see icons next to a Private Agent name.
Note that if remote agent configuration is enabled, then the remote agent configuration file overrides any settings in the local agent
jitterbit.conf configuration file. Thus, these warnings are provided for your information only, and may be expected in circumstances such as when you have made changes to the configuration file remotely via the Agents > Agent Groups page.
- Hover over the icon to see a short description of conflicting values.
Click on theicon to view the detailed description of any conflicting values.
WARNING: When you enable remote agent configuration, the current agent configuration (excluding the local PostgreSQL cache database information and local predefined global variables) will be read and stored in the cloud so that you can view and edit it remotely. Once you enable remote agent configuration, any changes you make manually to the local
jitterbit.conf file located on the agent will not take effect.
If you wish to disable remote agent configuration and again be able to edit the local
jitterbit.conf file manually, you can do so on the Organizations page under Actions > Edit > Organization Policies by unchecking the Enable remote Agent configuration checkbox. However, note that you will lose the current remote agent configuration that was stored in the cloud. After agent services are restarted, your agent will read from the local
Adding Agents and Downloading Agent Software
To add a new Private Agent, click. In the Add Agent dialog box, enter a name for your new agent, and use the Associate Group dropdown to select an existing Private Agent Group you would like to associate with your new Private Agent.
If you do not yet have an existing Private Agent Group you would like to associate, click Agents > Agent Groups.to display the Add Agent Group dialog box where you can enter a name for your new Agent Group, an optional description, and choose whether to enable Cloud Logging. For more information about this option, see
You should now see your new Private Agent listed in the table of 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 Private Agent.
Prior to downloading and installing Private Agents, please review these pages:
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 Private Agents, see these pages:
You can also add agents and download agent software via the Agents > Agent Groups page.
Editing and Removing Agents
To edit or remove a Private Agent, 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.
- Choose Edit to change the name of your Private Agent.
- Choose Remove to delete the Private Agent from the organization.
Stopping Agents and Downloading Agent Logs
To stop the Private Agent or to 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 to download agent logs.
Choose Drain Stop to stop the Private Agent. The agent continues processing existing operations but refuses to accept new ones. When an agent drain stop is initiated, the agent waits 180 seconds for any APIs to finish running before the drain stop is completed. For Private Agents, the wait time can be configured within the
jitterbit-agent-config.propertiesfile by setting
agent.drainstop.api.waitequal to the desired number of seconds.
NOTE: If you use Drain Stop, make sure you have access to the Private Agent if you would like to restart the agent later. The agent cannot be restarted remotely from the Management Console and must be done manually on the Private Agent.
- Choose Download Agent Log to open a prompt to select logs for detailed troubleshooting and auditing purposes. Check the logs you wish to download and click Submit to begin the download.
These logs can either be accessed via the Management Console as shown above or be stored on local file storage devices such as file shares or SFTP and accessed from within a firewall. The Agent Groups and agents do not automatically synchronize these with the cloud, as they typically include business data. By using your own storage devices, you can keep that data within a firewall or private cloud infrastructures.
By default, an Agent Group will store logs for 1 to 14 days depending on the type of log. The Agent Group can be configured to clean up this data at other intervals using the
CleanupRules defined in the agent home installation directory. See Cleaning Up Drive Space.
Drain Stop Status
Drain Stop status is reported in the agent log. The log includes each phase of the stopping of the agent, the operations still running, and other details. The default Windows location for the agent log is
C:\Program Files (x86)\Jitterbit Agent\log. The default Linux location for the agent log is
Open the agent log and search for entries with
Drainstop (one word) or
drain stop (two words) as seen here:
Viewing Installed Plugins
Plugins are available to any agent within the Agent Group. This is in order to synchronize all plugins across an Agent Group. For more information on Jitterbit-provided plugins or to add custom plugins, see Customizations > Plug-ins.
The bottom section of the Agents page contains a tab for Installed Plug-ins. This table displays all plugins for the Private Agent selected in the top portion of the page:
In this table, you can see a description of the plugin, the author, version, type, and available actions you can take. You can also sort this table by clicking on any column headers except Action.
Viewing Manifest Files
To view the manifest file associated with a particular plugin, use the Action dropdown on the far right:
The XML file should display or download.