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.
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:
-
Back up your existing license file. The existing filename is either
/etc/puppetlabs/license.key
or/etc/puppetlabs/suite-license.lic
. -
On the primary server, copy the
suite-license.lic
license key provided by Perforce into/etc/puppetlabs/suite-license.lic
. -
Restart console services using the following commands:
puppet resource service pe-console-services ensure=stopped
puppet resource service pe-console-services ensure=running