Guest

Cisco Performance Visibility Manager

Release Notes for Cisco Performance Visibility Manager, 1.0.2

Table Of Contents

Release Notes for
Cisco Performance Visibility Manager 1.0.2

Contents

Introduction

Cisco PVM 1.0.2 Features

Caveats

Cisco PVM 1.0.2.3 Patch

Key Enhancements

Installing the Cisco PVM 1.0.2.3 Patch

Uninstalling Cisco PVM 1.0.2

Related Documentation

Obtaining Documentation, Obtaining Support, and Security Guidelines


Release Notes for
Cisco Performance Visibility Manager 1.0.2


Last Updated: September 9, 2008,

These release notes provide the latest information available about Cisco Performance Visibility Manager 1.0.2 (Cisco PVM). This update includes instructions for installing the Cisco PVM 1.0.2.3 software patch.

Contents

This document contains the following sections:

Introduction

Cisco PVM 1.0.2 Features

Caveats

Cisco PVM 1.0.2.3 Patch

Related Documentation

Obtaining Documentation, Obtaining Support, and Security Guidelines

Introduction

Cisco PVM is a centralized network management tool that enhance the Network Analysis Module (NAM) for the Cisco Catalyst 6500 Series switches, 7600 Series routers, and the Cisco Branch Routers Series. An enterprise network encapsulating multiple NAMs is easily managed using this centralized network management tool. Cisco PVM is designed to:

Give end users visibility into their networks and applications.

Collect, aggregate, and correlate data from multiple NAMs and network devices.

Provide critical performance information through a graphical user interface (GUI) for troubleshooting, traffic analysis, monitoring, and capacity planning.

View alarms showing deviations from an established baseline of network and application traffic flows.

Collect application response time (ART) data from several NAMs and correlate the data to provide end-to-end response time information for applications.

Monitor the network continuously to identify network performance problems so that they can be resolved before end users are affected.

Provide a consistent and complete assessment of performance with comprehensive, pre-configured reports.

Cisco PVM is a scalable real-time data collection, correlation, and aggregation engine providing a centralized and integrated end-to-end network view. It adds value to Cisco's NAM Traffic Analyzer, as well as other applicable Cisco performance and traffic management product suites.

Cisco PVM 1.0.2 Features

Cisco PVM 1.0.2 provides the following installation improvements:

Enhanced Preinstallation—Before Cisco PVM installation begins, the installer checks whether Cisco PVM is already installed, cleans up any existing installations, and provides the logic for the help and usage switches. It creates the Cisco PVM user and asks for user input regarding the installation locations. It also performs the necessary permission checks.

Enhanced Installation—The preinstallation enhancements should ensure that all installation dependencies are met and installation will succeed. However, should an installation fail, the installer provides the appropriate error messages and terminates the installation.

Enhanced Post Installation—Post installation enhancements include the inclusion of auto-startup scripts, creation of the SSL certificate, creation of the evaluation license file if one is needed, verification of all required elements to verify the installation, the cleanup of any temporary files, the creation of an installation summary and direction to the user on where to find the log files.

Other Enhancements—Other enhancements include strengthened user feedback and messages. Additionally, troubleshooting capabilities are enhanced with the inclusion of additional user feedback and messages, plus the GetPvmInfo.sh troubleshooting tool.

Caveats

Review the notes listed below before deploying the Cisco PVM. Table 1 shows the known open caveats that are scheduled to be addressed in a subsequent release.

Table 1 Open Caveats

Cisco Tracking #
Summary
Description

CSCsl88850

Selecting a report period that starts before data is available generates a 12097 error.

When creating a report, the user selects a starting time that is before any data is available. For example, on a newly installed server and collecting for a couple hours, the user selects "Last Month" as the time range, the report output shows a 12097 error, no pages to display. If the user selects "Today" as the time range, the report output shows graphs. Both time settings should show graphs.

CSCsl88862

A report can be scheduled with no name.

When scheduling a report, the Name field is optional, so the list of scheduled reports can contain entries, but none of them have a name.

CSCsl88866

The first run of a new scheduled report may not be the first time.

