Katello 3.7 supports upgrades from version 3.6 and Puppet version 4. For users transitioning from versions prior to 3.6, first upgrade to Katello 3.6, upgrade Puppet to version 4, and then proceed to upgrade to Katello 3.7 following the instructions below.
Before you upgrade, you need to run the upgrade check script that will check for any active tasks, your version of Katello, and if there are any content hosts that will be deleted (see below).
To run the script:
foreman-rake katello:upgrade_check
If Katello is running on a Virtual Machine, we recommend to take a snapshot prior to upgrading. Otherwise, take a backup of the relevant databases by following the instructions here.
Ensure your operating system is fully up-to-date:
yum -y update
NOTE: If kernel packages are updated here (e.g. upgrading el 6.6 to 6.7), you must reboot and ensure the new kernel and SELinux policy is loaded before upgrading Katello.
Update the Foreman and Katello release packages:
yum update -y http://fedorapeople.org/groups/katello/releases/yum/3.7/katello/el7/x86_64/katello-repos-latest.rpm
yum update -y http://yum.theforeman.org/releases/1.18/el7/x86_64/foreman-release.rpm
yum update -y foreman-release-scl
Stop the Katello services
katello-service stop
Clean the yum cache
yum clean all
Update the required packages:
yum -y update
The installer with the –upgrade flag will run the right database migrations for all component services, as well as adjusting the configuration to reflect what’s new in Katello 3.7
foreman-installer --scenario katello --upgrade
Congratulations! You have now successfully upgraded your Katello to 3.7 For a rundown of what was added, please see the release notes.
If for any reason, the above steps failed, please review /var/log/foreman-installer/katello.log – if any of the “Upgrade step” tasks failed, you may try to run them manaully below to aid in troubleshooting.
Foreman 2.3.3 has been released! Follow the quick start to install it.
Foreman 2.2.2 has been released! Follow the quick start to install it.