Release notes for Jitterbit private agents

Introduction

This page provides a compilation of updates in recently released private agent versions. Updates to the private agent are also identified on individual release pages in Release notes.

For end-of-life releases not shown here, see Past Harmony releases.

Known issues

See Private agent known issues.

Release notes

A subset of Harmony release updates pertaining to private agents is included below.

12.4

The 12.4 release date for private agents is by region:

The release notes will be published on this page prior to the release.

11.59 / 12.3

The 11.59 / 12.3 release date for private agents is by region:

Enhancements

• Improved performance and security
  Version 12.3 private agents include performance and security enhancements. These enhancements are not included in version 11.59, which is the final planned release for 11.x private agents. You can upgrade directly from an 11.x private agent to 12.3 (or later 12.x versions) using our upgrade instructions (Windows, Linux, or Docker).

  Actions required: Plugin updates and verification of custom connectors for 12.x private agents

  • Plugin updates for 12.x private agents
    Performance and security enhancements for 12.x private agents are incompatible with the Multipart Pipeline and AWS S3 Create Plugins. If you use these plugins, user action is required as described under Notices.

  • Verification of custom connectors for 12.x private agents
    Connector SDK connectors that are provided by a third party must undergo development changes to be compatible with 12.x private agents. Before upgrading to 12.x private agents, verify compatibility with the connector developer, or operations using those connectors will begin failing at the time of upgrade.

• Private agent settings to mask custom request headers in logs
  A new [Masking] section in the private agent configuration file (jitterbit.conf) allows you to mask custom request headers in Studio HTTP activities and Design Studio HTTP sources and targets within runtime logs. Applies to both 11.59 and 12.3 private agents.

• Endpoints Usage proxy support
  The Management Console Endpoints Usage page now reports endpoint usage for private agents communicating via a proxy server. Applies to both 11.59 and 12.3 private agents.

• Improved agent sync error handling
  Agents now handle errors during sync operations more reliably, preventing database conflicts that could result in deadlocks. Applies to both 11.59 and 12.3 private agents.

• Salesforce connector support for OAuth 2.0
  Jitterbit's Salesforce connectors now support using 2-legged OAuth 2.0:

  • Studio: A Salesforce connection has a new Authentication type menu where you select Basic Auth (default existing) or OAuth 2.0 Client Credentials (newly supported with agent version 11.59 / 12.3 or later). See OAuth 2.0 prerequisites.
  • Design Studio: A Salesforce Org has a new Select OAuth 2.0 Client Credentials checkbox that requires both Design Studio version 11.59 or later and agent version 11.59 / 12.3 or later. See OAuth 2.0 prerequisites.

• Salesforce API version 65 support for Design Studio
  The Design Studio Salesforce connector now supports Salesforce API version 65 with the use of both Design Studio version 11.59 or later and agent version 11.59 / 12.3 or later. When both these version requirements are met, an API upgrade dialog is shown when opening existing projects using this connector. New projects automatically use Salesforce API version 65 and must be configured with OAuth 2.0 authentication.

  Basic authentication no longer supported by Salesforce

  Starting with Salesforce API version 65, Salesforce no longer supports SOAP API login (basic authentication). To ensure continued operability with Design Studio Salesforce Orgs configured to use basic authentication, do not accept the prompt to upgrade your existing Design Studio projects to Salesforce API version 65. Before upgrading projects to Salesforce API version 65, you must reconfigure your Salesforce endpoints with the new Select OAuth 2.0 Client Credentials configuration option or your operations will fail.

• Improved GetJSONString function with support for error handling
  The new GetJSONStringEx function, accessible in the JSON category of the Studio script component palette's Functions tab, has the same behavior as the GetJSONString function with added support to return a customizable value when a path doesn't match. This function requires agent version 11.59 / 12.3 or later and can also be used with Design Studio version 11.59 or later.

Fixes

• Windows private agent PostgreSQL fixes
  Two fixes have been made to improve stability of the PostgreSQL service on both 11.59 and 12.3 Windows private agents:

  • When upgrading, entering an incorrect PostgreSQL service account password at the installer prompt now shows a validation error and allows re-entry. Previously, this could cause the upgrade to fail without rolling back. If you have already encountered this issue, see recovery steps.
  • Fresh installations now correctly set a dependency on the PostgreSQL service for agent services, preventing agent services from starting before PostgreSQL is ready.

Notices