When scheduling a recurring report, the first time the report is run is always at least the next day. For example, if a recurring report is scheduled for everyday at 6:00 PM and the current time is 11:00 AM, the first run of the report will be tomorrow at 6:00 PM, rather than today at 6:00 PM.

CSCsl88823

When adding a new switch/router, the SNMP version resets to 1.

After adding a switch or router to the resource list, attached to a NAM, the SNMP version is always 1, even if the user selected 2.

CSCsu00922

Alerts screen filtering

Filtering alerts with no dates results in an error.


Table 2 shows the caveats that are resolved in this release.

Table 2 Resolved Caveats

Cisco Tracking #
Description

CSCsl88790

Logs directory owned by root:root and have 777 permissions.

CSCsl88783

Installer does not clean-up if free space check fails.

CSCsl88774

Installer does not check that portmapd is running.

CSCsl88764

Uninstall does not look outside /var/adm/PVM for the status file.

CSCsl88757

Uninstall script has similar errors as B11 installpvm.

CSCsl88748

-bash: /root/.bashrc: Permission denied error messages.

CSCsl88741

pvmadm user unable to install D.

CSCsl88727

No actionble error messages for db install failure.

CSCsl64237

Awkward wording of OS requirement error message.

CSCsl64221

Uncommon range indicator in error message.

CSCsl03677

Installer not checking port 443; SFS updated to reflect that 443 is not needed.

CSCsl03674

Installer checks only port 8443 block by iptables.

CSCsk99850

Messages need to be formatted so they wrap correctly.

CSCsk99842

Free port and firewall checks have false positives.

CSCsk99833

Installer intermittently fails when detecting other installers.

CSCse06325

Uninstall does not stop all processes.

CSCse26251

Server shutdown does not stop Oracle Listener.


Cisco PVM 1.0.2.3 Patch

The Cisco PVM 1.0.2.3 patch provides several key enhancements and resolves online transaction processing (OLTP) and online analytical processing (OLAP) database purge issues. This patch includes functionality provided in Cisco PVM 1.0.2.2, Cisco PVM 1.0.1.2 and Cisco PVM 1.0.1.1 patches. If you install this patch, you do not need to install any previous Cisco PVM patch. You can install the Cisco PVM 1.0.2.3 patch on any of the following releases:

Cisco PVM 1.0.2.2

Cisco PVM 1.0.2

Cisco PVM 1.0.1.2

Cisco PVM 1.0.1.1

Cisco PVM 1.0.1

This patch brings your Cisco PVM release up to the Cisco PVM 1.0.2.3 level.

Key Enhancements

Table 3 shows the Cisco PVM 1.0.2.3 patch key enhancements.

Table 3 Cisco PVM 1.0.2.3 Patch Key Enhancements

Enhancement
Description

Support the NME-NAM Platform

The Cisco PVM 1.0.2.3 patch supports Cisco Branch Router Series Network Analysis Module (NME-NAM-80S and NME-NAM-120S) data collection and reporting. After installing the patch, you can add NME-NAMs to Cisco PVM 1.0.2, collect data from the NME-NAMs, and generate reports on the collected data.


Note For licensing, Cisco PVM considers NM-NAM and NME-NAM to be the same. Similarly, NAM-1 and NAM-2 are considered the same.



Note This enhancement was included in the Cisco PVM 1.0.2.2 patch.


Support for NAM Release 3.6

The Cisco PVM 1.0.2.3 patch supports Cisco Network Analysis Module Version 3.6 (NAM 3.6) for features present in NAM 3.4 and NAM 3.5. After installing the patch, you can collect the data from NAM 3.6 that you collected from NAM 3.4 and NAM 3.5.


Note The Cisco PVM 1.0.2.3 patch does not support NAM 3.6 features that were not included in NAM 3.4 and NAM 3.5.



Note This enhancement was included in the Cisco PVM 1.0.2.2 patch.


Larger Oracle parameter SQL command line

Increase the Oracle parameter SQL command line size to accommodate the use of longer customized installation directory path names.

OLTP and OLAP fixes

OLTP and OLAP improvements fix the following issues:

