Customizing the Apps

Edit online

The following procedure describes how to generate customized versions of the Custom Apps provided with the Insight® Pack.

Before you begin

Consult the Operations Analytics - Log Analysis documentation for information about creating Custom Apps and building Insight Packs with the Eclipse-based Insight Pack Tooling.

Testing Insight Packs requires a Gateway for Message Bus to transfer events from Netcool®/OMNIbus to Operations Analytics - Log Analysis.

About this task

The procedure is divided into two main parts:
  1. Create a new Custom App, based on the Custom App provided with the Insight Pack.
  2. Use the Operations Analytics - Log Analysis Eclipse-based Insight Pack Tooling to build a new Insight Pack that contains the new Custom App.

Procedure

Create a new Custom App

  1. Copy all the files in the $UNITY_HOME/AppFramework/Apps/OMNIbusInsightPack_version_number directory to a new directory under $UNITY_HOME/AppFramework/Apps/.

    For example, copy them to $UNITY_HOME/AppFramework/Apps/ITEvents.

  2. In the $UNITY_HOME/AppFramework/Apps/ITEvents directory, rename all the App files from OMNIbus_*.app to NewName_*.app.

    For example, rename OMNIbus_Event_Distribution.app to ITEvents_Distribution.app.

  3. Modify ITEvents_Distribution.app as required.

    For example customizations, see Example customization: OMNIbus Static Dashboard.

  4. Test the new Custom App.

Build a new Insight Pack with the Eclipse Tooling

  1. Import the Netcool/OMNIbus Insight Pack, $UNITY_HOME/unity_content/OMNIbusInsightPack_version_number.zip, into the Insight Pack Tooling.
  2. Use the Refactor > Rename command to create a new name for the Insight Pack, for example, ITEvents.
  3. Import your Custom App files from the $UNITY_HOME/AppFramework/Apps/ITEvents directory to the src-files/unity_apps/apps Tooling directory.
  4. When the files are successfully imported, remove the $UNITY_HOME/AppFramework/Apps/ITEvents directory.
  5. Build the Insight Pack.

    The new Insight Pack is named ITEventsInsightPack_V1.1.0.1.zip and is located in the dist Tooling directory.

  6. Use the following command to install the new Insight Pack:

    pkg_mgtm.sh -install directory_path/ITEventsInsightPack_V1.1.0.1.zip

    Where directory_path is the directory path to the dist Tooling directory.

What to do next

Test the new Insight Pack and Custom App.