Integrating IBM Cloud Event Management (CEM) with Netcool Operations Insight

Configuring the ObjectServer

This section only applies when preparing an on-premise ObjectServer with the required fields. For NOI on ICP, you can skip this section because the required fields are already pre-installed in the ObjectServer.

To integrate with IBM CEM, there are several additional ObjectServer fields required by the probe to map CEM event attributes into the alerts.status table. The additional fields can be added using $OMNIHOME/bin/nco_sql, and must be done prior to installing the chart using the following steps:

1. Copy and save the following Structured Query Language (SQL) commands into a file named cem.sql:

   -- Filename: cem.sql
   -- This SQL file adds the fields required by IBM Cloud Event Management
   ALTER TABLE alerts.status ADD COLUMN CEMSubscriptionID VARCHAR(64);
   go
   
   ALTER TABLE alerts.status ADD COLUMN CEMIncidentUUID VARCHAR(64);
   go
   
   ALTER TABLE alerts.status ADD COLUMN NodeType VARCHAR(64);
   go
   
   ALTER TABLE alerts.status ADD COLUMN CEMEventId  VARCHAR(64);
   go
   
   ALTER TABLE alerts.status ADD COLUMN CEMErrorCode INTEGER;
   go
   
   ALTER TABLE alerts.status ADD COLUMN CEMDeduplicationKey  VARCHAR(64);
   go

2. Load the SQL commands contained in the cem.sql file using the following command:

   $OMNIHOME/bin/nco_sql -server server_name \
   -user user_name \
   -password 'password' < cem.sql

Configuring IBM CEM

To integrate and receive events from IBM Cloud Event Management, the ibm-cem chart must be installed in the same cluster.

For detailed steps on installing and configuring IBM Cloud Event Management in IBM Cloud Private (ICP), see Installing in IBM Cloud Private.

Use the following steps to create an outgoing integration, register the probe's webhook endpoint, and create an event forwarding policy in IBM CEM.

1. Configure and install the ibm-netcool-probe chart in ICP. Ensure that the cemProbe.enabled parameter is set to true to enable a probe endpoint for CEM. For more details, refer to the chart's configuration section.
2. Follow the instructions in the Notes section after installing the chart to obtain the probe's webhook endpoint URL. From the UI, go to Menu -> Monitor Health -> Helm Releases -> (Probe release name)
3. As a CEM Administrator, go to Menu -> Workload -> Brokered Services -> <CEM Instance Name> and click Launch to launch and log in to the CEM UI.
4. Go to the Administration page and click Integrations.
5. Click the Configuring an integration button. Select an Outgoing integration for Netcool/OMNIbus. Click Configure and use the following steps to configure the outgoing integration.
   1. Provide a name for this outgoing integration. You can use the probe release name for easy reference.
   2. You can skip Step 2. Download and decompress a package of configuration files because this probe chart has the required configuration and rules files preconfigured.
   3. Enter the probe webhook endpoint obtained from the probe release in the previous step.
   4. Skip Step 4. Enter your credentials because this step is not applicable when integrating with a probe in ICP.
   5. Turn on the integration.
   6. Click Save and verify that the outgoing integration is created successfully.
6. To create an event forwarding policy, go to the Administration page and click Policies, then click Create event policy to create a new event policy and use the following steps to configure the event policy. You may add a forwarding rule in an existing policy if necessary.
   1. Give a name and description for this policy.
   2. Select All Events to forward all CEM events to Netcool/OMNIbus. Optionally, you may configure the policy to only forward selected events.
   3. Check the Forwarding events option, click the Add integrations button and then select the outgoing integration created in the previous step.
   4. Enable this event policy.
   5. Click Save and verify that the event policy is successfully installed. It should be listed in the Policies page.
7. It may take a moment before CEM starts to forward events to Netcool/OMNIbus. Verify that CEM events appear in the Netcool/OMNIbus Event List.