Purge process jobs for the OLTP and OLAP databases are not initiated during base installations and do not run as required.

Purge job does not delete data older than retention period.

OLAP purge job is not created when installing on Cisco PVM 1.0.1.

Purge process uses hourly retention period for daily data.

OLAP purge process is purging hourly and daily data within the retention period.


Installing the Cisco PVM 1.0.2.3 Patch

You can install the Cisco PVM 1.0.2.3 patch on any of the following releases:

Cisco PVM 1.0.2.2

Cisco PVM 1.0.2

Cisco PVM 1.0.1.2

Cisco PVM 1.0.1.1

Cisco PVM 1.0.1

The estimated patch installation time after you execute the updatepvm command is less than one hour.


Note If you are installing the patch on a Cisco PVM 1.0.1.x release, refer to the installation procedure provided in the Cisco PVM 1.0.1 Release Notes.



Note Cisco PVM Release 1.0.2.x or Release 1.0.1.x must be installed before you install the Cisco PVM 1.0.2.3 patch.



Note To perform this procedure, you must have a Cisco.com user name and password. If you do not have a Cisco.com user name and password, you can apply for one at: http://tools.cisco.com/RPF/register/register.do.



Caution This patch truncates raw performance data if the purge jobs are missing. (The patch does not delete aggregated data.) If the installer detects missing purge process jobs, it asks whether you want to continue or abort the installation. Entering Y (Yes) continues the installation. The installation will truncate the raw performance data and install the missing purge jobs. Entering N (No) stops the installation without truncating the raw performance data, to allow you to archive the existing data. Enter -T to select deleted data. (For archiving data procedures, refer to the Cisco PVM User Guide.) After archiving the data, you must restart the patch installation.

To install the Cisco PVM 1.0.2.3 patch, complete the following steps:

Step 1 Go to the Cisco.com Network Management Software website:

http://www.cisco.com/public/sw-center/sw-netmgmt.shtml

Step 2 Under Small and Medium Business Network Management, click Network Analysis and Planning.

Step 3 At the Log In screen, enter your registered Cisco.com user name and password; then, click Log In.

Step 4 Expand the Cisco Performance Visibility Manager tree, then click Cisco Performance Visibility Manager 1.0.

Step 5 On the Downloads page, expand the Latest Releases folder, then click 1.0.2.3.

Step 6 Select the 1.0.2.3 release in the left list, then select the filename, PVM-1.0.2.3.tar.gz, on the right (under Sort By).

Step 7 On the Acceptance page, complete the user information fields, then click Accept.

Step 8 At the Download Image screen, click Download.

Step 9 On the Supporting Documents page, read the End User Software License Agreement and Download Rules, then click Agree.

Step 10 On the File Download dialog box, click Save.

Step 11 In the Save As dialog box, save the Cisco PVM1.0.2.3 patch package file to a temporary directory (such as /tmp) on the Cisco PVM server.

Table 4 shows the contents of the package.

Table 4 Cisco PVM 1.0.2.3 Patch Package Contents 

File Name
Description
Sha1Sum
Size1

ciscopvm1-collection_server-
1.0.2.1-1.i386.rpm

Cisco PVM 1.0.2.3 collection server files

2f061bc40a296c8557485ee5fd60c66ce1049dde

6 MB

ciscopvm1-database_objects-
1.0.2.3-1.i386.rpm

Cisco PVM 1.0.2.3
database files

1cacf20f9c04d2c07c7c651101e2bec4d6c29713

6 KB

ciscopvm1-gui-1.0.2.3-3.i386.rpm

Cisco PVM 1.0.2.3 user interface files

665e3c71a6f861472465eb1d51a6db42fc867afd

95 MB

ciscopvm1-mc_shared-
1.0.2.3-2.i386.rpm

Cisco PVM 1.0.2.3 mediation, collection, and configuration files

f899b0c61010c9aa823665a36a16d8d4d218dfe8

1 MB

updatepvm

Cisco PVM 1.0.2.3 Update Script

6531981c897aca4f7bd140abf03b80498592b05d

24 KB

