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 theScheduler
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 to2024b
. 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 valueApril
withApr
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 keydisable-hyphen-replacement
totrue
. 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 theerror
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:-
A new Certificate activity can be used to perform a certificate operation and can be used as a source or a target in an operation.
-
In a Key or Secret activity, when selecting from the table of vaults, the location and resource group of each vault are now displayed.
-
-
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'sScheduler
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 to2024b
. 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 valueApril
withApr
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 messageFailure, 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:
- Windows agent upgrade instructions (requires a complete uninstall)
- Linux agent upgrade instructions
-
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.