Online starter installation of Netcool Operations Insight on Red Hat OpenShift

Provision a cluster that meets the following requirements.

• The cluster's hardware architecture is AMD64.
• The cluster meets the system requirements for a trial Netcool Operations Insight on Red Hat OpenShift deployment. For more information, see Sizing for a Netcool Operations Insight on Red Hat OpenShift deployment.
• You have administrative privileges on the cluster.
• The cluster has access to the internet to pull images.
• Red Hat OpenShift Container Platform requires a user with cluster-admin privileges for the following operations:
  • Create a custom project
  • Ensure external traffic access to Netcool Operations Insight on Red Hat OpenShift
  • Create the catalog source
  • Install the Netcool Operations Insight on Red Hat OpenShift operator

• The installation is a fully containerized deployment.
• The starter installation installs Netcool Operations Insight on Red Hat OpenShift, and does not install IBM® Cloud Pak for AIOps, IBM Tivoli® Netcool/OMNIbus Integrations, or IBM Cloud Pak for AIOps metric anomaly detection.
• Changing a trial deployment type to a production deployment is not supported.

Create a project (namespace) called cp4aiops-emgr for your Netcool Operations Insight on Red Hat OpenShift deployment, by running the following command:

oc create namespace cp4aiops-emgr

1. Log in to MyIBM Container Software Library 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=cp4aiops-emgr

   Where <entitlement-key> is the entitlement key that you copied in the previous step.

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

1. Download and install version 1.11.2 or later of IBM Catalog Management Plug-in for IBM Cloud® Paks for your host operating system from github.com/IBM/ibm-pak-plugin. Version 1.10.0 or earlier is also supported. Versions 1.11.0 and 1.11.1 are not supported. 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 the 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.10 version, specify --version 1.10.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.11.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

Install the catalog source and set the recursive flag and input directory.

oc ibm-pak launch \
$CASE_NAME \
--version $CASE_VERSION \
--namespace openshift-marketplace \
--inventory noiOperatorSetup \
--action install-catalog \
--args "--recursive --inputDir $HOME/.ibm-pak/data/cases/$CASE_NAME/$CASE_VERSION"

Install the operator and set the recursive flag and input directory.

oc ibm-pak launch \
$CASE_NAME \
--version $CASE_VERSION \
--namespace $TARGET_NAMESPACE \
--inventory noiOperatorSetup \
--action install-operator \
--args "--recursive --inputDir $HOME/.ibm-pak/data/cases/$CASE_NAME/$CASE_VERSION"

Create an instance of the Netcool Operations Insight on Red Hat OpenShift custom resource.

1. From the Red Hat OpenShift Container Platform OLM UI, go to Operators > Installed Operators, and select IBM Cloud Pak for 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.