Skip to main content

Foreman - Upgrade to Foreman 3.4 and Katello 4.6


NOTE: this guide exists for Upgrading from v3.2 to v3.3 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 repositories:

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

Make sure the 'katello:el8' and 'pulpcore:el8' appstreams are enabled:

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

Update the system:

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

When the update is done, stop the foreman-services:

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

After the foreman-services have been stopped, re-run the installer to ensure consistency:

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

Check the health of your installation using these commands:

 [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, foreman / katello should be updated to the latest version of foreman-3.4 and katello-4.6.

Feel free to comment and / or suggest a topic.

Comments