About Network Node Manager-i series (NNMi) iSPI for Performance Metrics and the Network Performance Server (NPS)
The Network Node Manager-i series (NNMi) iSPI for Performance Metrics and the Network Performance Server (NPS) can be installed in the same server as NNMi (co-located) environment, dedicated single server (stand-alone, not distributed environment) or on multiple dedicated servers (distributed environment). In all of those scenarios, the NNMi server needs to be informed of the NPS Fully Qualified Domain Name (FQDN) and the port on which the Business Intelligence (BI) Server (also known as the Reporting Engine) is listening to and the protocol in use, to be able to cross launch the performance reports from within the NNMi console. Information required for the integration
If the following information about the NPS server has not been configured in NNMi, the error message occurs, because NNMi is unable to recover the NPS hostname and port from the NNMi DB
- Protocol in use (HTTP or HTTPs)
- Web Server Port on which the BI server is listening
- FQDN of the BI server
This information is configured during the NPS and NNMi integration steps. The script nnmenableperfspi.ovpl
is required to be run to enable the integration, during the script execution all the information required to enable the communication between the NNMi and NPS servers is requested, including the protocol, the web port, and the FQDN.Example
Note: Some output is omitted[root@myNNM ~]# nnmenableperfspi.ovpl--------------------------------------------------------------------------Enable NNM iSPI Performance--------------------------------------------------------------------------This script provides a simple mechanism to enable integration of NNMi with the Network Performance Server. The following tasks need to be completed before performance reporting can begin. <<<<OUTPUT OMMITED HERE>>>> Enter values for the following parameters, an empty response results in the default value [shown in brackets] being used. <<<<OUTPUT OMMITED HERE>>>> Fully qualified hostname for the Network Performance Server server [myNNM.test.hp.com]:myNPS.test.hp.comNetwork Performance Server port number :9300Network Performance Server protocol (http|https) [http]:http
After providing all the required information, the script will run to completion through different stages. Some of the stages are
- Copying PMI files
- Removing any existing metrics actions
- Enabling metrics actions
- Update extended properties
- and more…
This can be observed in the output generated by the script. Cause of the problem
It is possible that the execution of the script nnmenableperfspi.ovpl
failed leaving the system in this unstable state, where the integration information was not inserted into the NNMi configuration. The causes of this failure could be various but should happen only rarely.
The NPS server information is registered into NNMi during the “Update extended properties” stage of the script execution.Example of a successful completion of this stageUpdating extended Properties updated in NNMi Reading file /var/opt/OV/shared/perfSpi/datafiles/nnm_details.xml FQDN file path /var/opt/OV/conf/nnm/props/nms-local.properties Exporting property http://myNPS.test.hp.com:9300Updating NNMi running at myNNM 80 443 Exporting host and port property http://myNPS.test.hp.com:9300 Extended Properties updated in NNMi Example of an unsuccessful attempt of this stageUpdating extended Properties updated in NNMi Reading file /var/opt/OV/shared/perfSpi/datafiles/nnm_details.xml FQDN file path /var/opt/OV/conf/nnm/props/nms-local.properties Exporting property http://myNPS.test.hp.com:9300Updating NNMi running at myNNM.test.hp.com 80 443 Exporting host and port property http://myNPS.test.hp.com:93001 [main] ERROR org.jboss.ws.core.CommonClient - Exception caught while (preparing for) performing the invocation: javax.xml.ws.soap.SOAPFaultException: org.hibernate.exception.SQLGrammarException: could not execute query at org.jboss.ws.core.jaxws.SOAPFaultHelperJAXWS.getSOAPFaultException(SOAPFaultHelperJAXWS.java:88)
Note: In this particular scenario the failure was related to the access to the NNMi DB. Log File
Every time the script is executed, it creates the following log file that can be consulted for information. It includes the standard output generated by the script and the information provided during execution , unfortunately the error messages and exceptions are not recorded in this file.
When this problem happens it is possible that the “PerfSPI” application has not been successfully registered in NNMi, this results in the following output to be “empty” when only the iSPI for Performance Metrics is integrated with NNMi or not to include the “PerfSPI” application when other applications (such as the iSPI for Performance Traffic) are. It is also possible that the output below does contain the PerfSPI application but the root cause of the problem is the same. The output below is not a 100% accurate indication that the information has been successfully stored in the NNMi DB.
Note: The outputs below may be slightly different on your system.
Linux: /opt/OV/support/nnmtwiddle.ovpl invoke com.hp.ov.nms.topo:service=NetworkApplication printConfiguration
Windows: %NnmInstallDir%\support\nnmtwiddle.ovpl invoke com.hp.ov.nms.topo:service=NetworkApplication printConfigurationExample (iSPI for Performance Traffic and Metrics are installed, Linux)
When properly registered[root@myNNM ~]# /opt/OV/support/nnmtwiddle.ovpl invoke com.hp.ov.nms.topo:service=NetworkApplication printConfigurationApplication = PerfSPIApplication = traffic
When not properly registered (notice that PerfSPI is not reported)[root@myNNM ~]# /opt/OV/support/nnmtwiddle.ovpl invoke com.hp.ov.nms.topo:service=NetworkApplication printConfigurationApplication = traffic