HP NNM/RAMS Integration Module 5.50

Release Notes

November 2007

This document provides important information about the Network Node Manager and Route Analytics Management System Integration Module (NNM/RAMS Integration Module), version 5.50

Installation Notes
Enhancements and Fixes
Known Problems, Limitations, and Workarounds
Documentation Errata
Verified Environments
Support
Legal Notices

Installation Notes

Instructions for installing the NNM/RAMS Integration Module are documented in the NNM/RAMS Integration Module Installation Guide.

Note:  The NNM/RAMS Integration Module installation guide and users guide in RAMS 5.5 are no longer included in the product installation package.   All NNM/RAMS Integration Module and Route Analytics Management System/Traffic Analysis Add-on product manuals and release notes are now delivered in the Route Analytics Management System 5.5 Documentation CD as part of the product's CD media kit.  The documents are available in two languages, English and Japanese.

Updated versions of the manuals and release notes are posted on the HP Product Manuals web site at http://ovweb.external.hp.com/lpe/doc_serv/. Visit this site to obtain the latest versions.

Software and Hardware Requirements

Before you install the NNM/RAMS Integration Module, make sure that your system meets the following minimum requirements:

• Hardware
  • There are no special hardware or disk space requirements above those of NNM Advanced Edition (AE).
• Operating System Platform and Compatibility
  • HP-UX 11.0, 11.11, 11.23 PA-RISC, 11.23 IPF or 11iv3.
  • Solaris 2.8, 2.9 or 10
  • Windows XP, Windows 2003 + SP1

        Windows 2003 + SP2 for English locale only.  *Note: NNM 7.51 AE support on this platform requires IP 16 or later patch

• Software
  • HP Network Node Manager version 7.51 Advanced Edition with IP15 or later patch (see above exception *)
  • RAMS appliance software version 5.5.17-R.

Upgrading From Earlier RAMS Integration Module Releases

• Custom changes to RAMS-related (OV_RAMS, OV_RAMSD, rex, and tex) events in $OV_CONF/$lang/trapd.conf file are not maintained when you upgrade to RAMS 5.50. All customer changes are overwritten. Copies of the original trapd.conf files are saved at $OV_TMP/trapd.conf.$lang.

  You can merge changes from the original files in $OV_TMP by copy and paste. Modify varbind position changes as necessary. The description field describes the varbinds and their new positions.

• The file, $OV_MAIN_PATH/tomcat/jakarta-tomcat-4.0.4/webapps/topology/WEB-INF/web.xml, is copied into a file named web.xml.previous in the same directory. You can merge custom changes in the web.xml.previous file to the web.xml file when the setupRAMS.ovpl script finishes.

Enhancements and Fixes

• A new SNMP IGP trap "RAMS Router Isolated" now detects when a router becomes isolated because all its known adjacencies went down.  The event OID is .1.3.6.1.4.1.8083.1.1.9.34.

• The following defects are fixed:
  • The calendar failing to display in the drop down button to adjust the time and date in RAMS IGP and RAMS Path History Views is fixed. 
  • When more than one IGP view is opened, each displaying a different IGP protocol from a single GUI session, the views may display a mix of protocol information.  This is fixed in NNM AE IP 16 or later patch.
  • Path History Views for IP/OSI IS-IS topologies in NNM-RAMS Integration Module 5.20 may fail to with "No Path Available" because the Router IDs are represented with NSAP addresses.  You have to manually enter the Router IP addresses or host names in the Path History source and destination boxes.  In this release, when Router IDs can be represented as IP addresses, the view will launch correctly.

Recommended DNS Time Out for IGP View

On the Windows platform, long DNS lookup time on IP addresses that do not resolve can cause slow load time for IGP views. You may tweak the default Windows NetBios settings to reduce the lookup time:

• From Windows, at the "Start -> Run ..." menu, enter the regedit command to launch regedit.
• Look for this key: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\NetBT\Parameters

  You should see these parameters:

  • "NameSrvqueryTimeout" (default = 1500 ms)
    Change this to 20 (ms)
  • "NameSrvQueryCount" (default = 3 attempt)
    Change this to 1 (attempt)

