Upgrading
To upgrade your Puppet Enterprise deployment, you must upgrade both the infrastructure components and agents.
CAUTION:
Major primary server OS upgrades (such as Ubuntu 18.04 to 20.04) require Back up and restore PE.
Major agent OS upgrades require reinstalling the puppet-agent
package (as explained in Installing agents) and reinstalling any Ruby plugins/gems that were added at /opt/puppetlabs/puppet/bin/gem
.
-
Upgrade paths
These are the valid upgrade paths for PE. -
Upgrade cautions
These are the major changes to PE since the last long-term support release, 2021.7. Review these recommendations and plan accordingly before upgrading to this version. -
Test modules before upgrading
Before upgrading, make sure your modules work with the newest PE version by using the Puppet Development Kit (PDK) to update and test your modules. -
Upgrading Puppet Enterprise
Upgrade your PE installation as new versions become available. -
Upgrading agents
Upgrade your agents as new versions of Puppet Enterprise (PE) become available. Thepuppet_agent
module helps automate upgrades, and provides the safest upgrade. Alternatively, you can use a script to upgrade individual nodes. -
Migrate PE
As an alternative to upgrading, you can migrate your PE installation. Migrating results in little or no downtime, but it requires additional system resources because you must configure a new primary server.