ScriptHalted error when trying to upgrade Windows agents with the puppet_agent module in Puppet Enterprise

When you try to upgrade Windows agent nodes using the puppetlabs-puppet_agent module, it fails with a ScriptHalted error.

Error messages

Error: Failed previous installation with: ScriptHalted
Error: /Stage\[main\]/Puppet\_agent::Install::Windows/Puppet\_agent\_upgrade\_error\[puppet\_agent\_upgrade\_failure.log\]/ensure\_notexist: change from false to true failed:
 Failed previous installation with: ScriptHalted

Version and installation information

PE version: 2017.3 and later
OS: Windows

Solution

To resolve the issue, use puppet_agent version 4.5.0 or later to increase the wait time for the Puppet agent run. The value is not configurable in earlier versions of the module.

On the Windows agents you are upgrading, set the value for wait_for_puppet_run in milliseconds in the puppet_agent class. The default value is 2 minutes.

For example, to set the value to 8 minutes:

wait_for_puppet_run => 480000

Find more information on the added parameter in the puppet_agent changelog.