Project

General

Profile

Upgrading from Puppet 4 to 5 » History » Version 1

Anonymous, 07/08/2017 04:04 PM

1 1 Anonymous
h1. Upgrading from Puppet 4 to 5
2
3
WORK IN PROGRESS! DO NOT TOUCH!
4
5
_This wiki page was written at the release of Foreman 1.16 and should be used +at your own risk+._
6
7
{{toc}}
8
9
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.
10
11
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.
12
13
If you're unfamiliar with how Puppet works, then you should consider setting up a new installation and migrating hosts instead.
14
15
h2. Planning
16
17
Ensure you are running Foreman 1.16 or higher, previous versions are not compatible with Puppet 5. See "Upgrading to Foreman 1.16":http://theforeman.org/manuals/1.16/index.html#3.6Upgrade for more information.
18
19
* 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.
20
* Ensure your Puppet modules are going to be compatible with Puppet 5
21
* Plan to upgrade your masters before your agents, because the master can serve older agents, but not the other way around.
22
* Back up everything, especially SSL keys and certificates.
23
24
<pre>
25
update all to last PC1 versions, make sure everything is installer managed and run the installer now!
26
27
add puppet5 repo, wipe pc1 repo
28
29
update ALL THE THINGS!
30
31
config files... 
32
/etc/puppetlabs/puppetserver/conf.d/web-routes.conf
33
34
apt-get install --reinstall puppet-agent-oauth
35
36
foreman-installer --reset-puppet-server-jvm-extra-args --reset-puppet-server-puppetserver-version --reset-puppet-server-puppetserver-metrics --reset-puppet-server-puppetserver-experimental
37
38
profit.
39
</pre>