Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


This page documents known issues that have been identified with recent versions of Jitterbit Harmony.

Harmony Portal

This section identifies issues with the current version of the Harmony Portal and any cloud applications accessed through it, including API ManagerCitizen Integrator, and the Management Console.

  • New trial users may not be able to access Cloud Studio immediately after registering
    • Summary: When a new trial user logs in to the Harmony Portal for the first time immediately after registering with Jitterbit Harmony, they may see Design Studio displayed as an application card. When clicked, nothing happens.
    • Additional Info: This issue is limited to new trial users; new users registering to join an existing Jitterbit Harmony organization are unaffected.
    • Workaround: To avoid this issue, wait a few minutes after registering to log in. If you have already encountered this issue, log out of the Harmony Portal and log back in. The Cloud Studio application card should be displayed. Click the card to access Cloud Studio.

      HTML Comment


This section identifies issues with recently released versions of Cloud Agents and/or Private Agents. Known issues for Cloud Agents are also identified on the Cloud Agent Groups page. Known issues for Private Agents are also identified on the Private Agent page. 

Multiple Versions of Cloud and Private Agents

These issues apply to all recent versions:

  • ODBC connections don't handle extended characters correctly

    • Summary: When connecting to a database using an ODBC driver, some extended characters, such as an en dash, aren't handled properly by operations that upsert data.
    • Additional Info: Upsert operations may fail, or succeed with unintended consequences by affecting the wrong data. Note that insert and update operations are unaffected by this issue.
    • Workaround: Use a JDBC driver for the database connection (see instructions for Design Studio or Cloud Studio).

      HTML Comment

  • SFTP directories sometimes aren't auto-created
    • Summary: When writing to SFTP as a target using Design Studio or Cloud Studio, the auto-creation of directories works inconsistently.
    • Additional Info: Depending on the particular FTP server involved, the directory may not be created.
    • Workaround: Confirm that the directory has been created before production use.

      HTML Comment

  • SetSalesforceSession function doesn't work
    • Summary: The Jitterbit Script function SetSalesforceSession doesn't work correctly and shouldn't be used in Design Studio or Cloud Studio.
    • Additional Info: If used, the script may or may not generate an error. Even if the script does not generate an error, the function will not work correctly. As the function doesn't work, the built-in session handling of the Salesforce connector will be used.

      HTML Comment

  • Private Agents have specific system requirements and known issues
    • Summary: The Private Agents have different and specific system requirements and known issues, depending on the operating system being used.
    • Workaround: See the System Requirements for Private Agents for details.
  • 64-bit Windows Private Agent does not work with Windows Server 2008 R2 SP1
    • Summary: As of the 10.9 Harmony Releasethe 64-bit Windows Private Agent does not work on Windows Server 2008 R2 SP1.
    • Workaround: Install the 32-bit Windows Private Agent instead.

10.0 Cloud and Private Agents

  • The Cloud Studio Cherwell connector doesn't work
    • Summary: As of the 10.1 Harmony Release, a change made to the Cherwell connector in Cloud Studio means it is no longer compatible with 10.0 agents.
    • Workaround: If using the Cherwell connector, please upgrade to 10.1 agents or higher.

9.8 Private Agents

  • Plugins aren't executing
    • Summary: An issue with plugins failing to run resulted in the Private Agent download being pulled shortly after the release.
    • Workaround: If you still have a 9.8 Private Agent, please upgrade to a later version.

      HTML Comment

Design Studio

This section identifies issues with recently released versions of Design Studio.

Multiple Versions of Design Studio

These issues apply to all recent versions:

  • SOAP faults that trigger an email message can't be deployed
    • Summary: When attempting to deploy an operation containing a SOAP fault that triggers an email message, you may receive an error.

9.4.1 Design Studio

  • Environment can't be set and recipes can't be downloaded
    • Summary: This version has issues with setting the environment and downloading recipes.
    • Workaround: If you are still using version 9.4.1, please upgrade to a later version.

      HTML Comment

8.25 Design Studio

  • JavaScript: Global variables aren't working

Data Loader

This section identifies issues with recently released versions of Data Loader. Data Loader - June 27, 2019

  • Erroneous warning during installation must be acknowledged
    • Summary: During installation of Data Loader (using the updated installer available as of June 27, 2019) on macOS 10.14 (Mojave), you will receive a warning that "'JitterbitInstallConfigUtils' is not optimized for your Mac and needs to be updated."
    • Workaround: Acknowledge the warning. The installation should proceed successfully.

8.13 - Data Loader - December 20, 2016

  • Installer is not compatible with macOS 10.14 (Mojave)
    • Summary: Those using macOS 10.14 (Mojave) cannot install Data Loader (using the original installer released December 20, 2016) due to an issue with compatibility of the installer.
    • Workaround: Install Data Loader using the installer available as of June 27, 2019 on the Downloads page of the Harmony Portal.
titleOn This Page
Table of Content Zone

Table of Contents

titleRelated Articles
titleRelated Topics


Last updated: