Katello 3.0 Documentation

Capsule Upgrade

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

Upgrade Caveat

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:

  1. Wait for Foreman 1.11.3 and rubygem-kafo-0.7.4
  2. Install Kafo 0.7.4 from our Koji prior to upgrading any other RPMs * el7: rubygem-kafo-0.7.4-1.el7 * el6: rubygem-kafo-0.7.4-1.el6

If you have any further questions please reach out to us on IRC or the user mailing list prior to upgrading.

Step 1 - 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 2 - Repositories

Update the Foreman and Katello release packages:

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

Step 3 - Update Packages

Clean the yum cache

yum clean all

Update packages:

yum update -y

Step 4 - Regenerate Certificates

On the Katello server, regenerate the certificates tarball for your capsule:

capsule-certs-generate --capsule-fqdn "mycapsule.example.com"\
                       --certs-tar    "~/mycapsule.example.com-certs.tar"

And copy them to your capsule:

scp ~/mycapsule.example.com-certs.tar mycapsule.example.com:

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 3.0

foreman-installer --scenario capsule --upgrade\
                  --certs-tar ~/mycapsule.example.com-certs.tar\
                  --certs-update-all --regenerate --deploy

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.



Foreman 1.21.0 has been released! Follow the quick start to install it.

Foreman 1.20.2 has been released! Follow the quick start to install it.