Advice on how to upgrade

Support
1

Now that foreman 1.22.0 has been released, I could really use some advice on how to upgrade.
I lifted a prior comment from a posting in another thread called Getting Started from back in March …

I’ve been following a few other threads regarding upgrades …

Foreman 1.21 upgrade dependency failures
Katello 3.11 is now available!
Foreman upgrade 1.21 and Katello 3.11
Katello 3.11

Guess I am just a little shy about being in a big hurry to upgrade just yet …
Are there any other considerations I should be worried about?

Katello Upgrade
Upgrading to Foreman 1.21

Smart Proxies ?
SSL Certificates ?
Activation Keys?
Content Host Registrations ?

Other plugins …
OpenSCAP ?
FreeIPA ?

Any known compatibility issues?
I just got this stuff working.
I’m afraid to break it, and having to start over.
Not even sure I would know where to begin again?

So, my question now is: What do I do first? Katello? Foreman 1.21 then 1.22?

2

If using Katello wait for its release and then follow the instructions in Foreman :: Plugin Manuals. If you want to know more about the update including warnings read both release notes (Foreman and Katello).

I only had updates fail when I had manually installed plugins and release quality was always good enough so I had no need to rollback.

3

I am currently at:

foreman 1.20.2
katello 3.10.0
puppet 5.5.10

With plugins:
foreman_openscap 0.11.5
datadog_agent 2.6.0
jasmin
lucee
nodejs

(among others … )

Now that katello 3.12 and foreman 1.22.0 are released,
can I upgrade directly from foreman 1.20.2 to 1.22.0, or do I need to upgrade to 1.21.3 first?
How about the intermediary releases in between?

I ran the command (as recommended in the katello plugin upgrade instructions):

foreman-rake katello:upgrade_check

# foreman-rake katello:upgrade_check
/usr/share/foreman/lib/foreman.rb:8: warning: already initialized constant Foreman::UUID_REGEXP
/usr/share/foreman/lib/foreman.rb:8: warning: previous definition of UUID_REGEXP was here
(…)

This script makes no modifications and can be re-run multiple times for the most up to date results.
Checking upgradeability…

Checking for running tasks…
[PASS] - There are 0 active tasks.
You may proceed with the upgrade.

This wasn’t particularly useful to me.

After the updates and repo changes, if I run the command:

foreman-installer --scenario katello --upgrade

what happens to all of the modules that I have installed manually?

4

PS: I forgot to ask about Puppet 6 ?
Do I also upgrade the puppet server to version 6, or should it remain on 5.5?

5

upgrade to 1.21 before, according to release note/documentation it’s better/necessary

6

How? Is that done with the foreman installer, or katello?

7

More specifically, following the instructions at:
https://www.theforeman.org/manuals/1.21/index.html#3.6Upgrade

Do I run the foreman-installer?
(without options?)

I’m a little leery of the comment:
Note that the installer can modify config files so this may overwrite your custom changes.

8

I upgraded to katello 3.11 and when 3.11 it’s done I upgraded to 3.12, I followed the upgrade doc - https://theforeman.org/plugins/katello/3.11/index.html and https://theforeman.org/plugins/katello/3.12/index.html

it upgraded both, katello and foreman

1 Like
9

Thank you, Matteo! That worked beautifully! Simple and elegant.

I am now at foreman 1.22.0 and katello 3.12.0.