Upgrading Netcool Operations Insight on Red Hat OpenShift with the Operator Lifecycle Manager (OLM) user interface

Edit online

Use these instructions to upgrade an existing Netcool® Operations Insight® deployment from version 1.6.4 or 1.6.5 to 1.6.6, with the Red Hat® OpenShift® Operator Lifecycle Manager (OLM) user interface (UI).

Before you begin

Ensure that you complete all the steps in Preparing your cluster. Most of these steps were completed as part of your previous Netcool Operations Insight deployment.
Ensure that you have an adequately sized cluster. For more information, see Sizing for a Netcool Operations Insight on Red Hat OpenShift deployment.
Configure persistent storage for your deployment. Only version 1.6.5 deployments with persistence enabled are supported for upgrade to version 1.6.6.
Before you upgrade to version 1.6.6, if present, remove the noi-root-ca secret by running the following command:
```
oc delete secret noi-root-ca
```
Before you upgrade to version 1.6.6, if present, reverse any image overrides from the test fix of the previous release.
1. Edit the custom resource (CR).
```
oc edit noi <release-name>
```
  Where <release-name> is the release name, for example, evtmanager.
2. Manually remove the tag, name, and digest entries of image overrides from the helmValuesNOI section of the YAML file.

If you want to verify the origin of the catalog, then use the OLM UI and CASE upgrade method instead. For more information, see Upgrading a cloud deployment offline using the OLM UI and CASE.

All the required images for version 1.6.6 are either in the freely accessible operator repository (icr.io/cpopen), or in the IBM® Entitled Registry (cp.icr.io) for which you will require an entitlement key.

Procedure

Upgrade the Catalog source

From the Red Hat OpenShift OLM UI, navigate to Administration > Cluster Settings, and then select the OperatorHub configuration resource under the Global Configurations tab.
Under the Sources tab, click the existing Netcool Operations Insight catalog source.
Edit the catalog source YAML and replace spec.image with the Netcool Operations Insight catalog source name and image for version 1.6.6, icr.io/cpopen/ibm-operator-catalog:latest. Select Save.

Upgrade the Netcool Operations Insight operator

To upgrade the operator for OLM UI, navigate to Operators > Installed Operators. Go to the Subscription tab and select Update channel to v1.10.

Note: It takes a few minutes for IBM Cloud Pak for Watson™ AIOps Event Manager to install. When installed, ensure that the status of IBM Cloud Pak for Watson AIOps Event Manager is Succeeded before you proceed to the next steps.

Upgrade the Netcool Operations Insight instance

From the Red Hat OpenShift OLM UI, upgrade the Netcool Operations Insight instance. Go to Operators > Installed Operators and select your Project. Then select IBM Cloud Pak for Watson AIOps Event Manager.
Go to the All instances tab and select your instance. Edit the Netcool Operations Insight instance YAML.
Update spec.version: 1.6.5 to spec.version: 1.6.6.
Select Save and wait until all pods are restarted. You can monitor progress from the Red Hat OpenShift UI.
Delete the CEM deployment by running the following command:
```
oc delete deployment <release-name>-ibm-cem-akora-app-cem
```
If you cannot log in to the Netcool Operations Insight UI, for example Web GUI, after all pods are restarted, run the following command in the webgui pod:
```
oc exec -ti <release-name>-webgui-0 bash
/home/netcool/app/jazz/ui/bin/consolecli.sh RestoreConfigFromDb --username smadmin --password <smadmin password>
```
Where <smadmin password> is the smadmin password.
To obtain the smadmin password, run the following command:
```
oc get secret <release_name>-was-secret -o json -n namespace | grep WAS_PASSWORD | cut -d : -f2 | cut -d '"' -f2 | base64 -d;echo
```
Where:
- <release_name> is the release name for the current cluster.
- namespace is the namespace that Netcool Operations Insight is deployed into, which can be retrieved by using the oc project command.
For more information, see Retrieving passwords from secrets.

What to do next

After you upgrade, if the GitLab and SevOne observers are not listed in the YAML, run the oc edit noi command and add the following lines:

observers:
  gitlab: true
  sevone: true