Skip to Content

11.31 Harmony release notes

11.31 Harmony release

This page includes release notes for all generally available components being released as part of 11.31. Compilations of release notes for Production Cloud Agent Groups, Sandbox Cloud Agent Groups, and private agents are also available.

The 11.31 release is staggered based on the dates and times as listed below by component and region. For a more detailed explanation of the release cadence by component category, see the release schedule.

You can subscribe to maintenance notifications for web-based components at Jitterbit Trust. Locally installed components are available from the Downloads page (except for the Docker private agent and Docker private API gateway, which are available at Docker Hub). The end-of-life date for these components is one year after the release date.

11.31 Sandbox Cloud Agent Group (SCAG)
SDK connectors on 11.31 SCAG
11.31 cloud and private API gateway
Cloud platform and applications
11.31.1 Production Cloud Agent Group (PCAG)
11.31.1 Sandbox Cloud Agent Group (SCAG)
SDK connectors on private agents and PCAG
11.31.1 Windows and Linux private agents
11.31.1 Docker private agent
11.31 Docker private API gateway
11.31.2 Linux private agent
11.31.2 Docker private agent
APAC August 27, 2024 (12 - 4 AM AEST) September 6, 2024 (2 - 8 PM AEST) September 5, 2024 (8 PM AEST) September 10, 2024 (7 AM AEST)
EMEA August 27-28, 2024 (9 PM - 1 AM CEST) September 10, 2024 (6 AM - 12 PM CEST) September 5, 2024 (12 PM CEST) September 9, 2024 (11 PM CEST)
NA August 28, 2024 (12 - 4 PM PDT) September 4-5, 2024 (9 PM - 3 AM PDT) September 5, 2024 (3 AM PDT) September 9, 2024 (2 PM PDT)

Known issue with Linux private agents 11.31.1 and all earlier versions

Scheduled operations fail to run after a Linux private agent restart

  • Summary: After restarting a Linux private agent, the agent's Scheduler service fails to start, causing scheduled operations not to run as expected. This issue does not occur with Windows private agents.

  • Additional Information: The Linux agent's Scheduler service uses a library that downloads the latest time zone data files. As of September 4, 2024, the provider of this library introduced a syntax error that causes the Scheduler service not to start.

  • Recommendation: This issue is resolved with version 11.31.2, which no longer automatically downloads the library causing the issue. We recommend upgrading Linux private agents to 11.31.2 or later to prevent this issue from occurring and, in cases where it is already occurring, to recover from it.

    Alternatively, if you are using an earlier agent version, you can apply the following workaround or recovery steps to non-Docker agents:

    • Workaround: If a Linux private agent has not yet been restarted, to prevent this problem from occurring, edit the version file at /opt/jitterbit/TimeZoneDB/version and change its value to 2024b. This will prevent the version of the date library with the issue from being downloaded by the agent.

    • Recovery: If a Linux private agent is already experiencing this issue, to fix it, edit the northamerica file at /opt/jitterbit/TimeZoneDB/northamerica to replace the value April with Apr in any occurrences. Then restart the agent.

Enhancements

API gateway

  • Ability to disable hyphen replacement in proxy API headers
    You can now prevent hyphens in proxy API headers from being replaced with underscores. When using an API gateway version 11.31 or later, in step 4 of proxy API configuration under Request Headers, set the key disable-hyphen-replacement to true. The default behavior (false) is to replace hyphens with underscores.

API Manager

  • Warning when disabling SSL
    When clearing the checkbox SSL Only (selected by default) for an API, a message now warns users they are enabling HTTP and asks for confirmation that they understand the risks of switching to an unsecure protocol.

Cloud Studio

  • Project history usability improvement
    The time range shown in the project history is now chronological, in the order of earliest to latest time.

  • Project design UI (beta) improved selection and highlighting
    The redesigned project design UI (beta) has improved visual states of selected and highlighted components.

