HP Network Node Manager iSPI Performance for Metrics Software Release Notes

for the Windows® and Linux operating systems

Software version: 9.2x Patch 2

Publication date: December 2012

This document applies to HP Network Node Manager iSPI Performance for Metrics (iSPI Performance for Metrics) version 9.2x Patch 2. It contains the following information that is not provided in the product manuals or online help.

Product Overview

What's New in This Release

Installation Notes

Known Problems, Limitations, and Workarounds

Documentation Updates
Support

Legal Notices

Product Overview

NPS stores, aggregates, and provides reports for collected performance data. It is the foundation for operational reports on NNMi. Other iSPIs rely on NPS for report presentation functionality. The iSPI Performance for Metrics adds performance management capability to NNMi by analyzing, processing, and aggregating a range of standard metrics collected by NNMi from different network elements.

This release of the iSPI Performance for Metrics includes the following features:

•     Interface Health Reports

•     Component Health Reports

•     ATM PVC Health Reports

•     Frame Relay PVC Health Reports

•     Path Health Reports

•     Custom Polled Reports

•     Self Diagnostics Health Reports

What's New in This Release

9.2x Patch 2

The NNM iSPI Performance for Metrics 9.2x Patch 2 provides fixes for a set of defects that existed with the NNM iSPI Performance for Metrics 9.20 and 9.20 Patch 1. For a complete list of fixes, see the Summary section on the patch download web site.

9.20 Patch 1

New reports:

•     Top N Frequency Distribution: This report shows the distribution of metric values for each collected sample during the selected time range.

•     Top N Table: Like the Top N report, this report shows Top N network elements, but does not include bar charts or time series graphs. If you want to view Top N elements in the least possible time, choose the Top N Table report instead of the Top N report.

For more information about the new reports, see the Online Help for the NNM iSPI Performance for Metrics.

9.20

The primary aim of this release is to improve usability across the product. There are many small enhancements that are not listed here individually. However, the major areas of enhancement are as follows:

Usability

•     Addition of the Performance Workbench within NNMi, a real time, operational, graphing tool embedded within the main NNMi console.

•     Major changes to the NPS navigation panel and report tree structures allowing easier use of advanced reporting features such as scheduling and user-created report shortcuts.

•     Improvements to the support of Slowly Changing Dimensions (SCD) Type 1 and Type 2 grouping constructs.

•     Changes to how drillthrough from one report to another occurs. Destination reports now always open in a new browser window, allowing the user to compare the initial report with the newly launched one.

•     Custom attributes created within NNM are now supported for reporting.

•     Support for incremental backup routines.

•     Addition of relative time attributes within the data models, allowing easy creation of relative time reports using Query Studio. Users can now create rolling time period reports such as “Volume for the last 24 hours.”

•     Improvements to the support tools (backup and restore), allowing users to migrate their NPS environments from Windows 2003 to Windows 2008 (see the Installation Guide for full details).

Product Features and Architecture

•     Improved data archival and report performance through the addition of a daily aggregate storage area. This is hidden from the report user but can be controlled with the configuration UI.

•     The underlying reporting application, from Cognos, has been upgraded to version 10.1.1.

•     The underlying database, Sybase IQ, has been upgraded to version 15.4.

•     The underlying content store technology has been changed from Apache Derby to Sybase ASE.

•     An improved installation routine making it easier to recover from minor configuration issues discovered during installation.

The NNM iSPI Performance for Metrics 9.20 also includes multiple defect fixes seen in previous releases.

Installation Notes

•     Make sure that NNMi 9.22 is installed on the NNMi management server before you install this patch.

•     Installation requirements, as well as instructions for installing the NNM iSPI Performance for Metrics 9.2x Patch 2, are documented in the patch text file, which is available on patch download page.

•     If you want to install the patch manually, make sure that you install the updated HPOvGC component on the NPS system before installing the patch. The updated HPOvGC component is available within the patch zip or tar file.

•   After installing the NNM iSPI Performance for Metrics 9.2x Patch 2, you must perform the following tasks:

   1. Run the nnmenableperfspi.ovpl script on the NNMi management server.

   2. Run the following command on the NPS system:
     
dbCheckIndexes.ovpl
      The command checks the health of all table columns in the NPS database for each extension pack; the command output in the command line console shows the status report.
   
      Based on the command output, run the
dbCheckIndexes.ovpl
command again (with appropriate options) on specific extension packs or tables that are reported to be non-compliant.
      For more information about  the
dbCheckIndexes.ovpl command, see the man page or reference page for dbCheckIndexes.ovpl.
      
     The
dbCheckIndexes.ovpl command might show the following error message in the command line console:
     
WARN: DBD::SQLAnywhere::db do failed: Invalid expression
      Ignore this error.

•     After patch installation, launch the NPS console again in a new browser instance, and then start using reports.

Uninstallation Notes

Upgrading the NNM iSPI Performance for Metrics 9.2x Patch 2 from the version 9.20 upgrades the HPOvGC component to the version 09.20.016. However, when you uninstall the NNM iSPI Performance for Metrics 9.2x Patch 2, the older version (09.20.015) of the HPOvGC component is not reinstated; the HPOvGC component version 09.20.016 remains on the system even after uninstalling the patch.

