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 1.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® Container Platform. For more information, see Solution Overview.
  • The cloud native components of Netcool Operations Insight on Red Hat OpenShift Container Platform are successfully deployed.
Note: To support incident creation from the Alert Viewer, the IsInIncident column must exist in the IBM Tivoli® Netcool/OMNIbus alerts.status table. The IsInIncident column must also be visible in the Web GUI before the Netcool Hybrid Deployment Option Integration Kit. is installed.
  • To verify that the IsInIncident column exists in the alerts.status table, run the following commands:
    $OMNIHOME/bin/nco_sql -user username -password password -server server_name
    describe alerts.status;
    go
  • To verify that the IsInIncident column is present in Web GUI, go to Administration > Views and select the default global view. Check that the IsInIncident column is listed under available fields. The column doesn't need to be selected, but it must be listed.

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 Container Platform. If you have more than one WebGUI/DASH node, then this procedure must be run on each WebGUI/DASH node.

  1. 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
      where IM_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 Container Platform 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-release_name.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-release_name.apps.fqdn/users/api/authprovider/v1/was/return. Where
      • release_name is the name of your deployment, as specified by the value used for name (OLM UI Form view), or name in the metadata section of the noi.ibm.com_noihybrids_cr.yaml or noi.ibm.com_nois_cr.yaml files (YAML view).
      • 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 the release_name-was-oauth-cnea-secrets secrete, 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.
      oc get secret release_name-was-oauth-cnea-secrets -o json -n namespace| grep client-secret | cut -d : -f2 | cut -d '"' -f2 | base64 -d;echo
      oc get secret release_name-was-oauth-cnea-secrets -o json -n namespace | grep client-id | cut -d : -f2 | cut -d '"' -f2 | base64 -d;echo
      Where
      • release_name is the name of your deployment, as specified by the value used for name (OLM UI Form view), or name in the metadata section of the noi.ibm.com_noihybrids_cr.yaml or noi.ibm.com_nois_cr.yaml files (YAML view).
      • namespace is the name of the namespace in which the cloud native Netcool Operations Insight components are installed.
    7. Select Next and Install.
      Note: If an error similar to the following is displayed, ensure that IBM Netcool/OMNIbus Web GUI is updated to the correct version:
      replaceXML doesn't support the "appendLine" attribute
      For more information, see Solution Overview.
      Draft comment: DEIRDRELAWTON
      Note about Web GUI
  2. 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 /home/netcool/app/jazz/profile.
Note:
Draft comment: LOUISERoberts
#5029 #3315 This is documented in known issues, but its been requested that it be here too, due to likelihood of users hitting this defect.
After the Netcool Hybrid Deployment Option Integration Kit. integration kit has been installed, you will no longer be able to create Netcool/Impact connections using the on-premises Dashboard Application Services Hub UI. If you need to configure a new connection then you must do so using the following procedure:
  1. Use the command line to configure the required connection. Run the following command on the on-premises Web GUI deployment:
    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 /home/netcool/app/jazz/.
    • password is the password for the smadmin administrative user
    • host is the Impact server, for example test1.example.com
    • input.txt has content similar to the following (where host is the Impact server, for example test1.example.com)
      {
           "authUser": "impactuser",
           "authPassword": "netcool",
           "baseUrl": "https:\/\/test1.example.com:17311\/ibm\/tivoli\/rest",
           "datasetsUri": "\/providers\/Impact_NCICLUSTER.test1.example.com\/datasets",
           "datasourcesUri": "\/providers\/Impact_NCICLUSTER.test1.example.com\/datasources",
           "description": "Impact_NCICLUSTER",
           "externalProviderId": "Impact_NCICLUSTER",
           "id": "Impact_NCICLUSTER.test1.example.com",
           "label": "Impact_NCICLUSTER",
           "remote": true,
           "sso": false,
           "type": "Impact_NCICLUSTER",
           "uri": "\/providers\/Impact_NCICLUSTER.test1.example.com",
           "useFIPS": true
        }
  2. Restart Dashboard Application Services Hub on your Operations Management on-premises installation by using the following command.
    <JazzSM_WAS_Profile>/bin/stopServer.sh server1 -user smadmin -password <smadmin_password>
    Where:
    • <smadmin_password> is taken from the smadmin secret.
    • JazzSM_WAS_Profile is the location of the application server profile that is used for Jazz for Service Management. This is usually /home/netcool/app/jazz/profile.

Uninstalling

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

  1. Start Installation Manager in GUI mode with the following commands:
    cd IM_dir/eclipse
    ./IBMIM
    where IM_dir is the Installation Manager Group installation directory, for example /home/netcool/IBM/InstallationManager/eclipse.
  2. From the main Installation Manager screen, select Uninstall, and from Installed Packages select Netcool Hybrid Deployment Option Integration Kit and Uninstall.
  3. 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 to complete the following steps:

  1. Use Installation Manger to uninstall the Netcool Hybrid Deployment Option Integration Kit.
  2. 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