NOTE: this guide exists for Upgrading from v3.9 to v3.10 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 update https://yum.theforeman.org/releases/3.11/el8/x86_64/foreman-release.rpm https://yum.theforeman.org/katello/4.13/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.11 and katello version 4.13.
Feel free to comment and / or suggest a topic.
Comments
Post a Comment