Known Problems, Limitations, and Workarounds

This release contains certain unresolved problems and some limitations, which are listed below, with available workarounds where applicable. A searchable database of all known issues is available online at HP Software Support Online.

Performance Workbench

•     In certain deployments, the performance panel in the analysis pane for a selected object in the NNMi console may show a login prompt and a password the first time the user logs in to the NNMi console using Firefox. Workaround: Enter the NNMi username and password.

•    When a user clicks on a connection, the Performance Analysis pane will show graphs for each interface. If the names of the interfaces are long, the displayed name may be truncated, making it difficult to distinguish between interfaces. Similar behavior happens with the metric labels for the graphs. Workaround: Pass the mouse over the truncated label to see the full text.

•     Newly added nodes to NNMi may show inconsistent Performance Workbench graph data immediately following their addition.

•     Selecting the same metric from multiple different collection classes (for example, iSPI Performance for Traffic and iSPI Performance for Metrics) can lead to duplicate graphs being shown and no easy way to distinguish which is which.

•     When examining a layer 2 connection, separate graphs are shown for each interface. However, labels may be missing from the graphs, which can make it difficult to determine which interface each relates to.

•   Only on a Windows system where the HP Operations agent was installed prior to installing the NNM iSPI Performance for Metrics.
 
If you install the NNM iSPI Performance for Metrics on a drive different from the drive where the HP Operations agent was installed, you will see the following error message in the Performance Troubleshooting window or the Performance tab in the analysis pane:
HP Performance Manager License has expired
To resolve this issue, follow these steps:
a) Go to the %npsdatadir% directory.
b) Navigate to the folder one level up.
c) Copy the following files into the %ovdatadir%
conf/perf directory: Network_GC_Integration.xml, ovpm.tcf, OVPMconfig.ini, OVPMReportTemplate.htm, OVPMUsers.xml, and OVPMSystems.xml

NPS Reports and Their Use

•     The time zone specified in the user preferences in the BI Portal is not used for reporting purposes. Instead, the data displayed in reports is adjusted according to the time zone setting within the time panel of the report controls.

•    Reports generated by a schedule will be missing the interactive links at the top to control behavior such as report options, or displaying the bookmark. Only reports run in real time have these features enabled.

•     Help page content regarding the meaning of collected metrics is extensive, but not all metrics are included. For most, the meaning is self-explanatory.

•     The Top 10 Task Duration report, part of the Self Diagnostics package for administrative users may have slightly obscured x-axis labels when examining data over a long interval with a fine display grain.

•     The Report History tab of the navigation panel records which reports have been run by a user. If the Launch Separately preference is set, report launches may get recorded twice in the history.

•     The Self Monitoring reports, and some items within the BI Portal area, are intended for administrative use only. Non-administrative users can see that these items exist but are not able to launch them.

•     The Path Health report, launched by identifying a path within NNM and selecting an action from the menu system, may take longer than other reports to render if there are many items in the path. Users can expect render times in excess of 1 minute for a multi-part path.

•     The Dashboard report may display with a very wide colored chart if the grain chosen by the user is fine compared to the interval. Workaround: Use the Time Control tab of the navigation panel to select a default grain for the chosen interval. The report will display correctly.

•     The Self Monitoring reports allow administrative users to see how long individual reports take to launch. The name of some reports includes a full directory structure. As a result, the name can be long. Long names may appear truncated, making it difficult to determine which report the displayed data relates to.

•     Some reports support the idea of filtering the data based on the value of a selected metric; for example, list the top 10 interfaces by volume where discard rate percentage is greater than 5%. Although the numeric filtering will work as expected, the filter display area at the top of the report that describes the filters and grouping currently in place will not inform the user that a filter is in place. This could lead to a report's being misunderstood if the user is not aware that filters were used.

•     Report views that are saved into the My Folders area of the BI portal will not have a Bookmark URL available. Workaround: Save the report view into a User Group folder instead, where it will be given a bookmark URL.

•     When a report is launched using a bookmarked URL, or as a result of having the Open Separately check box enabled, the Topology Filter area may show some additional parameters that seem unrelated to the choices the user made. These can include, but are not limited to, ‘showNav=1 username=ErsAdmin run.prompt=false’. Workaround: These values can safely be ignored and will vanish the next time a report is launched within the same navigation pane area.

•     After launching a report, choosing Alternate Delivery Option > Save Report appears not to do anything. However, clicking the Save Report option will cause the report to run in the background. The report output will be saved later as a new output version associated with the report or ReportView that was launched.

•     It is important that you synchronize the NNMi management server clock and the NPS server clock. This ensures that the analysis panes that retrieve data from the NPS server yield accurate results. If you experience blank analysis panes, check that your clocks are synchronized between the servers.

Product Maintenance

•   The dbCheckIndexes.ovpl tool shows the following error message in the command line console and in the prspi.log file:
  WARN: DBD::SQLAnywhere::db do failed: Invalid expression
    Ignore this error.

