Troubleshooting Windows Agent Installation Issues

Applies To:

Halcyon Windows Agent 

Overview:

The Halcyon Agent generally installs without issue. However, in rare cases where the installation fails without a clear error message or indicator, additional logging is required to investigate the root cause.

This article provides instructions for manually installing the Halcyon Agent with MSI logging enabled. The resulting install log can help diagnose and resolve unexpected installation failures.

Action:

To generate an install log during a manual installation of the Halcyon Agent:

1. Open an Administrative Command Prompt.
2. Navigate to the folder containing the Halcyon Agent installer package.

3. Run the following command (update the version number and token as needed):

   HalcyonAR_Setup_x64_v<VERSION>.exe /s /v"/l*v c:\temp\HalcyonInstall.log /qn" /z"ACCEPTEULA INSTALLTOKEN=<TOKEN>"

   • Replace with your actual install token.
   • Ensure the folder C:\temp\ exists before running the command. You may change the log path if needed.
4. This command initiates a silent install of the Halcyon Agent and writes a detailed log to C:\temp\HalcyonInstall.log.
5. If the installation fails or completes unexpectedly, send the HalcyonInstall.log file to support for review.