Upgrading from Puppet 4 to 5¶

WORK IN PROGRESS! DO NOT TOUCH!

This wiki page was written at the release of Foreman 1.16 and should be used at your own risk.

• Table of contents
• Upgrading from Puppet 4 to 5
  • Planning

This wiki page is a rough guide on how to upgrade from Puppet 4 to Puppet 5 when using Foreman. It doesn't replace Puppet's own documentation - you need to take both into account, and it's not for the faint-hearted.

Remember, Puppet is a separate piece of software to Foreman. Foreman integrates with Puppet in only a few places (e.g. reports, ENC and smart proxy class imports) but the Foreman installer may have set it up for you initially.

If you're unfamiliar with how Puppet works, then you should consider setting up a new installation and migrating hosts instead.

Planning¶

Ensure you are running Foreman 1.16 or higher, previous versions are not compatible with Puppet 5. See Upgrading to Foreman 1.16 for more information.

• As with any upgrade, the smaller the step, the easier it will be. Ensure you've already upgraded to the latest 4.x release and fixed any deprecations from the release notes before moving to 5. This will save time later.
• Ensure your Puppet modules are going to be compatible with Puppet 5
• Plan to upgrade your masters before your agents, because the master can serve older agents, but not the other way around.
• Back up everything, especially SSL keys and certificates.

update all to last PC1 versions, make sure everything is installer managed and run the installer now!

add puppet5 repo, wipe pc1 repo

update ALL THE THINGS!

config files... 
/etc/puppetlabs/puppetserver/conf.d/web-routes.conf

apt-get install --reinstall puppet-agent-oauth

foreman-installer --reset-puppet-server-jvm-extra-args --reset-puppet-server-puppetserver-version --reset-puppet-server-puppetserver-metrics --reset-puppet-server-puppetserver-experimental

profit.