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.

ATIX AG 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.

Performing the Upgrade

Use this procedure to upgrade orcharhino Server from orcharhino 6.4 to orcharhino 6.5.

orcharhino 6.5 consumes content from orcharhino Customer Center (OCC). Your orcharhino Server is automatically registered to OCC during the upgrade from orcharhino 6.4 to orcharhino 6.5.

Before starting the upgrade, ensure that your networking infrastructure, including any firewalls and HTTP proxies, allows your orcharhino Server to connect to OCC. For more information, see Registering orcharhino Server to OCC in ATIX Service Portal.
Procedure

  1. Check the version specific upgrade steps for your target orcharhino version.

  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:

    # dnf update orcharhino-maintain-definitions
# orcharhino-maintain upgrade list-versions

  4. Upgrade your orcharhino Server:

    # orcharhino-maintain upgrade run --target-version 6.5

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

Upgrading Puppet

You can use orcharhino-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:

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

    orcharhino-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.

  3. Run orcharhino-installer to apply the Puppet upgrade:

    # orcharhino-installer