10.70 / 11.8 Harmony Release Notes¶

10.70 / 11.8 Harmony Release¶

This page includes release notes for all generally available components being released as part of 10.70 / 11.8. Compilations of release notes for Production Cloud Agent Groups, Sandbox Cloud Agent Groups, and Private Agents are also available.

The 10.70 / 11.8 release is staggered based on the dates and times as listed below by component and region. You can subscribe to maintenance notifications for cloud-based components at Jitterbit Trust. Locally installed components are available from the Downloads page (except for the Docker Private Agent, which is available at Docker Hub). The end-of-life date for these components is one year after the release date.

New Features¶

Management Console and API Manager¶

• API Portal access for external users
  Harmony organization administrators can now manage external access to the API Manager Portal:

  • User Management: The new Management Console User Management page allows you to invite external users and define their access to individual APIs or to a group of APIs.

  • API Groups: The new API Manager API Groups page allows you to group together the APIs that you want to provide external users with access to.

Cloud Studio¶

• Global connections general availability
  A global connection is a connection at the organization level created by an administrator, either from the Global Connections page or by promoting a project-level connection through its actions menu. Once added to an environment, a global connection becomes accessible across that environment’s projects for creating project-level activities.

• Microsoft Azure ESB connector
  The Microsoft Azure ESB connector can be used with the following agent types and versions:

  • Cloud or Private Agents 10.1 or later: Get, send, unlock, renew, or delete messages in a Microsoft Azure Service Bus queue or topic.

  • Private Agents 10.70 / 11.8 or later: Consume messages in a Microsoft Azure Service Bus queue or topic. These activities are released as a beta version and must be run in an operation that has event listening enabled.

Changes¶

Agent¶

• Connector verbose logging logback.xml file moved
  The location of the connector verbose logging logback.xml file on Private Agents is now at <JITTERBIT_HOME>\tomcat\shared\lib\logback.xml (Windows) or <JITTERBIT_HOME>/tomcat/shared/lib/logback.xml (Linux). On agent upgrade, the existing logback.xml file in its formerly used location is retained for reference; however, any connector-specific verbose logging entries will no longer take effect from that location. As there are no changes to the logback.xml file itself, you can replace the file in its new location to use existing entries.

Enhancements¶

Agent¶

• Default maximum memory increased
  The Apache Tomcat process started by an agent now has a default maximum heap size of 2 GB, increased from 1 GB.

• Apache HTTP server upgrade
  The Apache HTTP server included with the agent has been upgraded to version 2.4.57. This addresses critical vulnerabilities CVE-2006-20001, CVE-2022-36760, and CVE-2022-37436.

• ActiveMQ JAR upgrade
  The ActiveMQ JAR file included with the agent and used by the Design Studio JMS connector has been upgraded to version 5.16.6. This addresses multiple security vulnerabilities.

  Note

  Older versions of the ActiveMQ JAR remain after upgrading agents but can be deleted post-upgrade from the agent installation directory <JITTERBIT_HOME>\Connectors\JMS\Providers\ActiveMQ or <JITTERBIT_HOME>/Connectors/JMS/Providers/ActiveMQ.

Cloud Studio¶

• Copy/paste between projects
  During project design, you can now copy and paste components from one project to another in the same browser session.

• Global connections enhancements
  Multiple enhancements have been made to the global connections feature:

  • The design component palette now has a Global Connections tab where you can access any global connections that have been added to the environment. Global connections were previously located in the Connectivity tab (now called the Connections tab).

  • The environment drawer that opens when you click an environment in the Global Endpoint Connections table now lists any operations that are dependent on the global connection and provides the option to deploy the global connection in that project.

  • When a global connection is edited that is used in a project currently open in the designer, a message is displayed in the designer to notify users that the connection has changed and must be redeployed for changes to take effect.

• Google BigQuery custom schedule support
  A Google BigQuery Data Transfer activity now has a custom_schedule field in its request schema where you can provide a string that follows the Google cron format (without prepending schedule:). For example, every 12 hours or every monday 09:00.

• JMS Consume (Beta) activity
  The JMS connector has a new Consume (Beta) activity that consumes messages from a JMS queue. The activity must be run on a Private Agent in an operation that has event listening enabled.

Harmony Platform¶

• BMC OAuth 2.0 SSO no longer requires configuration of Design Studio
  When configuring Harmony SSO with OAuth 2.0 with BMC as the OAuth provider, configuring Studio (Design Studio) as a Harmony Client is no longer required or possible, as its configuration is not applicable to BMC.

