View Jitterbit Developer Portal
- Created by Veyanne Berryhill, last modified by Lisa Brown on Jan 27, 2021
Introduction
These system requirements apply to Jitterbit Harmony Private Agents. These requirements are also covered in the installation guides for Private Agents on Linux and Windows systems.
Operating System Considerations and Best Practices
Prior to installation, review Agent Groups High Availability and Load Balancing and these operating system considerations and best practices.
Operating System Considerations
When deciding whether to install a Private Agent on a Linux or Windows operating system, review these considerations:
- Version: All of the Private Agents in a specific Agent Group should be installed on machines using the same operating system and the same operating system version.
- APIs: Linux Agents can accept a higher API load (more requests per minute) than Windows Agents on identical machines when using APIs configured through API Manager.
- Databases: Windows authentication with Microsoft SQL Server is supported only on Windows Private Agents.
- File Shares: Server Message Block version 2 (SMBv2) using the Cloud Studio or Design Studio file share connectors is supported only on Windows Private Agents.
- Microsoft Dynamics: The Microsoft Dynamics connectors (such as the Microsoft Dynamics CRM connector for Cloud Studio and the Microsoft Dynamics AX, CRM, and GP connectors for Design Studio) require Windows Private Agents.
Best Practices
We recommend following these best practices:
Operating System Requirements
Jitterbit requires that operating systems used for Jitterbit Harmony Private Agents meet these specifications: The Linux version of the Jitterbit Harmony Private Agent requires a 64-bit OS. It is supported for these distributions derived from Debian Linux and Red Hat Enterprise Linux for Intel hardware: Debian 8.10 ("jessie"), 9.4 ("stretch"), and 10.6 ("buster") The Windows version of the Jitterbit Harmony Private Agent requires a 64-bit OS and is supported for these versions: Windows 10 NOTE: Jitterbit does not test against or support software versions no longer supported by Microsoft.Linux
The Harmony Private Agent has not been certified against other similar distributions with Debian or RPM package distributions derived from the Debian and Red Hat distributions. Amazon Linux provides multiple Linux versions, of which only Amazon Linux AMI and Amazon Linux AMI 2 have been certified.Windows
Prerequisite Software Requirements
Required Java Version
The Jitterbit Harmony Agent package is bundled with a 64-bit version of the Java 8 Runtime Environment (JRE) and does not require a separate Java runtime. Jitterbit automatically installs the required Java Runtime Environment specifically for Jitterbit to use so that it does not conflict with other Java installations that may already be installed. As of Harmony 9.8, the version of Java shipped with the Agent is the AdoptOpenJDK JRE. This JRE is licensed as described at the OpenJDK website. For the agent to securely communicate with resources such as servers, the Java Runtime Environment used by the agent should be using the Java Cryptography Extension (JCE) with Unlimited Strength Jurisdiction Policy Files. If you are using the JRE that is shipped with the agent, it is using JCE with Unlimited Strength Jurisdiction Policy Files. If you substitute a different JRE for the one shipped with the agent, you will need to replace the policy files included with the JRE with Unlimited Strength Jurisdiction Policy Files, if it is not already using them. To install the Java Cryptography Extension Unlimited Strength Jurisdiction Policy Files:Unlimited Strength Java Cryptography Extension Requirement
local_policy.jar
and US_export_policy.jar
JAR files.<JITTERBIT_HOME>\jre\lib\security
, replacing <JITTERBIT_HOME>
with the path to your Private Agent root directory.
Linux
Linux prerequisites are detailed in Installing a Jitterbit Harmony Linux Agent. In summary, these are required for Private Agent installation on a Linux system:
- Commands: These commands must be available:
python
,sed
,sudo
,tar
,unixodbc
,unzip
. - Libraries: Though a Private Agent must be run on a 64-bit OS, it requires certain 32-bit libraries as specified under Prerequisites in Installing a Jitterbit Harmony Linux Agent.
Windows
The Windows version of the Jitterbit Harmony Private Agent requires: Windows updates: Install all Windows security and "critical" updates prior to installing or upgrading Jitterbit Harmony Private Agents. There are known Microsoft issues when installing on systems that don’t have the latest updates (such as KB2966870 and KB3140245). .NET: Microsoft .NET Framework 4.5 or above may be required. NTFS: The install partition must be NTFS-formatted. Compression: Do not use Windows compression on the Jitterbit folder, PostgreSQL folder, or temp folder on the machine where the Jitterbit Private Agent is installed and running. Using Windows compression will drastically slow down processing of Jitterbit operations and transformations. CAUTION: Jitterbit recommends that a Windows local Administrator account be used to install the agent. WARNING: If installing an agent that is prior to version 10.3, please review Troubleshoot Error 1722 prior to installing the agent.
PostgreSQL Requirements
PostgreSQL is installed as part of the Harmony Private Agent installation. This instance of PostgreSQL is for use only with and by Jitterbit.
- Do not install PostgreSQL separately prior to installing Jitterbit. The Jitterbit installation automatically installs the 64-bit, 9.6.11 version of PostgreSQL with the PostgreSQL 9.3 ODBC driver. (Jitterbit Agent upgrades do not upgrade an existing PostgreSQL installation to this version; they are left as-is.)
- Do not use a plus sign (
+
) as part of the PostgreSQL password when installing a Harmony Private Agent. The maximum number of characters for a PostgreSQL password is eight (8). We recommend that you not use accented characters (such as é) or any of these characters in the PostgreSQL password: +@ $ % & [] {} () , ; ? ^ = !
- Do not have any other databases configured or running on the Jitterbit PostgreSQL instance.
- Do not use the Jitterbit PostgreSQL database/server as part of any Jitterbit operations and transformations.
- Do not use Windows compression on the Jitterbit folder, PostgreSQL folder, or temp folder on the machine where Jitterbit is installed and running. Using Windows compression will drastically slow down processing of Jitterbit operations and transformations.
PgBouncer
may be required for high-load environments. Jitterbit Harmony Linux Private Agent version 10.6 and later and Jitterbit Harmony Windows Agent versions 8.21 and later automatically installPgBouncer
. If you already have an existing installation ofPgBouncer
and experience issues upgrading, please contact support for assistance.
Hardware Requirements
These are the minimum requirements for hardware and virtual machines for Jitterbit Harmony Private Agents: 50 GB available hard drive space; this includes space for the software, parallel processing, and temporary storage that can grow quite large while running an operation Optimal configuration of the system and overall environment; if not optimally configured, sporadic and unpredictable problems can result from poor disk IO, limited/out of memory, limited/out of disk space, power failures, and/or abrupt system restarts Access to outbound port 443 (HTTPS) to communicate with Harmony. Port 443 is normally allowed by corporate server firewalls. It is recommended that the Jitterbit API platform be used for inbound messages or data. Where a Private Agent is used to receive a message directly (such as an outbound message from Salesforce) in lieu of the Jitterbit API platform, then the inbound ports 443 (with SSL) or 46909 (HTTPS) could be opened. Custom ports may be used for specific requirements if they are redefined in the Private Agent configuration and are allowed by any corporate firewall.
Last updated: Jan 27, 2021