Error 1722 with Windows Private Agents¶

Issue¶

The Windows Private Agent installation fails with this error message:

Error 1722. There is a problem with this Windows Installer package. A program run as part of the setup did not finish as expected. Contact your support personnel or package vendor. ...

Cause and Resolution of the Issue¶

There are multiple reasons the Private Agent installation could fail with this error message. Two of the most common reasons are a conflict with the Microsoft Visual C++ Redistributable or having unallowed characters in the PostgreSQL password.

Microsoft Visual C++ Redistributable¶

A conflict with an existing version of Microsoft Visual C++ Redistributable can cause Error 1722.

Private Agents require Microsoft Visual C++ Redistributable for Visual Studio 2015, 2017, 2019 to be installed before installing a Private Agent. Microsoft includes the same redistributable files for Visual Studio C++ 2015, 2017, and 2019. Install the 64-bit Windows version using vc_redist.x64.exe.

Note

If installing a Private Agent that is prior to version 10.3, and Visual Studio libraries such as the earlier versions of Visual Studio C++ Redistributable for Visual Studio 2017 or higher are already installed, the installation will fail. A workaround is to download and install the appropriate files available at Microsoft Visual C++ Redistributable for Visual Studio 2015, 2017, 2019 and then install the Private Agent.

As of Harmony version 10.3, this has been fixed. Installation on a machine that already has a version of Visual C++ Redistributable for Visual Studio higher than 2015 is now successful. If you are still experiencing issues, please contact support.

Unallowed PostgreSQL Password Characters¶

A PostgreSQL password that uses unallowed characters can cause Error 1722.

To resolve this issue, do not use a plus sign (+) as part of the PostgreSQL password when installing a Private Agent. The minimum number of characters for a PostgreSQL password is eight (8). We recommend that you not use accented characters (such as é) or any of these characters in the PostgreSQL password: + @ $ % & [] {} () , ; ? ^ = £.