• Retirement of 11.x private agent versioning
  This release includes the final 11.x private agent version (11.59) and the first available 12.x private agent version (12.3). Note the following regarding future releases:

  • Final 11.x version: 11.59 is the final planned 11.x private agent version. The next version following 11.59 will be 12.4, and all future enhancements, new features, and security updates will be delivered through 12.x private agents. While 11.x agents may receive rare critical fixes for production-impacting issues, no ongoing releases are planned.

  • Recommendation: We strongly recommend upgrading to 12.x private agents, starting with 12.3, as soon as possible to benefit from the latest performance, security, and feature improvements.

  • Upgrade path: You can upgrade directly from 11.x to 12.3 (or later 12.x versions) using our documented upgrade instructions: Windows, Linux, or Docker.

• End of life for version 11.41
  As of April 4, 2026, private agent version 11.41 has reached end of life and is no longer supported.

  We recommend that users of these versions upgrade to the latest version as soon as practicable.

• Action required: Plugin updates for 12.x private agents
  Performance and security enhancements for 12.x private agents are incompatible with the following plugins. New, compatible versions of these plugins are already available:

  Plugin name	Incompatible versions	Required version
  Jitterbit Multipart Pipeline Plugin (deprecated)	1.0.9.0 1.0.8.0	1.0.10.0
  Jitterbit AWS S3 Create (deprecated)	1.0.1.0 1.0.0.0	1.0.2.0

  Before you upgrade to 12.x private agents, you must complete the required user action, or operations will begin failing at the time of upgrade. The new plugin versions are backward-compatible with 11.x agents, so you can update the plugins at any time.

  Required user action

  You must replace any existing uses of the incompatible plugin versions with the new, required versions:

  1. (Private agents only) Associate the new plugin version to the private agent group in the Management Console Customizations > Plugins page.
  2. Unassign the incompatible plugin from the activity in your Studio or Design Studio projects.
  3. Assign the new, compatible version.
  4. Test and deploy the operation.

11.58

The 11.58 release date for private agents is by region:

Enhancements

• New Jitterbit variable to disable flat-to-XML normalization
  The new Jitterbit variable jitterbit.transformation.flat_to_xml.disable_normalization can be set to true upstream of a transformation that has a flat source and an XML target to make it so if the flat file contains duplicate rows, all of them will be mapped. This feature requires agent version 11.58 or later.

Changes

• PgBouncer default port changed
  The pgbouncer connection pooler bundled with the Windows private agent now uses a default port of 6434 for fresh installs. Upgrades from a previous agent version will continue to use the configured port (by default: 6432).

Notices

• End of life for version 11.40
  As of March 13, 2026, private agent version 11.40 has reached end of life and is no longer supported. We recommend that users of these versions upgrade to the latest version as soon as practicable.

11.57

The 11.57 release date for private agents is by region:

Fixes

• NetSuite connector custom fields now present for InterCompanyTransferOrder
  Studio and Design Studio NetSuite connector activity schemas now include transaction body custom fields for the InterCompanyTransferOrder object as expected. To apply this fix for an existing activity, you must regenerate its schemas.

Notices

• End of life for version 11.39
  As of February 20, 2026, private agent version 11.39 has reached end of life and is no longer supported. We recommend that users of this version upgrade to the latest version as soon as practicable.

11.56

The 11.56 release date for private agents is by region:

Enhancements

• Apache server and Tomcat upgrades
  The Apache server and Tomcat versions used by agents have been upgraded to improve security and performance.

Fixes

• FTP Write activity rename option now honored
  The Use FTP Rename option in a Studio FTP Write activity now renames files as expected. Previously, files weren't being renamed with a temporary name during the file transfer. Note that this setting is honored for both FTP and SFTP writes.

Notices

• End of life for version 11.38
  As of February 6, 2026, private agent version 11.38 has reached end of life and is no longer supported. We recommend that users of this version upgrade to the latest version as soon as practicable.

11.55

The 11.55 release date for private agents is by region:

Enhancements

• jitterbit utility improved command syntax and ability to reload Apache
  A Linux or Docker private agent's jitterbit utility program no longer requires underscores in service operation commands. In addition, it has a new reload apache command to reload the Apache service.

Notices

• End of life for version 11.37
  As of January 16, 2026, private agent version 11.37 has reached end of life and is no longer supported. We recommend that users of this version upgrade to the latest version as soon as practicable.

11.53

