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 Netcool® Operations Insight® installation.

The following prerequisites must be met:

The primary and backup ObjectServers are both running, and are listening on external IP addresses. Only a standard primary and backup configuration is supported.
Installation Manager V1.9 or later must be run in GUI mode.
Note: 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 Netcool Operations Insight must be at the same version as Cloud Native Analytics. For more information, see V1.6.0.3 Product and component version matrix. If on-premises Netcool Operations Insight is at V1.6.0.2, then some of the on-premises components must be at updated levels. For more information, see Update on-premises components.
Cloud Native Analytics is successfully deployed.

Use the following steps to configure OAuth authentication between an on-premises Netcool Operations Insight installation and a Cloud Native Analytics deployment. 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. In Installation Manager, go to Preferences and add the location for the cloud repository that was automatically created when you installed stand-alone Cloud Native Analytics.
  This repository is https://netcool.helm_release_name.clustername/im/repository
  Where
  - helm_release_name is the Cloud Native Analytics Helm release name.
  - clustername is in the format apps.machine.os.xyz.ibm.com
  This repository contains the integration kit package that is required by your Netcool Operations Insight on-premises installation. Select Apply and OK.
2. From the main Installation Manager screen, select Install, and from the Install Packages window select Netcool Hybrid Deployment Option Integration Kit.
3. Proceed through the windows, accept the license and the defaults, and enter the on-premises WebSphere® Application Server password.
4. On the window OAuth 2.0 Configuration, set Redirect URL to the URL of your Cloud Native Analytics installation.
  This URL is https://netcool.helm_release_name.clustername:443/callback
  Where
  - helm_release_name is the Cloud Native Analytics Helm release name
  - clustername is in the format apps.machine.os.xyz.ibm.com
5. On the window OAuth 2.0 Configuration, set Client ID and Client Secret to the values that were set for them in secret helm_release_name-was-oauth-cnea-secrets when you installed Cloud Native Analytics.
  Retrieve these values by running the following commands on your Cloud Native Analytics deployment.
```
kubectl get secret helm-release-name-was-oauth-cnea-secrets -o json -n namespace| grep client-secret | cut -d : -f2 | cut -d '"' -f2 | base64 -d;echo
kubectl get secret helm-release-name-was-oauth-cnea-secrets -o json -n namespace | grep client-id | cut -d : -f2 | cut -d '"' -f2 | base64 -d;echo
```
  Where
  - helm_release_name is your Cloud Native Analytics Helm release name.
  - namespace is the name of the namespace in which Cloud Native Analytics is installed.
6. Select Next, and Install.
Restart Dashboard Application Services Hub on your Netcool Operations Insight 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.