Cloud Studio SDK connectors

  • Gzip connector support for tar.gz files
    The Gzip Decompress and Compress activities have these new Optional settings checkboxes: Decompress tar.gz file and Compress tar.gz file. Previously, only .gz files were supported.

  • HTTP v2 connector enhancements
    The following enhancements have been made to the HTTP v2 connector:

    • In a connection under Optional settings, when the new checkbox Get response content in base64 string is selected, the responseContent returned from any HTTP v2 activity will be base64-encoded.

    • In a connection under Optional settings > Advanced HTTP Properties, a new Encode Request URL checkbox can be used to enable encoding of the URL path and query parameters.

    • In a PATCH, POST, or PUT activity, when Multipart is selected, the default request schema now includes a Content-Type field in the node of a specific plain-text part in the multipart.

    • In a HEAD, GET, PATCH, POST, PUT, DELETE, HEAD, or OPTIONS activity, when Continue on error is selected and an error status code is returned, the default response schema now includes a statusMessage field in the error node to record the error message from the API.

  • Microsoft Azure Key Vault (beta) connector enhancements
    The following enhancements have been made to the Microsoft Azure Key Vault (beta) connector:

  • Microsoft Teams connector ability to set scope
    A Microsoft Teams connection now has an Optional settings > Scope field to allow you to restrict access to the minimum set of permissions for your use case.

  • OpenAI model GPT-4o support
    An OpenAI Prompt activity’s Model menu now has GPT-4o as a selection.

  • SAP Concur support for API v4.0 and trailing slash
    An SAP Concur connection’s Version menu now has SAP Concur API v4.0 as a selection. In addition, the Host value can now have a trailing slash.

Management Console

  • Agents page enhancements
    The following enhancements have been made to the Agents page:

    • The Agents tab now has an ID column that shows each agent’s ID.
    • An agent with Starting status can now be deleted.
  • Runtime Operations page highlighting with wildcard search
    Search results on the Runtime Operations page from queries that include a wildcard now highlight the matching portion of the search result.

Changes

Agent

  • General updates
    This agent version has general internal updates.

Fixes

Agent

  • NetSuite connector issue resolved
    An issue with operations using the NetSuite connector has been resolved.

    Note

    This issue was resolved with agent version 11.31.1 (refer to the dates earlier on this page).

  • Linux private agent Scheduler issue resolved
    A date library whose latest files introduced an issue where the Linux agent's Scheduler service failed to start is no longer automatically downloaded.

    Note

    This issue was resolved with agent version 11.31.2 (refer to the dates earlier on this page). We recommend upgrading Linux private agents to 11.31.2 or later to prevent this issue from occurring and, in cases where it is already occurring, to recover from it.

    Alternatively, if you are using an earlier agent version you can apply the following workaround or recovery steps to non-Docker agents:

    • Workaround: If a Linux private agent has not yet been restarted, to prevent this problem from occurring, edit the version file at /opt/jitterbit/TimeZoneDB/version and change its value to 2024b. This will prevent the version of the date library with the issue from being downloaded by the agent.

    • Recovery: If a Linux private agent is already experiencing this issue, to fix it, edit the northamerica file at /opt/jitterbit/TimeZoneDB/northamerica to replace the value April with Apr in any occurrences. Then restart the agent.

API gateway

  • Self-test utility no longer fails
    The API created by the command line self-test utility now has values for the Service Name and Path fields. Previously, these required values were missing, resulting in the self-test failing with the message Failure, test call to API failed.

Cloud Studio

  • Changes to mappings using duplicate nodes no longer fail to save
    When making changes to mappings in a transformation using a duplicated flat uploaded schema, the changes no longer intermittently fail to save when the save appears to be successful.

Cloud Studio SDK connectors

  • SAP Concur Read operations now require a request transformation
    A transformation is now required preceding an SAP Concur Read activity in order for the operation to be valid. Previously, operations were allowed to be deployed but a runtime error would occur if a request transformation was not present.

  • Shopify API access token value is now masked
    The user-provided value of a Shopify connection’s API access token field is now masked in the UI.

Notices

Agent and API gateway

  • End of life for agent 10.75/11.13 and private API gateway 11.75
    As of August 24, 2024 these product versions have reached end of life and are no longer supported:

    • Private agent versions 10.75 and 11.13

    • Private API gateway version 10.75

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

Agent

  • 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 is now version 14.5-1.

    • 10.x versions: Supported 10.x versions are packaged with the existing 9.6.24-1 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:

NetSuite connector, Cloud Studio, and Design Studio

  • HMAC-SHA1 deprecation and removal from the Cloud Studio and Design Studio UI
    NetSuite is deprecating HMAC-SHA1 as a valid signature algorithm as previously announced (see NetSuite HMAC-SHA1 deprecation). To support these changes, Jitterbit intends to remove the HMAC-SHA1 signature algorithm from the Cloud Studio and Design Studio UI in an upcoming Harmony release.

    Warning

    As the HMAC-SHA1 signature algorithm will no longer be supported by NetSuite or the Jitterbit Harmony NetSuite connectors, you should change any Jitterbit Harmony projects that are presently using HMAC-SHA1 as the signature algorithm to use HMAC-SHA256 as soon as possible to avoid issues with those integrations.