IBM Support

Best practice Nokia NSP message bus probe configuration

Question & Answer


Question

Is there any general guidance for configuring the Nokia NSP integration for the message bus probe?

Answer

The following detail is provided to highlight how to create a new Nokia NSP message probe integration.
The product documentation is used to configure the probes configuration files.
The additional guidance is provided to help in the probes configuration.
It is best practice to copy the default configuration files to an instance-specific directory due to the number of files used to configure the probe.
When updating the message bus probe check for updates to the probe configuration files. The nokiaNspRestMultiChannelHttpTransport.json file is a good example, as it has changed the most over time.
Review the Nokia NSP message bus probe document control page in the manual to see what files and settings were updated. Review the main message bus probe manual document control page as well.
Example $NCHOME and probe configuration path:
/opt/IBM/tivoli/netcool/ominbus/probes/NokiaNSP
To create the probe instance-specific directory.
mkdir probes/NokiaNSP
cd probes/NokiaNSP
cp $NCHOME/omnibus/java/conf/nokiaNspKafkaConnectionProperties.json .
cp $NCHOME/omnibus/java/conf/nokiaNspRestMultiChannelHttpTransport.json .
cp $NCHOME/omnibus/java/conf/nokiaNspKafkaTransport.properties .
cp $NCHOME/omnibus/java/conf/nokiaNspKafkaClient.properties .
cp $NCHOME/omnibus/probes/linux2x86/message_bus_nokia_nfmp.props .
cp $NCHOME/omnibus/probes/linux2x86/message_bus_nokia_nfmp.rules .
cp $NCHOME/omnibus/probes/linux2x86/message_bus_nokia_nfmp_parser.json .
Fiies in $NCHOME/ominbus/probes/NokiaNSP:
message_bus_nokia_nfmp.props
message_bus_nokia_nfmp.rules
message_bus_nokia_nfmp_parser.json
nokiaNspKafkaClient.properties
nokiaNspKafkaConnectionProperties.json
nokiaNspKafkaTransport.properties
nokiaNspRestMultiChannelHttpTransport.json
File : nokiaNspRestMultiChannelHttpTransport.json
There are usually two server ports, one for authentication [port:443] and the other for subscription and synchronisation [port:8544].
"GET_ACCESS_TOKEN":
            "uri":"https://[host]:443/rest-gateway/rest/api/v1/auth/token",
"GET_REFRESH_ACCESS_TOKEN":
            "uri":"https://[host]:443/rest-gateway/rest/api/v1/auth/token",
"GET_SUBSCRIPTION":
            "uri":"https://[host]:8544/nbi-notification/api/v1/notifications/subscriptions",
"GET_SUBSCRIPTION_REFRESH":
            "uri":"https://[host]:8544/nbi-notification/api/v1/notifications/subscriptions/++subscriptionId++/renewals",
"RESYNC_FAULT_MANAGEMENT_ALARMS":
            "uri":"https://[host]:8544/FaultManagement/rest/api/v2/alarms/details",
"DELETE_SUBSCRIPTION_ID":
            "uri":"https://[host]:8544/nbi-notification/api/v1/notifications/subscriptions/++subscriptionId++",
"REVOKE_ACCESS_TOKEN":
            "uri":"https://[host]:443/rest-gateway/rest/api/v1/auth/revocation",

File : nokiaNspKafkaConnectionProperties.json
{
    "zookeeper_client" :
        {
            "target" : "",
            "properties" : "",
            "java_sys_props" : "",
            "topic_watch": true,
            "broker_watch": true
        },
    "brokers" : "[host]:9092",
    "topics": "",
    "kafka_client" :
        {
            "properties" : "/opt/IBM/tivoli/netcool/ominbus/probes/NokiaNSP/nokiaNspKafkaClient.properties",
            "java_sys_props" : ""
        }
}

In the probe property file.
# To define a unique instance set the name & rules file
Name : 'NokiaNSP'
RulesFile  : '$NCHOME/omnibus/probes/NokiaNSP/message_bus_nokia_nfmp.rules'
# Best practice general settings
NetworkTimeout                   : 15
PollServer                       : 60
# Buffering
Buffering                        : 1
BufferSize                       : 200
FlushBufferInterval              : 9
# Performance tuning
MaxEventQueueSize                : 50000
TransportQueueSize               : 50000
# Object Server heartbeating
ProbeWatchHeartbeatInterval      : 60

[{"Type":"MASTER","Line of Business":{"code":"LOB77","label":"Automation Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSSHTQ","label":"Tivoli Netcool\/OMNIbus"},"ARM Category":[{"code":"a8m500000008a8TAAQ","label":"Probes-\u003E1 Individual Probes-\u003EMessage Bus JSON XML nco_p_message_bus"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]

Document Information

Modified date:
09 May 2025

UID

ibm17013481

Page Feedback