Katello 2.4 Documentation

Katello Upgrade

Katello supports upgrades from version 2.0. For users transitioning from 1.4, please see - Transition Guide.

Step 1 - Backup

If Katello is running on a Virtual Machine, we reccomend to take a snapshot prior to upgrading. Otherwise, take a backup of the relevant databases by following the instructions here.

Step 2 - Operating System

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.

Step 3 - Repositories

Update the Foreman and Katello release packages:

  • RHEL6 / CentOS 6:
  yum update -y http://fedorapeople.org/groups/katello/releases/yum/2.4/katello/RHEL/6Server/x86_64/katello-repos-latest.rpm
  yum update -y http://yum.theforeman.org/releases/1.10/el6/x86_64/foreman-release.rpm
  • RHEL7 / CentOS 7:
  yum update -y http://fedorapeople.org/groups/katello/releases/yum/2.4/katello/RHEL/7Server/x86_64/katello-repos-latest.rpm
  yum update -y http://yum.theforeman.org/releases/1.10/el7/x86_64/foreman-release.rpm

Step 4 - Update Packages

Clean the yum cache

yum clean all

Update the required packages:

yum -y update

Step 5 - Run Installer

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 2.4

katello-installer --upgrade

Congratulations! You have now successfully upgraded your Katello to 2.4 For a rundown of what was added, please see release notes.!

If for any reason, the above steps failed, please review /var/log/katello-installer/katello-installer.log – if any of the “Upgrade step” tasks failed, you may try to run them manaully below to aid in troubleshooting.

Manual Steps

Candlepin

The database password is stored in /var/lib/puppet/foreman_cache_data/candlepin_db_password.

/usr/share/candlepin/cpdb --update --password <PASSWORD>

Pulp

sudo -u apache pulp-manage-db

Foreman

foreman-rake db:migrate
katello-service restart
foreman-rake db:seed

Errata import

foreman-rake katello:upgrades:2.1:import_errata


The Foreman Community Survey is now live, and has prizes! Fill it out here!

A new bug fix release for Foreman 1.14 is available. See the Foreman 1.14.1 release notes for more details.

Foreman 1.14.0 is now available, featuring new automatic IPv6 support, LDAP and template enhancements, and easier email configuration. Read about all of the changes in the release notes, and follow the quick start to install it.