The 11.53 release date for private agents is by region:

Fixes

• GetSource functions now work with flat files
  Studio and Design Studio dictionary and array functions that begin with GetSource (GetSourceInstanceArray, GetSourceAttrNames, etc.) now work as expected with flat files.

• CallStoredProcedure function now works without parameters
  The Studio and Design Studio CallStoredProcedure function now works with the Oracle and Microsoft SQL Server JDBC databases when using stored procedures that do not use inputOutputVariable parameters.

11.52

The 11.52 release date for private agents is by region:

Enhancements

• NetSuite connector expanded limit for custom fields
  An Integration Studio NetSuite connection's Optional settings has a new Enable NetSuite Pagination checkbox. When selected, you can increase the pagination limit to up to 2000, which allows a NetSuite Search activity to retrieve more than the existing default of 1,000 custom fields. This setting requires agents version 11.52 or later.

Fixes

• Improved security
  The PostgreSQL database bundled with the private agent and the asynchronous HTTP client library have been upgraded to address security vulnerabilities.

• Log timestamp corrected
  In jitterbit-agent.log, the timestamp reported in the AgentHealthCheckController response for when the cloud status was last updated has been corrected.

• Java heap size changes now persist on upgrade
  The Java heap size no longer resets to default values when upgrading a Windows private agent.

Notices

• End of life for version 11.34
  As of November 7, 2025, private agent version 11.34 has reached end of life and is no longer supported. We recommend that users of this version upgrade to the latest version as soon as practicable.

11.51

The 11.51 release date for private agents is by region:

Fixes

• Automatic canceling and re-running of stuck scheduled operations
  If an agent becomes stopped for any reason, scheduled operations assigned to it are now automatically canceled and immediately recreated on an active agent in the group. (If the agent is the only one in a group, operations eventually time out and fail.) This resolves an issue where operations could become "stuck" in the status they were in when an agent became stopped.

Notices

• End of life for version 11.33
  As of October 17, 2025, private agent version 11.33 has reached end of life and is no longer supported. We recommend that users of this version upgrade to the latest version as soon as practicable.

11.50

The 11.50 release date for private agents is by region:

Fixes

• NetSuite Search activity configuration issue fixed
  Configuration of a NetSuite Search activity with a search type of Saved Search with result fields as output now works as expected when the account number is used in uppercase within the saved search URL. Previously, the Next button was not functioning.

Notices

• End of life for version 11.32
  As of September 26, 2025, private agent version 11.32 has reached end of life and is no longer supported. We recommend that users of this version upgrade to the latest version as soon as practicable.

11.49

The 11.49 release date for private agents is by region:

Enhancements

• NetSuite connector search type for returning saved search fields as output
  A NetSuite Search activity has a new search type, Saved Search with result fields as output, available to select in activity configuration step 2. The new search type requires agents version 11.49 or later and a deployed Suitelet script to fetch the metadata needed to limit the response schema fields.

• Endpoints Usage (Beta) reporting
  The Dashboard page's Licensing vs Actual Usage tile now reports the number of licensed endpoints compared with how many unique endpoints have been used in the current month on agents 11.49 or later in a production-class environment. Unique endpoints are determined by their Endpoint unique identifier values, shown on the new Endpoints Usage (Beta) page, where you can also see month-by-month usage.

  Agents version 11.49 or later are required for endpoints usage reporting. When upgrading to an 11.49 or later agent from an earlier version, you are notified that Connector SDK-based connectors will be updated to the latest version.

  To provide beta feedback, contact the Jitterbit Product Team.

Notices

• End of life for version 11.31
  As of September 5, 2025, private agent version 11.31 has reached end of life and is no longer supported. We recommend that users of this version upgrade to the latest version as soon as practicable.

11.48

The 11.48 release date for private agents is by region:

Enhancements

• Environment variable for the auto-registration token
  The private agent auto-registration file now has an equivalent environment variable to set the private agent access token: AUTO_REGISTER_TOKEN.

Notices

• End of life for version 11.30
  As of August 15, 2025, private agent version 11.30 has reached end of life and is no longer supported. We recommend that users of this version upgrade to the latest version as soon as practicable.

11.47

The 11.47 release date for private agents is by region:

New features

• Agent observability metrics
  Private agent observability metrics for both native monitoring and third-party platforms are now generally available:

  • Native monitoring: Once configured and enabled, shows agent metrics in the Metrics tab of the Management Console Agents page.
  • Datadog or Elasticsearch: Shows agent metrics in your configured observability platform.