1 Sizes are rounded to whole numbers. Use the Sha1Sums to verify the file identification.


Step 12 Change to the PVM administrative user.

Step 13 Stop Cisco PVM:

/[install directory]/bin/pvm stop

Sample CLI:

$ pvm stop 
. 
. 
. 
Shutting down report server, please wait ...

Caution This step might take up to two hours to complete. If you stop Cisco PVM manually before the stop script is completed, aggregated data that is in progress will be lost.

Step 14 Install the patch:

a. Change to the root user.

b. Navigate to the directory where you placed the Cisco PVM 1.0.2.3 patch download, then untar the patch file:

tar zxf PVM-1.0.2.3.tar.gz

c. Change to the PVM 1.0.2.3 directory:

cd PVM-1.0.2.3

d. Run the ./updatepvm script.

Sample CLI:

# ./updatepvm 
Cisco PVM Performance Visibility Manager 1.0.2.3 
Do you want to update Cisco PVM (Y/N)[N] ? y 
Starting updatepvm @ Wed Jun 2 18:07:21 EDT 2008 
. WARNING: PVM 1.0.2.3 update will delete existing performance data. 
Please enter 'N' to stop this update, if you need to archive the data. 
Please enter 'Y' to continue this update, if you have already archived or 
do not want to archive the existing performance data. 
. Continue PVM 1.0.2.3 update (Y/N)[N] ? y 
. Package installation is completed successfully. 
Update of PVM completed @ Wed Jun 2 18:09:06 EDT 2008. 
PVM installation log is available at... 

Note Display of the following message is normal during the installation: warning: cannot get shared lock on /var/lib/rpm/Packages


Step 15 Start Cisco PVM by changing to the PVM administrative user, stopping the TNS Listener, then starting Cisco PVM:

su - pvmadm
lsnrctl stop
/[installation path]/bin/pvm start

Sample CLI:

$ pvm start
. 
. 
. 
Cisco PVM startup completed! Press Enter to continue...

Note If the Listener password is enabled, the following error.message will be displayed: Connecting to (ADDRESS=(PROTOCOL=IPC)(KEY=cnam)) TNS-01169: The listener has not recognized the password.



Uninstalling Cisco PVM 1.0.2

To uninstall Cisco PVM 1.0.2 after you install the Cisco PVM 1.0.2.3 patch, complete the following steps:


Step 1 Log in as the root user.

Step 2 Enter the uninstallpvm command:

./[install dir]/uninstall/uninstallpvm


Caution The uninstallpvm command uninstalls the entire Cisco PVM application including the Oracle database and Oracle data server. You cannot uninstall the patch.


Related Documentation

The following is a list of the documentation for Cisco Performance Visibility Manager, 1.0.2. You can access the URLs listed for each document on the Documentation CD-ROM and at www.cisco.com on the World Wide Web.

Cisco PVM Quick Start and Documentation Guide (78-17305-06)

http://www.cisco.com/en/US/docs/net_mgmt/performance_visibility_manager/1.0/quick/guide/
pvmdocgd.html

Release Notes for Cisco Performance Visibility Manager, 1.0.2 (OL-8615-03)

http://www.cisco.com/en/US/products/ps6768/prod_release_notes_list.html

Cisco Performance Visibility Manager User Guide (OL-8620-03)

http://www.cisco.com/en/US/docs/net_mgmt/performance_visibility_manager/1.0/user/guide/
users.html

Cisco Performance Visibility Manager Installation Guide (OL-8614-03)

http://www.cisco.com/en/US/docs/net_mgmt/performance_visibility_manager/1.0/installation/
guide/install.html

Cisco Performance Visibility Manager Troubleshooting Guide (OL-8619-03)

http://www.cisco.com/en/US/docs/net_mgmt/performance_visibility_manager/1.0/
troubleshooting/guide/trouble.html

Obtaining Documentation, Obtaining Support, and Security Guidelines

For information on obtaining documentation, obtaining support, providing documentation feedback, security guidelines, and also recommended aliases and general Cisco documents, see the monthly What's New in Cisco Product Documentation, which also lists all new and revised Cisco technical documentation, at:

http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html