Upgrading orcharhino Proxy

This guide describes how to upgrade an orcharhino Proxy to a newer version.

orcharhino is a large software suite undergoing active development. It is necessary to upgrade orcharhino when ATIX releases new versions to take advantage of its new features and bug fixes. Refer to the orcharhino Release Notes for more information.

ATIX provides guided upgrades performed by our consultants as part of our support subscriptions. Please contact us if you would like to make use of this service.

Ensure you carefully read all of the instructions, warnings, and recommendations presented in this guide and the appropriate version specific orcharhino Upgrade Notes in the ATIX Service Portal. ATIX does not offer support for recovery from a failed upgrade if you did not follow our upgrade guide.

Version specific upgrade instructions are published in the ATIX Service Portal. Log in with your ATIX Support login credentials and follow the link to the orcharhino Upgrade Notes. Ensure you carefully read the version specific instructions before starting the upgrade and always create a snapshot/backup as part of your upgrade.

If you are skipping versions in a single upgrade, read all of the version specific instructions for all intermediary versions. For example, if you are upgrading from orcharhino 5.10 to 5.12, read both the instructions for the upgrade to version 5.11 and 5.12. Please contact us if you are unsure on how to start with your orcharhino upgrade.

ATIX does not support using third party repositories on your orcharhino Server or orcharhino Proxies. Resolving package conflicts or other issues due to third party or custom repositories is not part of your orcharhino support subscription. Please contact us if you have any questions.

Upgrading orcharhino Proxies to 6.0

All orcharhino Proxies that you have upgraded at least to orcharhino 5.12.1 are supported for use with orcharhino Server 6.0, so you do not need to upgrade your orcharhino Proxies right away.

You cannot upgrade orcharhino Proxies with Squid to version 6.0. Instead, you need to convert them to the functionally equivalent orcharhino 6.0 Proxy with download policy streamed. For more information, see Changing the Download Policy for orcharhino Proxies. Detailed instructions on how this conversion can be performed will be released with an upcoming orcharhino release. For now, you should continue to use your orcharhino Proxies with Squid with version >= 5.12.1 but < 6.0!

If you are using orcharhino Proxies with Pulp, you may upgrade them to version 6.0 after you have successfully upgraded your orcharhino Server to 6.0.

Upgrading orcharhino Proxies with Pulp

There are two significant changes for the upgrade from 5.12 to 6.0 in contrast to the normal upgrade procedure:

  • During the upgrade to 6.0, all Pulp2 content is removed from orcharhino Proxies using the foreman-maintain content remove-pulp2 command.

  • After the upgrade to 6.0, you must resynchronize all content from your orcharhino Server, either by using the button in the orcharhino management UI, or using the following hammer command: hammer capsule content synchronize --name My_orcharhino_Proxy --async.

You cannot migrate content from Pulp2 to Pulp3 on your orcharhino Proxy as you do for your orcharhino Server. However, you can remove the Pulp2 content and resynchronize content from your orcharhino Server to your orcharhino Proxy with Pulp3. This method has the disadvantage of increased network traffic and down time from resynchronizing content. If this downtime is unacceptable, you can alternatively deploy an entirely new orcharhino Proxy on a separate host, synchronize the content, and then switch your managed hosts from the old orcharhino Proxy to the new one.

Providing Content for orcharhino Proxy

orcharhino Proxies obtain their content, which is identical to the packages for orcharhino Server, from the orcharhino Server they are connected to.

Providing Content Using orcharhino Configuration Job Template

You can use the the job template orcharhino Configuration on orcharhino Server to provide content for orcharhino Proxies. Run the job template to automatically create the Smart Proxy Atix product, include the repository in the content view, and publish a new version of the content view. For more information on how to run remote execution jobs on orcharhino Server, see Running Remote Execution Jobs on orcharhino Server.

Providing Content Manually
  1. Navigate to Content > Products and create a product named Smart Proxy Atix.

  2. Navigate to Content > Products, select the Smart Proxy Atix product, and add a repository of type yum. On the Repositories tab (1), click the New Repository button (2):

    Adding a new repository to the orcharhino proxy product

    Add the latest repository as found on your orcharhino Servers in /etc/yum.repos.d/redhat.repo.

  3. Navigate to Content > Content Views, select the content view of the orcharhino Proxy, and add the latest repository.

  4. Navigate to Content > Content Views, select the content view of the orcharhino Proxy, and publish a new version.

    Publishing a new version of the content view

    Click Publish New Version to publish a new version of the content view for your orcharhino Proxy.

Performing the Upgrade

Prerequisites
  • You have prepared content for orcharhino Proxy on your orcharhino.

  • You have a one time SSH connection to your orcharhino Proxy.

Procedure
  1. Verify if the repositories on orcharhino Server are also available on your orcharhino Proxy by running the following command on your orcharhino Proxy:

    # yum repolist
  2. Update packages on your orcharhino Proxy:

    # yum update
  3. Upgrade your orcharhino Proxy:

    # foreman-installer