NOTE: This guide exists for Upgrading from v3.0 to v3.1 as well --> here
When updating your foreman installation manually, I find that the official documentation is a bit lacking. So here's how I update my foreman-server from v3.1 to v3.2 and katello from v4.3 to v4.4.
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 it if yum tells you to:
[root@katello01 ~]# yum -d 2 -y update
[root@katello01 ~]# yum -d 2 needs-restarting -r
When the katello services have started again, upgrade the repository:
[root@katello01 ~]# yum -d 2 -y install https://yum.theforeman.org/releases/3.2/el7/x86_64/foreman-release.rpm
[root@katello01 ~]# yum -d 2 -y install https://yum.theforeman.org/katello/4.4/katello/el7/x86_64/katello-repos-latest.rpm
[root@katello01 ~]# yum -d 2 -y install centos-release-scl-rh
Clear the yum cache before proceeding with the upgrade
[root@katello01 ~]# yum -d 2 clean all
[root@katello01 ~]# rm -rf /var/cache/yum
Update the system:
[root@katello01 ~]# yum -d 2 -y 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-install --scenario katello
Once that is done, foreman / katello should be updated to the latest version of foreman-3.2 and katello-4.4.
Feel free to comment and / or suggest a topic.
Comments
Post a Comment