Installing the integration kit

To create a hybrid installation, you must use IBM® Installation Manager to install the Netcool Hybrid Deployment Option Integration Kit on your on-premises Operations Management installation.

Prerequisites

The primary and backup ObjectServers are both running, and are listening on external IP addresses.
Installation Manager V1.9 or later can be run in GUI mode. If you are running an older version of Installation Manager, the following log error is displayed in the Installation Manager logs:
```
javax.net.ssl.SSLException: Connection has been shutdown: javax.net.ssl.SSLHandshakeException: Received fatal alert: handshake_failure
```
On-premises Operations Management must be at the same version as Netcool® Operations Insight® on Red Hat OpenShift. For more information, see V1.6.1 Product and component version matrix.
The cloud native components of Netcool Operations Insight on Red Hat OpenShift are successfully deployed.

Installing

Use the following steps to configure OAuth authentication between an on-premises Operations Management installation and a deployment of cloud native Netcool Operations Insight components on Red Hat OpenShift. If you have more than one WebGUI/DASH node, then this procedure must be run on each WebGUI/DASH node.

Use Installation Manager to install the Netcool Hybrid Deployment Option Integration Kit.
1. Start Installation Manager in GUI mode with the following commands:
```
cd IM_dir/eclipse
./IBMIM
```
  whereIM_dir is the Installation Manager Group installation directory, for example /home/netcool/IBM/InstallationManager/eclipse.
2. In Installation Manager, navigate to Preferences->Repositories->Add Repository, and add the location for the cloud repository that was automatically created when you installed the cloud native Netcool Operations Insight components.Use the following command on your Red Hat OpenShift infrastructure node to find the location of the repository, where namespace is the namespace in which your cloud native Netcool Operations Insight components are deployed:
```
oc get routes -n namespace | grep repository
```
  This repository contains the integration kit package that is required by your Operations Management on-premises installation. A repository example name is https://netcool.custom_resource.apps.fqdn/im/repository/repository.config.Select Apply and OK.
3. From the main Installation Manager screen, select Install, and from the Install Packages window select Netcool Hybrid Deployment Option Integration Kit.
4. Proceed through the windows, accept the license and the defaults, and enter the on-premises WebSphere® Application Server password.
5. On the window OAuth 2.0 Configuration, set Redirect URL to the URL of your cloud native Netcool Operations Insight components deployment. This URL is https://netcool.custom_resource.apps.fqdn/users/api/authprovider/v1/was/return Where
  - custom_resource is the name of your deployment, as specified by the value used for name (OLM UI install), or metadata.name in noi.ibm.com_noihybrids_cr.yaml/noi.ibm.com_nois_cr.yaml (CLI install).
  - fqdn is the cluster FQDN
6. On the window OAuth 2.0 Configuration, set Client ID and Client Secret to the values that were set for them in secret custom_resource-was-oauth-cnea-secrets when you installed the cloud native Netcool Operations Insight components.Retrieve these values by running the following commands on your cloud native Netcool Operations Insight components deployment.
```
kubectl get secret custom_resource-was-oauth-cnea-secrets -o json -n namespace| grep client-secret | cut -d : -f2 | cut -d '"' -f2 | base64 -d;echo
kubectl get secret custom_resource-was-oauth-cnea-secrets -o json -n namespace | grep client-id | cut -d : -f2 | cut -d '"' -f2 | base64 -d;echo
```
  Where
  - custom_resource is the name of your deployment, as specified by the value used for name (OLM UI install), or metadata.name in noi.ibm.com_noihybrids_cr.yaml/noi.ibm.com_nois_cr.yaml (CLI install).
  - namespace is the name of the namespace in which the cloud native Netcool Operations Insight components are installed.
7. Select Next and Install.
Restart Dashboard Application Services Hub on your Operations Management on-premises installation by using the following commands.
```
cd JazzSM_WAS_Profile/bin
./stopServer.sh server1 -username smadmin -password password
./startServer.sh server1
```
where JazzSM_WAS_Profile is the location of the application server profile that is used for Jazz for Service Management. This is usually /opt/IBM/JazzSM/profile.

Note: After the Netcool Hybrid Deployment Option Integration Kit. integration kit has been installed, you will no longer be able to create Impact connections using the on-premises DASH UI. If you need to configure a new connection then you must do so using the following procedure:

Use the command line to configure the required connection.

JazzSM_path/ui/bin/restcli.sh putProvider -username smadmin -password password -provider "Impact_NCICLUSTER.host" -file input.txt

where

JazzSM_path is the name of the Jazz for Service Management installation, usually /opt/IBM/JazzSM.
password is the password for the smadmin administrative user
host is the Impact server, for example test1.fyre.ibm.com

input.txt has content similar to the following (where host is the Impact server, for example test1.fyre.ibm.com)

{
     "authUser": "impactuser",
     "authPassword": "netcool",
     "baseUrl": "https:\/\/test1.fyre.ibm.com:17311\/ibm\/tivoli\/rest",
     "datasetsUri": "\/providers\/Impact_NCICLUSTER.test1.fyre.ibm.com\/datasets",
     "datasourcesUri": "\/providers\/Impact_NCICLUSTER.test1.fyre.ibm.com\/datasources",
     "description": "Impact_NCICLUSTER",
     "externalProviderId": "Impact_NCICLUSTER",
     "id": "Impact_NCICLUSTER.test1.fyre.ibm.com",
     "label": "Impact_NCICLUSTER",
     "remote": true,
     "sso": false,
     "type": "Impact_NCICLUSTER",
     "uri": "\/providers\/Impact_NCICLUSTER.test1.fyre.ibm.com",
     "useFIPS": true
  }

Restart Dashboard Application Services Hub on your Operations Management on-premises installation by using the following commands.
```
cd JazzSM_WAS_Profile/bin
./stopServer.sh server1 -username smadmin -password password
./startServer.sh server1
```
where JazzSM_WAS_Profile is the location of the application server profile that is used for Jazz for Service Management. This is usually /opt/IBM/JazzSM/profile.

Uninstalling

If you want to uninstall the Netcool Hybrid Deployment Option Integration Kit, then use Installation Manager.

Start Installation Manager in GUI mode with the following commands:
```
cd IM_dir/eclipse
./IBMIM
```
whereIM_dir is the Installation Manager Group installation directory, for example /home/netcool/IBM/InstallationManager/eclipse.
From the main Installation Manager screen, select Uninstall, and from Installed Packages select Netcool Hybrid Deployment Option Integration Kit and Uninstall.
After the Netcool Hybrid Deployment Option Integration Kit has been uninstalled, cloud native Netcool Operations Insight components related columns, view and groups are still displayed. If you want to remove these then you must uninstall the cloud native Netcool Operations Insight components deployment, or change it's integration point. This is because the removal of the Netcool Hybrid Deployment Option Integration Kit does not remove the WebGUI console integration, which is created by the deployment of the cloud native Netcool Operations Insight components.

Upgrading

The Update option in Installation Manager is not currently supported for the Netcool Hybrid Deployment Option Integration Kit. To update the Netcool Hybrid Deployment Option Integration Kit to a newer version use the Installing and Uninstalling sections above to complete the following steps:

Use Installation Manger to uninstall the Netcool Hybrid Deployment Option Integration Kit.
Use Installation Manger to install the new version of the Netcool Hybrid Deployment Option Integration Kit, ensuring that you follow the last step to restart Dashboard Application Services Hub