Upgrading

To upgrade your Puppet Enterprise deployment, you must upgrade both the infrastructure components and agents.

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. The puppet_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.