Katello 3.11 Documentation

Smart Proxy Upgrade

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:

  • RHEL7 / CentOS 7:
  yum update -y https://fedorapeople.org/groups/katello/releases/yum/3.11/katello/el7/x86_64/katello-repos-latest.rpm
  yum update -y https://yum.theforeman.org/releases/1.21/el7/x86_64/foreman-release.rpm

Step 3 - Update Packages

Clean the yum cache

yum clean all

Update packages:

yum update -y
yum install foreman-proxy-content

Step 4 - Regenerate Certificates

On the Katello server, regenerate the certificates tarball for your Smart Proxy:

foreman-proxy-certs-generate --foreman-proxy-fqdn "myproxy.example.com"\
                       --certs-tar    "~/myproxy.example.com-certs.tar"

And copy them to your Smart Proxy:

scp ~/myproxy.example.com-certs.tar myproxy.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.11

foreman-installer --scenario foreman-proxy-content --upgrade\
                  --certs-tar-file ~/myproxy.example.com-certs.tar\
                  --certs-update-all --certs-regenerate true --certs-deploy true

Congratulations! You have now successfully upgraded your Smart Proxy to 3.11 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/foreman-proxy.log – if any of the “Upgrade step” tasks failed, you may try to run them manaully below to aid in troubleshooting.

Registration for Foreman Open Source Camp (November 7th) is open!

CFP for Config Management Camp and FOSDEM Infra Management room is open until November 3rd. CFP for Devconf.CZ closes November 1st. Submit your talks today!

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

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

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