Katello supports upgrades from version 2.0. For users transitioning from 1.4, please see - Transition Guide.
At the time of release, upgrades don’t properly copy exsting installer configuration to the new scenario based installer. The fix for this is in the installer library Kafo version 0.7.4 which won’t be released until Foreman 1.11.3 is released. IF you are planning to do an upgrade you have two options:
If you have any further questions please reach out to us on IRC or the user mailing list prior to upgrading.
Ensure your operating system is fully up-to-date:
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:
Clean the yum cache
On the Katello server, regenerate the certificates tarball for your capsule:
And copy them to your capsule:
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.0
Congratulations! You have now successfully upgraded your Capsule to 3.0 For a rundown of what was added, please see release notes.!
If for any reason, the above steps failed, please review /var/log/foreman-installer/capsule.log – if any of the “Upgrade step” tasks failed, you may try to run them manaully below to aid in troubleshooting.