This page describes the actions to take after the upgrade is completed and all relevant validation tests have passed.
Check service state and alarms
Refer to the verification section in Sh Cache Microservice Install guide to check the state of the Sh Cache Microservice.
Verify SAS configuration
If your deployment is now running Rhino 2.6.0 or later and includes a MetaView Service Assurance Server (SAS),
verify the SAS configuration in Rhino is as expected.
See Sh Cache Microservice Install guide
in the Rhino documentation.
Check that Sh Cache Microservice requests made in your validation tests appear in SAS.
Archive the downlevel export generated during the upgrade, and generate a new export
On the first node, orca will have generated an export of the Rhino installation at the downlevel version, prior to
any migration or upgrade steps. This can be found in the ~/export directory, labelled with the version and cluster ID,
and is a useful "restore point" in case problems with the upgrade are encountered later that cannot be simply undone
with the rollback command. Copy (for example using
rsync) the downlevel export directory with all its contents to your backup storage, if you have one.
Follow the Rhino documentation to generate a post-upgrade export and archive this too.
|
Uplevel exports generated during major upgrade
Note that during major upgrade These exports can be ignored, and deleted at a later date. |
Archive the upgrade logs
In the directory from which orca was run, there will be a directory logs containing many subdirectories with log
files. Copy (for example using rsync) this logs directory with all its contents to your backup storage, if you have
one. These logs can be useful for Metaswitch Customer Care in the event of a problem with the upgrade.
Save the install.properties file
It is a good idea to save the install.properties file for use in a future upgrade.
Remember that the file is currently on the machine that you chose to run orca from,
and that may not be the same machine chosen by someone doing a future upgrade.
A good location to put the file is in a /home/sentinel/install directory.
If required, clean up downlevel clusters and unneeded exports
Once the upgrade is confirmed to be working, you may wish to clean up old downlevel cluster to save disk space.
Run the status command to view existing clusters and exports
Run the status command and observe the clusters and exports sections of the output.
./orca --hosts host1 status
Identify any clusters or exports you no longer wish to keep. Note their cluster IDs, which is the last part of the name. For example, given this output:
Status of host host1
Clusters:
- ShCM-1.0.0.1-cluster-41
- ShCM-1.0.0.1-cluster-42
- ShCM-1.0.0.3-cluster-43 - LIVE
[...]
Exports:
- ShCM-1.0.0.1-cluster-41
- ShCM-1.0.0.2-cluster-42
- ShCM-1.0.0.2-cluster-42-transformed-for-1.0.0.3
- ShCM-1.0.0.3-cluster-43
[...]
Status of host host2
Clusters:
- ShCM-1.0.0.1-cluster-41
- ShCM-1.0.0.2-cluster-42
- ShCM-1.0.0.3-cluster-43 - LIVE
[...]you may decide to delete cluster 41 and exports 41 and 42.
|
Retain one old cluster
You are advised to always leave the most recent downlevel cluster in place as a fallback. Be sure you have an external backup of any export directories you plan to delete, unless you are absolutely sure that you will not need them in the future. |
Update Java version of other applications running on the host
If performing a major upgrade with a new version of Java, orca will install the new Java but it will only be
applied to the new Rhino installation. Global environment variables such as JAVA_HOME, or other applications that use
Java, will not be updated.
The new Java installation can be found at ~/java/<version> where <version> is the JDK version that orca installed,
e.g. 8u162. If you want other applications running on the node to use this new Java installation, update the
appropriate environment variables and/or configuration files to reference this directory.
