Upgrading orcharhino Server

This guide describes how you can upgrade orcharhino to a newer version. See the orcharhino Release Notes for a high level overview of available versions and their features.

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.

This upgrade guide is for orcharhino Server/Proxy running on CentOS 7, Oracle Linux 7, and Red Hat Enterprise Linux 7 only. orcharhino 6.2 does not support upgrading orcharhino Server and orcharhino Proxies from 6.1 on CentOS 7, Oracle Linux 7, and Red Hat Enterprise Linux 7 to 6.2 on Alma Linux 8, Oracle Linux 8, Red Hat Enterprise Linux 8, and Rocky Linux 8.

You can use the guide to upgrade orcharhino Server/Proxy from 6.1 to 6.2.

With orcharhino 6.3, you can upgrade from orcharhino 6.2 on CentOS 7, Oracle Linux 7, and Red Hat Enterprise Linux 7 to orcharhino 6.3 on Alma Linux 8, Oracle Linux 8, Red Hat Enterprise Linux 8, and Rocky Linux 8.

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 to orcharhino 6.2

orcharhino 6.2 is based on Foreman 3.1 and Katello 4.3.

Prerequisite

  • Before upgrading to orcharhino Server 6.2, you either have to upgrade your orcharhino Proxies to 6.1 or deploy additional orcharhino Proxies 6.1 after your upgrade and reregister hosts. Note that you cannot use orcharhino Proxies 5.12 or 6.0 with orcharhino Server 6.2.

Procedure

  1. Check the version specific upgrade steps for orcharhino 6.2.

  2. Backup your orcharhino instance:

    We generally recommend running orcharhino as a virtual server and performing a system snapshot at this point. For more information, see backing up orcharhino.

  3. Update and list the versions known to your orcharhino Server:

    # yum update orcharhino-maintain-definitions
# foreman-maintain upgrade list-versions

  4. Upgrade your orcharhino Server to 6.2:

    # foreman-maintain upgrade run --target-version 6.2

  5. Navigate to Administer > About and check the Backend System Status. Ensure the box lists each component with status OK.

Upgrading orcharhino Proxies to 6.2

orcharhino Server 6.2 requires orcharhino Proxies 6.2. You cannot use orcharhino Server 6.2 with orcharhino Proxies 5.12 or 6.0.

After upgrading orcharhino Server to 6.2, you have to upgrade your orcharhino Proxies from 6.1 to 6.2. For more information, see Upgrading orcharhino Proxies to 6.2.

Upgrading Puppet

You can use foreman-maintain to upgrade Puppet. This check is also part of the orcharhino pre-upgrade checks.

Procedure

  1. Connect to your orcharhino Server using SSH:

    # ssh root@orcharhino.example.com

  2. Run the Puppet upgrade check:

    # foreman-maintain health check --label orcharhino-puppet-support

    foreman-maintain checks if your current Puppet version is supported on your orcharhino instance. If an upgrade is available, you can follow the instructions to either abort or start the Puppet upgrade process.