Configuring integration with Tivoli Netcool/OMNIbus

Ensure that you have Netcool/OMNIbus Knowledge Library (NcKL) Enhanced Probe Rules for Netcool Configuration Manager installed on your Tivoli Netcool/OMNIbus server.

Before you begin

Deploy rules specific to Netcool Configuration Manager. These rules have been bundled with Netcool Configuration Manager and deployed on the Netcool Configuration Manager Presentation server during installation, and are located in the <NCM-INSTALL-DIR>/nckl-rules directory.

Note: This procedure is no longer required for device synchronization with Network Manager, and the mapping of devices between Netcool Configuration Manager and Network Manager.
The standard Netcool/OMNIbus Knowledge Library configuration must have been applied to the ObjectServer and to the SNMP Probe as part of the prerequisite tasks for the integration. The $NC_RULES_HOME environment variable must also have been set on the computer where the probe is installed. This environment variable is set to $NCHOME/etc/rules on UNIX or Linux.
Tip: To source the Network Manager environment script, run the following script:
./opt/IBM/tivoli/netcool/env.sh where opt/IBM/tivoli/netcool is the default Network Manager directory.
Note: If you have existing SNMP Probe custom rules that you want to preserve, create backups as required before deploying the Netcool/OMNIbus Knowledge Library rules in step two.

About this task

The location denoted by $NC_RULES_HOME holds a set of Netcool/OMNIbus Knowledge Library lookup files and rules files within a number of sub-directories. In particular, the $NC_RULES_HOME/include-snmptrap/ibm subdirectory contains files that can be applied to the SNMP Probe. To support the integration, you must add customized rules for Netcool Configuration Manager to this subdirectory.
Remember: If you have installed Netcool/OMNIbus Knowledge Library (NcKL) Enhanced Probe Rules Version 4.4 Multiplatform English (NcKL4.4) on your Tivoli Netcool/OMNIbus server, which is the recommended option, you do not need to install the ITNCM-specific Rules files, as documented here.

Procedure

Installing rules files specific to Netcool Configuration Manager (not the recommended option)

  1. From the server where you have installed Netcool Configuration Manager, copy the following files:
    • ncm_install_dir/nckl_rules/nckl_rules.zip

    where ncm_install_dir represents the installation location of Netcool Configuration Manager, for example /opt/IBM/tivoli/netcool/ncm

    Copy these files to a temporary location on the computer where the SNMP Probe is installed.

  2. Extract the contents of the nckl_rules.zip file, and then copy the extracted files to the $NC_RULES_HOME/include-snmptrap/ibm subdirectory.
  3. If object server failover has already been configured, proceed to step 4. Otherwise, perform the following steps:
    1. Go to the folder in which the mttrapd.props has been placed, for example $NCHOME/omnibus/probes/AIX5, where AIX5 is specific to your operating system.
    2. Edit the mttrapd.props file by commenting out the backup object server reference:
      #ServerBackup : ''
  4. To ensure that the probe can reference the enhanced lookup and rules files, edit the $NC_RULES_HOME/snmptrap.rules file by uncommenting the following include statements, as shown: 
    include "$NC_RULES_HOME/include-snmptrap/ibm/ibm.master.include.lookup
include "$NC_RULES_HOME/include-snmptrap/ibm/ibm.master.include.rules"
include "$NC_RULES_HOME/include-snmptrap/ibm/ibm-preclass.include.snmptrap.rules"
  5. Run the probe. If the probe was already running, force the probe to re-read the rules file so that the changes can take effect, for example:
    Locate the PID of the probe by running the following command on the server running the probe. Look for a process named - nco_p_mttrapd
    ps -eaf | grep mttrapd
kill -9 PID
    Note: If the probe is installed on a different computer from Network Manager or the DASH portal, you must restart the probe manually.