•    The process of starting the BI Server (the reporting application server and web front end) can take longer than in previous releases. Users can expect a startup time of up to 10 minutes.

•     Uninstalling an Extension Pack from NPS does not halt the associated collections within NNMi. This can lead to data being collected and stored by NNMi but not processed. Although NNMi will eventually stop collecting the data, the files can take up a substantial amount of disk space. Workaround: Users who uninstall custom collections or those associated with content iSPIs should disable the associated performance collections within NNMi at the same time.

•     Uninstalling an Extension Pack from NPS will remove the associated reports and aggregation routines, but will not remove Quicklaunch ReportViews or user-created ReportViews on content within the Extension Pack. Workaround: Users should identify their links and ReportViews that reference no longer available reports and remove them using the BI Portal functions.

•     Setting the environment variable JAVA_HOME to point to an unsupported version of Java can cause the BI Server to not operate correctly, but the ‘statusBI.ovpl’ command will display a status of normal.

•    In a High Availability environment, after enabling SSL on the on-line node and then on the passive node, the passive node will say that SSL is already enabled. However, if the passive node is subsequently failed over to (making it active), the NPS report menu and pages will not be available. Workaround: The originally passive node is reporting (incorrectly) that it has SSL enabled. The user should run the configureWebAccess.ovpl command again on that node when it becomes active.

•    On a system running https for security, if a user launches the NPS front end, by visiting port 9300, they will be redirected to the authentication screen of NNMi for login.  However, when they are redirected, the browser will have switched from https to http. Workaround: Users in an environment running https should always log in through NNM.

•     When finishing a session, users are advised to close ALL browsers of the type they were using to access NPS, especially if the machine they are using is shared. Leaving one browser open is enough to maintain the session parameters and allows another user to begin browsing reports again without needing to log in.

Documentation Updates

To check for recent updates or to verify that you are using the most recent edition, visit: HP Software Product Manuals

To retrieve a document:

1.    Select:

-     Product name

-     Version list

-     Operating System

-     Preferred Language

-     Document title

2.    Click Open or Download.

You must have Adobe Reader installed to view files in PDF format. To download Adobe Reader, go to the Adobe website.

HP Software Support

Visit the HP Support web site at: HP Software Support Online.

This website provides contact information and details about the products, services, and support that HP Software offers.

HP Software support provides customer self-solve capabilities. It provides a fast and efficient way to access interactive technical support tools needed to manage your business. As a valued support customer, you can benefit by using the support web site to:

·         Search for knowledge documents of interest

·         Submit and track progress on support cases and enhancement requests

·         Download software patches

·         Manage support contracts

·         Look up HP support contacts

·         Review information about available services

·         Enter into discussions with other software customers

·         Research and register for software training

Most of the support areas require that you register as an HP Passport user and sign in. Many also require an active support contract. To register for an HP Passport ID, go to: HP Passport Registration.

To find more information about access levels, go to: Access levels.

To access the Self-solve knowledge base, go to: Self-solve knowledge search.

Legal Notices

©Copyright 2009-2012 Hewlett-Packard Development Company, L.P.

Warranty

The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.

The information contained herein is subject to change without notice.

Restricted Rights Legend

Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.

For information about third-party license agreements, see the license-agreements directory on the product installation DVD-ROM.

To view open source code, see the license-agreements/source and license-agreements/CygwinSources directories on the product installation media.

Trademark Notices

Adobe® is a trademark of Adobe Systems Incorporated.

Java is a registered trademark of Oracle and/or its affiliates.

Microsoft® and Windows® are U.S. registered trademarks of Microsoft Corporation.

UNIX® is a registered trademark of The Open Group.

Acknowledgements

This product includes:

•     Apache software, version 1.1, copyright© 2000 The Apache Software Foundation. All rights reserved.

•     Apache, version 2.0, January 2004. The Apache Software Foundation.

•     GNU Lesser General Public License, version 2, June 1991, copyright© 1989, 1991 Free Software Foundation, Inc.

•     GNU Lesser General Public License, version 2.1, copyright© 1991, 1999 Free Software Foundation, Inc.

•     GNU lesser General Public License, version 3, copyright© 2007 Free Software Foundation, Inc.

•     IBM Cognos Business Intelligence 10.1.1. Copyright© International Business Machines Corporation 2010. All rights reserved.

•     IPA Font v1.0, IPA

•     libjpeg library, copyright© 1991-1998, Thomas G. Lane.

•     libpng versions 1.2.5 through 1.2.10, copyright 2004, 2006© Glenn Randers-Pehrson.

•     libxml2 library, copyright© 1998-2003 Daniel Veillard. All Rights Reserved.

•     libxp library, copyright© 2001,2003 Keith Packard.

•     The “New” BSD License, copyright© 2005-2008, The Dojo Foundation. All rights reserved.

•     PacketProxy, copyright© 2002-2010, Daniel Stoedle, Yellow Lemon Software. All rights reserved.

•     7-Zip, copyright© 1999-2011 Igor Pavlov.

 


©2009-2012 Hewlett-Packard Development Company, L.P.