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.
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.
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. Make sure 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, then you should read instructions for the upgrade to version 5.2 as well as instructions for the upgrade to version 5.1. Please contact us if you are unsure on how to start with your orcharhino 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:
Note that upgrading an orcharhino proxy requires a one time SSH connection to the orcharhino proxy.
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):
This allows you to add the orcharhino 5.3 repository.
Add repository to content view
Add the new orcharhino 5.3 repository to the orcharhino proxy content view.
Publish new version of the content view
Go to Content > Content Views and select the content view of the orcharhino proxy.
Publish a new version of the content view for the orcharhino proxy by clicking the Publish New Version button.
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:
Run the following command on the orcharhino proxy to update the packages, i.e. download their metadata:
Upgrade the orcharhino proxy
Run the following command on the orcharhino proxy to upgrade its version: