Katello supports upgrades from version 2.0. For users transitioning from 1.4, please see - Transition Guide.
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). This script is included in Katello 2.4.3.
To run the script:
In addition to the information on the screen, the command will print the number of Content Hosts that will be deleted upon upgrade and will generate a csv with the full list including the uuid, name, last checkin date, and a reason for their deletion.
Katello 3.0 unifies Host and Content Host objects to provide a more unified experience. As a result, it is no longer allowed to have more than one Content Host with the same FQDN. This matches the requirement that is already imposed on the Foreman Host object. Upon upgrade to Katello 3.0 any Hosts that violate one of three rules will be deleted:
This report is automatically run as part of the katello:upgrade_check script. However, if you want to get just the content host info, you can run:
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:
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
Update the required packages:
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.1
Congratulations! You have now successfully upgraded your Katello to 3.1 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/katello.log – if any of the “Upgrade step” tasks failed, you may try to run them manaully below to aid in troubleshooting.