Skip to Content

Private Agent Known Issues

Introduction

This page documents known issues that have been identified with recent versions of Private Agents. For known issues that have been identified with other Harmony applications, see Known Issues.

Multiple Versions of Private Agents

These issues apply to all recent versions:

  • Windows Private Agent installation shows a Microsoft Defender SmartScreen warning

    • Summary: When installing a Private Agent 10.69 or later (for 10.x agents) or 11.8 or later (for 11.x agents) on Windows 2019 or Windows 10, a warning message may appear.

    • Additional Information: The warning message reads "Windows protected your PC" with a note that Microsoft Defender SmartScreen prevented an unrecognized app from starting.

    • Workaround: Within the warning message dialog, click More info to show the option Run anyway. Then click Run anyway to proceed with the agent installation.

  • Windows Private Agents: Unable to install 64-bit agent with Two-Factor Authentication (TFA)

    • Summary: Installing a 64-bit Windows Private Agent fails if TFA is active.

    • Additional Information: The installer displays an error dialog.

    • Workaround: Temporarily disable TFA and install the 64-bit Windows Private Agent. After installation, enable TFA.

  • 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 Information: 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).

  • 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 Information: Depending on the particular FTP server involved, the directory may not be created.

    • Workaround: Confirm that the directory has been created before production use.

  • 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 Information: 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.

  • 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.

  • Agent installation fails due to PostgreSQL password including a plus sign (+)

    • Summary: Private Agent installation fails if the PostgreSQL password contains a plus sign (+). There is no error message displayed.

    • Additional Information: This is an issue with the Private Agent installer, not with PostgreSQL.

    • Workaround: Use a password without a plus sign (+). When installation is complete, the password can be changed to any password acceptable for use with PostgreSQL.

10.45 and Earlier Private Agents

  • Apache Log4j2 JNDI vulnerabilities affect Private Agents

    • Summary: Apache Log4j2 vulnerabilities CVE-2021-44228 and CVE-2021-45046 affect Private Agents that use Cloud Studio connectors built with the Harmony Connector SDK.

    • Mitigation: An emergency maintenance addressed the vulnerabilities. After the maintenance, Private Agents needed to be restarted and an operation run for each affected connector in order for the update to become effective. For detailed information and instructions, see Mitigating the Apache Log4j2 JNDI Vulnerability.

10.38 Linux Private Agents

  • The PostgreSQL database is reinitialized when upgrading from version 10.37 to 10.38

    • Background: When upgrading a Linux Private Agent from a pre-10.37 version to a version that is 10.37 or later, the PostgreSQL database will be reinitialized as it is upgraded to version 9.6. This upgrade will recreate the database on your Private Agent and your data will be recovered during this upgrade process. After the upgrade, any backups created using an earlier PostgreSQL version will not be compatible. The upgrade process can take more than 30 minutes depending on the number of projects and the size of the environments associated with your Private Agent group. Any pending jobs will be put in a pending queue to be run after the upgrade is complete. This upgrade does not involve the Windows Private Agent.

    • Known Issue: It is a known issue that when upgrading a Linux Private Agent from version 10.37 to 10.38, the PostgreSQL database is reinitialized.

    • Workaround: Upgrade to a Linux Private Agent that is version 10.39 or later.

10.0 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 9.8 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.