Enhancements

• Salesforce API version 64 support
  Salesforce API version 64 is now supported for these connectors:

  • The Integration Studio Salesforce, Salesforce Service Cloud, and ServiceMax connectors automatically use this API version with 11.47 or later agents.
  • The Design Studio Salesforce connector supports this API version with the use of both 11.47 or later agents and an 11.47 or later version of Design Studio. When both these version requirements are met, an API upgrade dialog is shown when opening existing projects using this connector.

Notices

• End of life for version 11.29
  As of July 25, 2025, private agent version 11.29 has reached end of life and is no longer supported. We recommend that users of this version upgrade to the latest version as soon as practicable.

11.46

The 11.46 release date for private agents is by region:

Fixes

• DebugBreak now jumps from parent to child script as expected
  When running a script that calls another script containing the DebugBreak function, Design Studio now jumps to the breakpoint as expected. The issue was limited to using the macOS version of Design Studio with cloud agents or Linux private agents.

Notices

• End of life for version 11.28
  As of July 4, 2025, private agent version 11.28 has reached end of life and is no longer supported. We recommend that users of this version upgrade to the latest version as soon as practicable.

11.45

The 11.45 release date for private agents is by region:

Enhancements

• Microsoft Entra authentication for Microsoft SQL Server
  Microsoft Entra authentication is now supported with the SQL Server Microsoft JDBC driver in an Integration Studio Database connection or a Design Studio Database source or target.

• Windows quiet installer support for private agent monitoring
  Quiet Windows private agent installations can now have Jitterbit private agent metrics (native observability) automatically enabled when the new parameter $Organization_id is set in the config64.ps1 file.

Fixes

• JSONStringify support for null data and reserved JSON characters
  The JSONStringify function now handles null data and reserved JSON characters such as " and \ as expected.

  Warning

  If you previously implemented a workaround to escape reserved JSON characters, you must make updates to accommodate this fix or your operations dependent on this function may stop functioning as expected.

• Wildcard proxy exclusions now honored
  Wildcards (* or ?) included a private agent's proxy exclusion list (set by the jitterbit-utils --set-http-proxy-exceptions option) are now supported.

• FTP files no longer have unexpected prefixed timestamps
  In certain scenarios, files retrieved using the Integration Studio FTP connector or Design Studio FTP source no longer have unexpected timestamp prefixes requiring a workaround using the Jitterbit variable jitterbit.source.ftp.enable_regex_parser.

• Salesforce Bulk operations issue fixed
  A database error has been resolved with operations that use Bulk activities provided by the Integration Studio Salesforce, Salesforce Service Cloud, or ServiceMax connectors or the Design Studio Salesforce Bulk Process Wizard.

• Salesforce erroneous SOAP fault fixed
  An issue has been resolved with Salesforce operations where the operation status could report a SOAP fault when none occurred.

Notices

• End of life for version 11.27
  As of June 13, 2025, private agent version 11.27 has reached end of life and is no longer supported. We recommend that users of this version upgrade to the latest version as soon as practicable.

11.44

The 11.44 release date for private agents is by region:

Enhancements

• API system variable support for null processing
  The Jitterbit variable jitterbit.api.response, used to set an API Manager API's response when System Variable is selected in the API configuration, now supports the processing of null values when the new Jitterbit variable jitterbit.api.response.enabled_null_support is set to true before the API response variable is set.

  It can be used in combination with the jitterbit.scripting.hex.enable_null_support variable and HexToString and Base64Decode functions to send a Base64-encoded PDF that contains null characters as the API response. Previously, the API variable response was truncated, which remains the default behavior.

• PostgreSQL upgrade
  The PostgreSQL database server included with private agents has been upgraded.

• MySQL JDBC driver upgrade
  The version of the MySQL JDBC driver that can be used by Integration Studio or Design Studio database connections is now 8.4.0.

Fixes

• Design Studio Salesforce chunking issue resolved
  Design Studio Salesforce Update operations with chunking enabled no longer fail under a unique set of circumstances.

Notices

• End of life for version 11.26
  As of May 23, 2025, private agent version 11.26 has reached end of life and is no longer supported. We recommend that users of these versions upgrade to the latest version as soon as practicable.

  Important

  Private agent version 10.87 was the last 10.x agent version distributed by Jitterbit and is now end of life. To continue to receive private agent updates, including new features, enhancements, security patches, and fixes, upgrading to an 11.x private agent is required.

  Follow the instructions to upgrade from 10.x to 11.x agents:

  • Windows agent upgrade instructions (requires a complete uninstall)

  • Linux agent upgrade instructions

