IBM Performance Management

Configuring the integration for Netcool/OMNIbus

To enable integration with Netcool/OMNIbus, you must copy the event rules to the Probe for Tivoli® EIF and modify them. You must also update the Netcool/OMNIbus ObjectServer and the database schema, and configure the Performance Management server to forward events.

About this task

After you install the Performance Management server, the required configuration files are in the install_dir/ccm/omnibus directory where install_dir is the default /opt/IBM/ or C:\IBM\ or the directory that you specified during the Performance Management server installation.

itm_apm_db_update.sql
itm_event.rules
itm_apm_event.rules

Important: You must complete these steps even if your Probe for Tivoli EIF and Netcool/OMNIbus ObjectServer are already integrated with IBM® Tivoli Monitoring, Probe for Tivoli EIF, IBM SmartCloud® Monitoring - Application Insight, IBM SmartCloud Application Performance Management, or a previous version of Performance Management.

In this procedure, when you follow links to the IBM Tivoli Monitoring documentation, complete only the steps that are provided at the linked page.

Procedure

Copy the itm_event.rules and itm_apm_event.rules files to the Probe for Tivoli EIF installation directory.
install_dir/tivoli/netcool/omnibus/probes/linux2x86

install_dir\Tivoli\Netcool\omnibus\probes\win32

where install_dir is the default /opt/IBM/ or C:\IBM\ or the directory that you specified during the Performance Management server installation.
Open the Probe for Tivoli EIF tivoli_eif.rules file in a text editor and remove the comment from the line that references the itm_event.rules file. For detailed steps, see Updating the rules files of the EIF probe in the IBM Tivoli Monitoring documentation.
If you are using a multitier OMNIbus solution, complete all the tasks as described in the Updating the Netcool/OMNIbus ObjectServer with IBM Tivoli Monitoring attributes, tables, and triggers section.
Update the Netcool/OMNIbus ObjectServer database schema by loading the itm_apm_db_update.sql file into the database with the following command:
nco_sql
```
$OMNIHOME/bin/nco_sql -user username -password password -server server_name -input path_to_file/itm_apm_db_update.sql
```
For Example:
```
$OMNIHOME/bin/nco_sql -user smadmin -password passw0rd -server NCOMS 
-input /tmp/apm/itm_apm_db_update.sql
```
isql
```
path_to_file\itm_apm_db_update.sql | %OMNIHOME%\..\bin\isql -U username -P password -S server_name
```
For Example:
```
\temp\apm\itm_apm_db_update.sql | %OMNIHOME%\..\bin\isql -U smadmin -P passw0rd -S NCOMS
```
Important: The following error messages might be displayed when you are running the scripts:
- Object exists and Attempt to insert duplicate row, if the scripts were run previously (for example, for integration with an earlier version of IBM Performance Management or with Tivoli Monitoring).
- ERROR=Object not found on line 4 of statement "-- A workspace table for the ITM event clear automation..." at or near itm_event_clear.
- ERROR=Object not found on line 1 of statement "delete from alerts.itm_problem_events;..." at or near itm_problem_events.
- ERROR=Object not found on line 1 of statement "drop table alerts.itm_problem_events;..." at or near itm_problem_events.
These error messages are harmless.
Repeat step 4 so that the file is loaded into the Object Server twice to ensure that all dependencies are loaded correctly.
Start (or restart) the Probe for Tivoli EIF.
Configure the Performance Management server to forward events to Netcool/OMNIbus:
1. Log in to the Performance Management console.
2. Select System Configuration > Advanced Configuration.
3. In the Event Manager category, set the EIF Event Target(s) field to include the host name or IP address of the host where Netcool/OMNIbus is installed.
4. If necessary, change the EIF Port setting to match your environment.
5. Click Save.

Results

Your Netcool/OMNIbus integration is now complete.

If your Probe for Tivoli EIF and Netcool/OMNIbus ObjectServer are already integrated with IBM Tivoli Monitoring, IBM SmartCloud Monitoring - Application Insight, IBM SmartCloud Application Performance Management, or Performance Management, this configuration enables new fields.