orcharhino Client Upgrade Guide

This guide describes how to add and upgrade orcharhino clients.

orcharhino and its clients is a large software suite undergoing active development. It is recommended to upgrade orcharhino clients 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.

Warning

Make sure 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.

Adding orcharhino Clients

The following steps guide you through adding orcharhino clients manually. orcharhino clients are required to attach hosts to orcharhino.

  1. Create a new product

    Creating a product requires only a name, as a product is a collection of repositories. Adding a GPG public key and sync plan is recommended but optional.

    The product will typically house all orcharhino clients for a single operating system, e.g. Debian or SLES.

  2. Create new repositories

    Creating a repository requires several fields besides the upstream URL, such as an arbitrary name and a type. You can find the necessary upstream URLs for all orcharhino clients in the ATIX Service Portal.

  3. Sync newly created product

    Syncing a product fetches the orcharhino client from the upstream URL to your orcharhino instance.

  4. Create new content view

    Creating a new content view is required to make the .rpm and .deb packages consumable by content hosts.

  5. Create activation key

    Creating a new activation key is required in order to attach content hosts to orcharhino.

  6. (Optional) Create new host group

    Creating a new host group simplifies the process of creating hosts.

This allows you to attach and deploy hosts running specific operating systems to/from orcharhino.

Upgrading orcharhino Clients

Important

Refer to the ATIX Service Portal for instructions on how to upgrade SLES clients to SLES clients v2.

Every orcharhino release also contains newly built orcharhino clients. There are two steps required to make use of these:

  1. Sync product

    Synchronize all products containing the orcharhino client repositories. Navigate to the products page and select Sync Now from the action menu. It is usually best to add a sync plan to a product, so that all repositories within are synchronized on a regular basis.

  2. Publish content view

    Publish a new version of the content view containing the orcharhino client repositories.

Now, hosts subscribed to an activation key containing the client repositories or corresponding content views will automatically be able to receive the newly synchronized orcharhino clients. Refer to activation keys and content hosts for more information.