Installing Netcool/OMNIbus Knowledge Library

This section provides instructions for installing and uninstalling IBM Tivoli Netcool/OMNIbus Knowledge Library.

Prior to installation of IBM Tivoli Netcool/OMNIbus Knowledge Library 4.8, you must install the following IBM Tivoli Netcool products:

  • IBM Tivoli Netcool/OMNIbus ObjectServer
  • IBM Tivoli Netcool/OMNIbus probes for SNMP, NetView, Network Node Manager (NNM) or Syslog

These probes may be installed on the same or a different machine as the ObjectServer installation.

Installation steps

The installation procedure involves a number of steps to be carried out in the following sequence:

  1. Downloading the installation from IBM.
  2. Configuring the IBM Tivoli Netcool/OMNIbus ObjectServer.
  3. Setting up probes to use the updated rules files

The sections below document these steps in detail.

Downloading the installation from IBM

IBM Tivoli Netcool/OMNIbus Knowledge Library 4.8 is distributed as a compressed tar file that can be downloaded from IBM using the following steps:
  1. Go to the IBM Passport Advantage website:

  2. Use the Find by part number field to search for NcKL by its part number. For the standard version of NcKL search for CNNZ7EN. For the IM version of NcKL search for CNNZ8EN.
    Note: For Netcool/OMNIbus Knowledge Library 4.8 there is no version of NcKL lite.
  3. Download the compressed tar file.
  4. Extract the contents of this file to a temporary location of your choice.
Note: If you are running Netcool/OMNIbus version 8.1, you can install the Netcool/OMNIbus Knowledge Library package using Installation Manager. To install with Installation Manager, the NcKL installation package is shipped in a ZIP file. For example:

The above steps extract various files related to Netcool/OMNIbus Knowledge Library 4.8, and also create individual subdirectories specific to each supported vendors. Each vendor specific directory contains the vendor specific rules files and lookup files. The RulesFile property in the snmptrap.rules file enables the probes to use the vendor specific files. For more information, see Enabling the probes to use Netcool/OMNIbus Knowledge Library 4.8.

A readme file containing the change history is also created in the parent directory.

If working within a Windows environment, you will require a Windows utility that supports *.tar.gz file extractions. NcKL is also archived using POSIX tar format, so you will require a utility that supports POSIX tar format extractions.

The extracted files include:

  • advcorr.sql - This file configures the ObjectServer for the (advanced) intra-device correlations.
  • rules.tar.gz - Extract this file to have updated vendor specific rules files enhanced to support root cause analysis.
  • removeadvcorr.sql - This file removes some Netcool/OMNIbus Knowledge Library 4.8 components from the ObjectServer, but retains other components for continued use if preferred. For further details, see Uninstalling Netcool/OMNIbus Knowledge Library.
  • license/RELEASEID - Contains the release ID of Netcool/OMNIbus Knowledge Library that you have downloaded.
  • README - This file contains the change history.

Configuring the IBM Tivoli Netcool/OMNIbus ObjectServer

This is a two-stage process that involves the following tasks:

  1. Configuring the ObjectServer to support intra-device correlations
  2. Manually adding conversions to the ObjectServer