Installing the Tivoli Netcool/OMNIbus Insight Pack

Edit online

This topic explains how to install the Netcool®/OMNIbus Insight® Pack into the Operations Analytics - Log Analysis product. Operations Analytics - Log Analysis can be running while you install the Insight Pack. This Insight Pack ingests event data into Operations Analytics - Log Analysis and installs custom apps.

Before you begin

  • Install the Operations Analytics - Log Analysis product. The Insight Pack cannot be installed without the Operations Analytics - Log Analysis product.
  • Download the relevant Insight Pack installation package from IBM® Passport Advantage®, ensuring that the downloaded version is compatible with the installed versions of Netcool Operations Insight and Operations Analytics - Log Analysis.
  • Install Python 2.6 or later with the simplejson library, which is required by the Custom Apps that are included in Insight Packs.

Procedure

  1. Create a new OMNIbus directory under $UNITY_HOME/unity_content.
  2. Copy the Netcool/OMNIbus Insight Pack installation package to $UNITY_HOME/unity_content/OMNIbus.
  3. Unpack and install the Insight Pack, using the following command as an example: 
    $UNITY_HOME/utilities/pkg_mgmt.sh -install $UNITY_HOME/unity_content/OMNIbus/OMNIbusInsightPack_v1.3.0.2.zip
  4. On the Operations Analytics - Log Analysis UI, use the Data Source Wizard to create a data source into which the event data is ingested.
    The omnibus1100 data source can ingest data for both the Tivoli® Netcool/OMNIbus Insight Pack and the Network Manager Insight Pack.
    1. In the Select Location panel, select Custom and type the Netcool/OMNIbus server hostname.
      Enter the same hostname that was used for the JsonMsgHostname transport property of the Gateway for Message Bus.
    2. In the Select Data panel, enter the following field values:
      Field Value
      File path NCOMS. This is the default value of the jsonMsgPath transport property of the Gateway for Message Bus. If you changed this value from the default, change the value of the File path field accordingly.
      Type This is the name of the data source type on which this data source is based.
      • To use the default data source type, specify OMNIbus1100.
      • To use a customized data source type, specify the name of the customized data source type; for example: customOMNIbus
      Collection OMNIbus1100-Collection
    3. In the Set Attributes panel, enter the following field values:
      Field Value
      Name omnibus. Ensure that the value that you type is the same as the value of the scala.datasource property in the WebGUI server.init file. If the Name field has a value other than omnibus, use the same value for the scala.datasource property.
      Group Leave this field blank.
      Description Type a description of your choice.

Results

The Insight Pack is installed to the directory specified in step 3. After the installation is completed, the Rule Set, Source Type, and Collection required for working with Netcool/OMNIbus events is in place. You can view these resources in the Administrative Settings page of the Operations Analytics - Log Analysis UI.

What to do next

  • Use the pkg_mgmt command to verify the installations of the Insight Pack. See Verifying the Tivoli Netcool/OMNIbus Insight Pack.
  • If you have several ObjectServers, use separate instances of the Gateway for Message Bus to connect to each ObjectServer. The best practice is for each gateway to send events to a single data source. For more information about configuring the gateway to send events to Operations Analytics - Log Analysis, see the Gateway for Message Bus documentation at https://ibm.biz/BdEQaDexternal link and search for Integrating with Operations Analytics - Log Analysis.