Foreman - Upgrade to Foreman 3.12 and Katello 4.14

    

NOTE: this guide exists for Upgrading from v3.10 to v3.11 as well --> here

With the current version, the official documentation is quite good and can be referenced.

I would recommend executing all of these commands in a tmux session so that your session will remain on the server in case anything happens to your workstation.

Start by checking for running tasks that would prohibit an update:

 [root@katello01 ~]# foreman-rake katello:upgrade_check  

Next, update the katello host and reboot if yum tells you to:

 [root@katello01 ~]# dnf -4y --refresh update  
 [root@katello01 ~]# dnf needs-restarting -r  

If there were any updates to foreman-related packages, make sure foreman is in a consistent state:

 [root@katello01 ~]# foreman-maintain service stop  
 [root@katello01 ~]# foreman-installer --scenario katello  

When the katello services have started again, upgrade the release-rpms:

 [root@katello01 ~]# dnf -4y --refresh update https://yum.theforeman.org/releases/3.12/el8/x86_64/foreman-release.rpm https://yum.theforeman.org/katello/4.14/katello/el8/x86_64/katello-repos-latest.rpm  

Make sure the 'katello:el8' and 'pulpcore:el8' modules are enabled as well as switch the postgresql module stream to 'postgresql:13':

 [root@katello01 ~]# dnf clean all 
 [root@katello01 ~]# rm -rf /var/cache/dnf 
 [root@katello01 ~]# dnf -4y --refresh modile disable pulpcore:el8 
 [root@katello01 ~]# dnf -4y --refresh module switch-to postgresql:13 
 [root@katello01 ~]# dnf -4y --refresh module enable katello:el8 

Before updating, stop the foreman-services:

 [root@katello01 ~]# foreman-maintain service stop  

Update the system:

 [root@katello01 ~]# dnf -4y --refresh update  

After the updates have completed, re-run the installer to ensure consistency:

 [root@katello01 ~]# foreman-installer --scenario katello  

Check the health of your installation using these commands once the 'foreman-install' command has finished:

 [root@katello01 ~]# foreman-maintain service list  
 [root@katello01 ~]# foreman-maintain service status  
 [root@katello01 ~]# foreman-maintain health check  

Once you verified the health of your installation successfully, foreman / katello are updated to foreman version 3.12 and katello version 4.14.

Feel free to comment and / or suggest a topic.