Management Console¶

• Environment classes
  Environments are now classified as Production (default for existing and new environments) or various non-production classes for reporting purposes only. To change the Environment Class, edit the environment.

• Recent logins in selected organization
  The Dashboard page now has a Recent Logins tile that shows the five most recent logins of users who have the selected organization as their default organization.

• Message Queues page redesign
  The Message Queues page has been redesigned with an updated UI, featuring new tabs for Message Queues and Authentication Tokens. Settings can now be accessed using the gear icon in the top right.

Fixes¶

API Gateway¶

• APIs no longer intermittently fail with a 404 error
  API Manager API calls through the API Gateway no longer intermittently fail with a 404 error due to log IDs.

Cloud Studio¶

• Uploaded schemas are now saved for reuse
  Schemas uploaded using the Use Sample File option in a transformation or activity are now available to select in the Saved Schemas list. Previously, these schemas were displayed in the project pane’s Components tab but could not be reused.

• BigCommerce and Coupa connectors no longer continue on error by default
  The Continue on Error checkbox available in BigCommerce Create, Update, and Delete activities and in Coupa Create and Update activities is no longer selected by default.

• Google Pub Sub Listen Message (Beta) activity events can now be enabled
  When enabling events for the first time on an operation with a Google Pub Sub Listen Message (Beta) activity, an internal server error no longer intermittently occurs.

• Jitterbit App Builder connector fixes for boolean values and module renaming
  Multiple fixes have been made to the Jitterbit App Builder connector:

  • Boolean values provided in the request transformation of an activity no longer result in a 500 internal server error.

  • When the default Employees module has been renamed, the name change is now reflected in the connector.

• Microsoft Excel Query activity can now be configured
  After a successful Microsoft Excel connection test, an error fetching data no longer occurs during configuration of a Microsoft Excel Query activity in certain circumstances.

• Microsoft SharePoint 365 tenant URL is now validated
  An invalid Office 365 Tenant URL provided in a Microsoft SharePoint 365 connection now results in an error when testing the connection. Previously, this field was not validated during a connection test.

• Microsoft Teams Send Message activity can now send an attachment without a message
  A Microsoft Teams Send Message activity that sends only an attachment and no message no longer fails at runtime.

• ServiceNow connection error at runtime resolved
  When running an operation that uses the ServiceNow connector, the error Username and Password must be provided to set up a connection no longer occurs when a valid username and password are configured.

• Shopify Create request now supports long tracking numbers
  A Shopify Create activity request for the Shipping and Fulfillment object > Fulfillment for Fulfillment Order sub-object now supports long integers provided in the tracking_info node’s number field. Previously, the order was fulfilled but the tracking number was incorrect.

Harmony Platform¶

• Downloading a Design Studio project from multiple environments no longer fails
  In the Design Studio Download Project tab, when attempting to download a project from multiple environments, the project is now downloaded as expected. Previously, in some situations an error was returned and the project failed to download.

Notices¶

Agent¶

• Jitterbit’s intention to stop distributing Private Agent 10.x
  Jitterbit intends to stop distributing a 10.x Private Agent version within the next several Harmony releases. Since Harmony release 10.63 / 11.1, both a 10.x and 11.x Private Agent version have 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: Current 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.

    Note

    Upgrading to an 11.x Windows Private Agent from 10.x requires a complete uninstall. Follow the documented instructions to complete the upgrade. Linux Private Agents can be upgraded as usual from any 10.x version.

Shopify Connector, Cloud Studio¶

• Shopify Fulfillment API deprecation
  Shopify has announced it is deprecating some endpoints on its Fulfillment API on June 30, 2023. Customers with Cloud Studio projects using the Shopify connector with deprecated Fulfillment API endpoints must reconfigure the connector as soon as possible, or operations using the deprecated API endpoints will begin failing after June 30, 2023. For additional information, see details on impacted projects and required user action.

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 Harmony NetSuite connectors, you should change any 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.

Related Resources¶

• Jitterbit Trust (includes the latest release dates and times, as the schedule is subject to change)
• Sandbox Cloud Agent Group releases, Production Cloud Agent Group releases, and Private Agent releases
• Release Schedule
• Known Issues
• Jitterbit End-of-Life Policy
• Jitterbit Community
• Jitterbit Support