Upgrading agents

Upgrade your agents as new versions of Puppet Enterprise (PE) become available. The puppet_agent module helps automate upgrades, and provides the safest upgrade. Alternatively, you can use a script to upgrade individual nodes.

Before upgrading agents, verify that the primary server and agent software versions are compatible. Component versions in recent PE releases lists which Puppet agent versions are tested and supported for each PE release.

After upgrading, run Puppet on your agents (such as with puppet agent -t) as soon as possible to verify that the agents have the correct configuration and your systems are behaving as expected.

Before upgrading, ensure you have an up-to-date license key in the file format /etc/puppetlabs/suite-license.lic. This is necessary to access Puppet agent packages for upgrade. If you do not yet have a license in the new format, please contact your Perforce account representatives or Puppet Support.

To update your license key:

  1. Back up your existing license file. The existing filename is either /etc/puppetlabs/license.key or /etc/puppetlabs/suite-license.lic.

  2. On the primary server, copy the suite-license.lic license key provided by Perforce into /etc/puppetlabs/suite-license.lic.

  3. Restart console services using the following commands:

puppet resource service pe-console-services ensure=stopped
puppet resource service pe-console-services ensure=running

Related information