orcharhino Proxy Upgrade Guide

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 Instructions

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.

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.0 to 5.2, read both the instructions for the upgrade to version 5.1 and 5.2. Please contact us if you are unsure on how to start with your orcharhino upgrade.

Upgrade Steps

Always check the version specific upgrade steps before upgrading and always create a snapshot/backup as part of your upgrade.

This guide describes the upgrade of your orcharhino proxy from version 5.2 to version 5.3. Please contact ATIX Support regarding other versions.

The orcharhino proxy obtains its own content from the orcharhino it is connected to. Its packages, which are identical to the orcharhino ones, must be published by the orcharhino. This can be verified by running the following command on your orcharhino:

orcharhino server and orcharhino proxies only require repositories provided by ATIX. They contain all packages required to install, upgrade, and run orcharhino and orcharhino Proxies, including the base operating system repositories. ATIX does not support using additional custom repositories on your orcharhino or orcharhino Proxies.

Run yum repolist to ensure there are no third party repositories enabled on your orcharhino or orcharhino Proxy. Resolving package conflicts or other issues due to custom repositories is not part of your orcharhino support subscription. Please contact us if you have any questions.

# yum repolist

Note that upgrading an orcharhino proxy requires a one time SSH connection to the orcharhino proxy.

  1. Add repository

    Go to Content > Products and select the product of the orcharhino proxy. Go to the Repositories tab (1) and click the New Repository button (2):

    Adding a new repository to the orcharhino proxy product

    This allows you to add the orcharhino 5.3 repository.

  2. Add repository to content view

    Add the new orcharhino 5.3 repository to the orcharhino proxy content view.

  3. Publish new version of the content view

    Go to Content > Content Views and select the content view of the orcharhino proxy.

    Publishing a new version of the content view

    Publish a new version of the content view for the orcharhino proxy by clicking the Publish New Version button.

  4. Check availability of repositories

    Verify if the repositories on the orcharhino are also available on the orcharhino proxy by running the following command on the orcharhino proxy:

    # yum repolist
  5. Update packages

    Run the following command on the orcharhino proxy to update the packages, i.e. download their metadata:

    # yum update
  6. Upgrade the orcharhino proxy

    Run the following command on the orcharhino proxy to upgrade its version:

    # foreman-installer