Overview

Skill Level: Intermediate

Netcool omnibus,node-red

This solution provides a jazzy real-time dashboard to the user community for understanding alert trending pattern in detail. Health widgets in this monitoring dashboard will provide an overall health status and insight of alert categories.

Ingredients

  • Existing working Netcool environment on premise Introduction to Tivoli Netcool/OMNIbus
  • Below Alert normalization is used at this solution, If your environment didn't have this then replace the Netcool Fields at dashboardFlow.json file with respective field matching at your environment

normalization

  • ¬†Network connectivity between the machine you run node-red and netcool object server component

 

Step-by-step

  1. Enable Http Interface at Object server

    Object server is a central component to  Netcool product suite which stores alert data to it, datas at object server can be accessed via command line as well as via http interface.

    At our solution data needs to be accessed via http interface. To enable the interfaces, set the NRestOS.Enable property to TRUE at object server props file which is located under $OMNIHOME/etc

    – To configure the embedded HTTP server so that the interfaces are active on an HTTP port, specify the listening port for the connection type. For example, to make the interfaces listen on port 8080, set the properties as follows:

    NHttpd.EnableHTTP : TRUE
    NHttpd.ListeningPort : 8080

    – If you want the interfaces to be active on an HTTPS port on 9090, set the properties that are shown in the following example. HTTPS port is SSL encrypted and a certificate file that contains an appropriate certificate needs to be created and protected with a password.

    NHttpd.SSLEnable : TRUE
    NHttpd.SSLListeningPort : 9090
    NHttpd.SSLCertificate : ‚Äúcertificatelabel‚ÄĚ
    NHttpd.SSLCertificatePwd : ‚Äúpassword‚ÄĚ

     

  2. Install Node.js,node-red and node-red on Linux machine

    Setup a node-red environment at your desktop or at common machine were users can access.

    Below are the commands to install required node-red platform to host this dashboard solution

       curl --silent --location https://rpm.nodesource.com/setup_9.x | sudo bash -
       yum install -y nodejs
       yum install gcc-c++ make
       /bin/npm install -g --unsafe-perm node-red
       npm i node-red-dashboard --save
       npm install -g node-red-admin
  3. Securing Node-red dashboard

    To enable simple user authentication on the Editor and Admin API please add the following lines to your settings.js file under node-red folder.

    adminAuth: {
    type: "credentials",
    users: [{
    username: "admin",
    password: "$2a$08$zZWtXTja0fB1pzD4sHCMyOCMYz2Z6dNbM6tl8sJogENOMcxWV9DN.",
    permissions: "*"
    }]},
    httpNodeAuth: {user:"user",pass:"$2a$08$zZWtXTja0fB1pzD4sHCMyOCMYz2Z6dNbM6tl8sJogENOMcxWV9DN."},

    Password mentioned above are encrypted to genertate a password hash use node-red-admin tool this will prompt you for the password you wish to use and then print out the hash that can be copied into the settings file.

    node-red-admin hash-p
  4. Import the dashboardFlow.json

    • Login to the flow editor using url https://localhost:1880/red
    • Import the dashboardFlow.json using option available at top right corner. source is available via this link Flow
    • Once imported flow will look like below content.

    flow

    • Edit the [NetcoolObjectServer Query] Node to feed in Netcool omnibus Http access url and credentials. (Please do verify from browser, before feed data to this while accessing it must return a object server alert data on browser)
      example:

      access

  5. Accessing dashboard

    • You can access the dashboard via url http://localhost:1880/ui/#/0

      dashboard looks like below embedded picture, you can  extend the widgets as per custom needs.
      This dashboard can be used for your Critical care application monitoring  and to give you a single console summary for alert volum at command centers.

      dashboard

  6. Cloud deployment

    This dashboard can also be deployed under IBM Bluemix cloud Node-RED Starter Boilerplate service by simply following step 4 mentioned above.

    Advantages over cloud deployment is dashboard can be accessed over internet and via mobile platforms. To try cloud deployment please follow this link to create needed services at bluemix Node-red-starter.

Join The Discussion