This section documents information concerning the upgrade. Be sure you are also familiar with the new features and new configuration introduced in the uplevel Sh Cache Microservice software.
Information required
Maintenance window
In general an upgrade of an Sh Cache Microservice node can be completed in a single maintenance window, though for operational reasons you may wish to use more than one. The maintenance window should be of adequate length (at least 1-2 hours the each node and validation tests according to your test plan).
Files required
Upgrade bundle
Your Metaswitch Customer Care Representative should have provided you with an upgrade bundle, normally named
ShCM-<uplevel-version>-upgrade-bundle.zip or similar. unzip the bundle to a directory of your choice
and cd to it.
|
orca working directory
orca must always be run from the directory where it resides. It will fail to operate correctly if run from any other location. |
Verify the orca script is present and executable by running ./orca --help. You should see usage information.
Verify that orca can contact the hosts you wish to upgrade by running ./orca --hosts host1 status. You
should see status information, such as the current live cluster and lists of services, about all the hosts specified.
|
SSH access to hosts
orca requires passwordless SSH access to the hosts. If this is not the case, orca will throw an error saying it is unable to contact one or more of the hosts. Ensure SSH key-based access is set up to all such hosts and retry the status command until it works. |
