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.17/katello/el7/x86_64/katello-repos-latest.rpm
  yum update -y https://yum.theforeman.org/releases/2.2/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-update-all\
                       --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 will run the right database migrations for all component services, as well as adjusting the configuration to reflect what’s new in Katello 3.17

foreman-installer --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.17 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.