Known Problems, Limitations, and Workarounds

• A link between two routers on an IGP view may be incorrectly shown as two links.
• At the end of a Windows installation, you may see an error message in the Install GUI - "ERROR: Uninstaller executable (<$OV>\Uninstall\HPOvRAMS\setup.exe) is not successfully placed".   This error pertains strictly to the Uninstall file.  In order to perform an Uninstall at a later time, instead of running $OV\Uninstall\setup.exe, execute the same setup.bat which was used to install the NNM-RAMS integration previously.

      Note: this does not affect your installation.

• OSPF and IS-IS GRE Tunnel Down events are not correlated with APA events. (QXCR1000339753)

  Workaround: Look at the 'detected' string description in the Tunnel Down event for "tunnel router down" or "interface disabled" which indicates a layer 2 cause of the tunnel state.

• It may require multiple attempts to enable the RAMS Adjacency Established event from the RAMS Web Admin GUI IGP Alerts page before the NNM management station starts receiving RAMS Adjacency Established alarms. If none of the OV_RAMSD misconfiguration events are cancelled when faults are restored, and you do not see any Adjacency Established events in the NNM alarm browser, verify the results by running $OV_BIN/ovdumpevents -l {time}. Search the results for the text, "Established." If you do not find any Adjacency Established alarms, you must (re)enable the event from the Alerts page.
• RAMS Adjacency Established events may not always cancel RAMS Adjacency Lost events for an adjacency between neighbors.
• After you install the NNM/RAMS Integration Module, the installation directory under /tmp still exists.

  Workaround: Clean the /tmp directory after you install the NNM/RAMS Integration Module.

• If you uninstall the NNM/RAMS Integration Module on IPF platforms by executing /opt/OV/Uninstall/HPOvRAMS/setup.bin, you must first set up the following path variables for finding the 1.4 JRE.
  • export PATH=/opt/OV/jre/jre1.4/bin/IA64N/:$PATH
  • if SHLIB_PATH is set,
    • export SHLIB_PATH=$SHLIB_PATH:/opt/OV/jre/jre1.4/lib/IA64N/server

      otherwise

    • export SHLIB_PATH=/opt/OV/jre/jre1.4/lib/IA64N/server

  Documentation Errata

  Both the Document Release Date and the Software Release Date on all product manuals should be corrected to November 2007. 

  Verified Environments

  The NNM/RAMS Integration Module is supported in a high availability environment. To set up the high availability environment, install and configure the NNM/RAMS Integration Module on both the active and standby server systems. Contact HP technical support for specific configuration needs.

  Support

  Visit the HP Software web site at:
  www.hp.com/go/software

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

  You can also go directly to the support web site at:
  www.hp.com/go/hpsoftwaresupport 

  HP Software Support Online 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 valuable support customer, you can benefit by being able to:

  • Search for knowledge documents of interest
  • Submit and track progress on support cases
  • Manage a support contract
  • Look up HP support contacts
  • Review information about available services
  • Enter discussions with other software customers
  • Research and register for software training

  NOTE: Most of the support areas require that you register as an HP Passport user and log in. Many also require an active support contract. To find more information about support access levels, go to the following URL:
  http://support.openview.hp.com/access_level.jsp

  To register for an HP Passport ID, go to the following URL:
  https://passport2.hp.com/hpp/newuser.do

  To view release notes and other documentation, complete the following steps:

  1. Click Where do I find-->Product manuals.

         The product manuals search window opens. It is located at:
         http://ovweb.external.hp.com/lpe/doc_serv/

  2. In the select product list, click Route Analytics Management System.
  3. In the select version list, click 5.50.
  4. In the select language click on desired language. The default is English.
  5. To start the search, click Open or Download.

  NOTE: To view files in PDF format (*.pdf), Adobe Acrobat Reader must be installed on your system. To download Adobe Acrobat Reader, go to the following URL:
  http://www.adobe.com/

  Legal Notices

  ©Copyright 2007 Hewlett-Packard Development Company, L.P.

  The information contained herein is subject to change without notice.

  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.