Prevent the puppetlabs-puppet_agent module from overwriting puppet.conf settings during Windows agent upgrades in Puppet Enterprise

By default, using the puppetlabs-puppet_agent module to upgrade Windows agents nodes will overwrite settings that were changed after installation, including server, certname and ca_server.

To preserve any changes to settings that you made after installation, use the install_options parameter when upgrading.

Learn more about the install_options parameter.

Version and installation information

PE version: All supported versions

Solution

To preserve changed settings, use the install_options parameter when you add the class to agents you want to upgrade using the module, for example:

class {'puppet_agent':
  package_version => '5.5.8',
  install_options    => ["PUPPET_MASTER_SERVER=server01.example.com","PUPPET_CA_SERVER=ca-server01.example.com","PUPPET_AGENT_CERTNAME=${trusted[certname]}"],
}

Note: ${trusted[certname]} resolves to the current certname setting.