11.43

The 11.43 release date for private agents is by region:

Enhancements

• Jitterbit private agent metrics (Beta)
  Private agent monitoring can now be done directly within the Management Console (in addition to existing beta functionality via third-party observability platforms). To provide feedback on these beta features, contact the Jitterbit Product Team.

  • The Management Console Agents page has a new Metrics (Beta) tab that reports agent and agent group metrics such as health, capability, and data on each of an agent's services.

  • The Management Console Dashboard page has a new Agents Health (Beta) tile that shows a summary of agent health.

  • The Management Console Access Tokens page has an Agent Metric scope used to set a default access token for each Harmony organization. (Generating an additional metrics access token is required only if you use auto-registered private agents.)

  • A private agent's jitterbit.conf configuration file has a new [AgentMetrics] section to configure the Jitterbit metrics service. To start generating metrics, you must set these parameters for every private agent you want to monitor.

  • Additional supporting agent changes, such as new commands in a private agent's jitterbit utility program, metrics.log and metrics_service.log log files, Docker agent ENABLE_JITTERBIT_METRICS environment variable, and Docker agent register.json file agentMetricsToken field.

Fixes

• IfNull and IsNull functions now have expected behavior
  When the Jitterbit variable jitterbit.target.xml.include_nil_attribute is set to true upstream of the IfNull or IsNull functions, the functions will evaluate an empty string as a non-null value.

Notices

• End of life for versions 10.87 / 11.25
  As of May 2, 2025, private agent versions 10.87 and 11.25 have reached end of life and are no longer supported. We recommend that users of these versions upgrade to the latest version as soon as practicable.

• Private agent versions 10.x are no longer updated
  Private agent version 10.87 was the last 10.x agent version distributed by Jitterbit and is intended to be the final supported 10.x agent version.

  Since Harmony release 10.63 / 11.1, both a 10.x and 11.x private agent version had been distributed with these differences:

  • 11.x versions: In 11.1 and later versions, the PostgreSQL database bundled with the private agent has been updated.

  • 10.x versions: Supported 10.x versions are packaged with an older version of PostgreSQL. The distributed 10.x versions will continue to be supported in accordance with Jitterbit's end-of-life policy.

  Important

  To continue to receive private agent updates, including new features, enhancements, security patches, and fixes, upgrading to an 11.x private agent is required.

  Follow the instructions to upgrade from 10.x to 11.x agents:

  • Windows agent upgrade instructions (requires a complete uninstall)

  • Linux agent upgrade instructions

11.42

The 11.42 release date for private agents is by region:

Enhancements

• Support for OpenSSL 3 AES compatibility
  Jitterbit scripts in Integration Studio and Design Studio now support OpenSSL 3 AES encryption and decryption by using either the new functions AESEncryptionEx/AESDecryptionEx or by setting the new Jitterbit variable jitterbit.scripting.aes.default to true upstream of the existing AESEncryption/AESDecryption functions.

Notices

• End of life for versions 10.86 / 11.24
  As of April 11, 2025, private agent versions 10.86 and 11.24 have reached end of life and are no longer supported. We recommend that users of these versions upgrade to the latest version as soon as practicable.

• Private agent versions 10.x are no longer updated
  Private agent version 10.87 was the last 10.x agent version distributed by Jitterbit and is intended to be the final supported 10.x agent version.

  Since Harmony release 10.63 / 11.1, both a 10.x and 11.x private agent version had been distributed with these differences:

  • 11.x versions: In 11.1 and later versions, the PostgreSQL database bundled with the private agent has been updated.

  • 10.x versions: Supported 10.x versions are packaged with an older version of PostgreSQL. The distributed 10.x versions will continue to be supported in accordance with Jitterbit's end-of-life policy.

  Important

  To continue to receive private agent updates, including new features, enhancements, security patches, and fixes, upgrading to an 11.x private agent is required.

  Follow the instructions to upgrade from 10.x to 11.x agents:

  • Windows agent upgrade instructions (requires a complete uninstall)

  • Linux agent upgrade instructions

Past releases

For releases not shown here, see Past Harmony releases and the Jitterbit Documentation Archive site.