Online starter installation of Netcool Operations Insight on Red Hat OpenShift

If you are a trial user of Event Manager, or you want a proof-of-concept deployment that does not require a sustained workload, then consider a starter installation. Use a starter installation to get a smaller, nonproduction deployment up and running quickly. If you require an air-gapped (offline) deployment, then you must complete a production installation.

If you require a production deployment, see Installing Netcool Operations Insight with the Operator Lifecycle Manager (OLM) user interface.

Before you begin

You must provision a cluster that meets the following requirements.

Limitations

  • The installation is a fully containerized deployment.
  • The starter installation installs Event Manager, and does not install IBM® Cloud Pak for Watson™ AIOps AI Manager, IBM Tivoli® Netcool/OMNIbus Integrations, or IBM Cloud Pak for Watson AIOps metric anomaly detection.
  • Changing a trial deployment type to a production deployment is not supported.

Installation procedure

Follow these steps to install Netcool Operations Insight on Red Hat OpenShift.

1. Install Red Hat OpenShift Container Platform Container Platform

For more information about the supported Red Hat OpenShift Container Platform versions, see System requirements on cloud.

Install Red Hat OpenShift Container Platform by using the instructions in Installing Red Hat OpenShift Container Platform Opens in a new tab.

2. Install the Red Hat OpenShift CLI

Install the Red Hat OpenShift Container Platform command line interface (oc) on your cluster's boot node and run oc login. For more information, see Getting started with the OpenShift CLI external icon in the Red Hat OpenShift Container Platform documentation.

3. Configure storage

You must configure your own storage for use with Event Manager. For more information, see Storage.

4. Create a custom project (namespace)

Create a project (namespace) called cp4waiops-emgr for your Event Manager deployment, by running the following command:
oc create namespace cp4waiops-emgr

5. Create the entitlement key pull secret

  1. Log in to MyIBM Container Software Library external icon with the IBMid and password details that are associated with the entitled software.
  2. In the Entitlement keys section, select Copy key to copy your entitlement key to the clipboard.
  3. From the Red Hat OpenShift Container Platform CLI, run the following command:
    oc create secret docker-registry noi-registry-secret \
        --docker-username=cp\
        --docker-password=<entitlement-key> \
        --docker-server=cp.icr.io \
        --namespace=cp4waiops-emgr
    Where <entitlement-key> is the entitlement key that you copied in the previous step.

6. Ensure external traffic access to Event Manager

To allow traffic, run the following command to ensure that the endpointPublishingStrategy.type parameter in your ingresscontroller is set to HostNetwork.
if [ $(oc get ingresscontroller default -n openshift-ingress-operator -o jsonpath='{.status.endpointPublishingStrategy.type}') = "HostNetwork" ]; then oc patch namespace default --type=json -p '[{"op":"add","path":"/metadata/labels","value":{"network.openshift.io/policy-group":"ingress"}}]'; fi

7. Download the CASE

  1. Download and install the most recent version of IBM Catalog Management Plug-in for IBM Cloud® Paks from the IBM/ibm-pak-plugin external icon. Extract the binary file by entering the following command:
    tar -xf oc-ibm_pak-linux-amd64.tar.gz
  2. Run the following command to move the file to the /usr/local/bin directory:
    mv oc-ibm_pak-linux-amd64 /usr/local/bin/oc-ibm_pak
    Note: If you are installing as a nonroot user, you must use sudo.
  3. Confirm that oc ibm-pak is installed by running the following command:
    oc ibm-pak --help
    Expected result: The plug-in usage is displayed.
  4. Note: If you want to install the previous 1.6.7 version, specify --version 1.7.0 in the oc ibm-pak get command.
    Download the Netcool Operations Insight CASE bundle (ibm-netcool-prod) to your Red Hat OpenShift Container Platform cluster.
  5. Check that the CASE repository URL is pointing to the default https://github.com/IBM/cloud-pak/raw/master/repo/case/ location by running the oc ibm-pak config command.

    Example output:

    Repository Config
    
    Name                        CASE Repo URL
    ----                        -------------
    IBM Cloud-Pak Github Repo * https://github.com/IBM/cloud-pak/raw/master/repo/case/
    
    If the repository is not pointing to the default location (asterisk indicates default URL), then run the following command.
    oc ibm-pak config repo 'IBM Cloud-Pak Github Repo' --enable
    If the URL is not displayed, then add the repository by running the following command.
    oc ibm-pak config repo 'IBM Cloud-Pak Github Repo' --url https://github.com/IBM/cloud-pak/raw/master/repo/case/
  6. Run the following commands.
    export CASE_NAME=ibm-netcool-prod
    export CASE_VERSION=1.8.0
    Download the Netcool Operations Insight CASE bundle (ibm-netcool-prod) to your Red Hat OpenShift Container Platform cluster.
    oc ibm-pak get $CASE_NAME --version $CASE_VERSION

8. Create the catalog source

Generate the catalog source.
oc ibm-pak generate mirror-manifests ${CASE_NAME} icr.io --version ${CASE_VERSION}
View the catalog source.
cat ~/.ibm-pak/data/mirror/$CASE_NAME/$CASE_VERSION/catalog-sources-linux-amd64.yaml
Apply the catalog source.
oc apply -f ~/.ibm-pak/data/mirror/$CASE_NAME/$CASE_VERSION/catalog-sources-linux-amd64.yaml

9. Install the Event Manager operator

oc ibm-pak launch \
$CASE_NAME \
--version $CASE_VERSION \
--namespace $TARGET_NAMESPACE \
--inventory noiOperatorSetup \
--action install-operator

Where $NAMESPACE is the custom namespace to be used for your deployment.

10. Install Event Manager

Create an instance of the Event Manager custom resource.
  1. From the Red Hat OpenShift Container Platform OLM UI, go to Operators > Installed Operators, and select IBM Cloud Pak for Watson AIOps Event Manager. Under Provided APIs > NOI select Create Instance.
  2. Use the Form view to configure the properties for the deployment, and select Create. For more information, see Cloud operator properties.