Table Of Contents
Quick Start and Documentation Guide for Cisco Performance Visibility Manager 1.0.2
Verifying the X Virtual Frame Buffer Installation
Installing the Xvfb Server During RHEL 4.0 OS Installation
Installing the Xvfb Server Using the Graphical User Interface
Minimum Disk Space Requirements
Supplemental License Agreement
Additional License Restrictions
Evaluation and Production Modes of Operation
Verifying the License Manager Status
Additional Licensing Information
Getting Started With Cisco PVM
Logging in Using the Host Machine
Changing the Default Administrator Password
Obtaining Documentation, Obtaining Support, and Security Guidelines
Quick Start and Documentation Guide for Cisco Performance Visibility Manager 1.0.2
This document provides the following sections:
•
Supplemental License Agreement
•
•
Installation Prerequisites
Before you begin installing Cisco PVM, verify that the host and client machines meet the requirements described in Chapter 2, "Installation Requirements," of the Cisco PVM Installation Guide. You can find the Cisco PVM Installation Guide online at the following URL:
The Cisco PVM Installation Guide provides detailed information about how to install Cisco PVM software. This section lists the following prerequisites for successfully installing Cisco PVM:
•
•
See Chapter 2 of the Cisco PVM Installation Guide for more detailed information including requirements for host and client machines, network requirements, and OS and third-party software requirements.
Minimum Server Requirements
The minimum Cisco PVM server requirements are shown in Table 1.
Required Software
Before installing Cisco PVM, verify that the server has the following software installed:
•
•
This X Windows System virtual frame buffer server allows PVM to display traffic statistics. Verify that the Xvfb Server is installed during Red Hat 4.0 OS installation. See the "Verifying the X Virtual Frame Buffer Installation" section for information about how to check to see if the Xvfb server is installed and how to install it.
•
•
Required Hardware
Cisco PVM supports a maximum of 200 NAM-2 blades, which is approximately equivalent to 100 NAM-2s plus 300 NM-NAMs. The hardware requirements for Cisco PVM depend on the number of NAMs your system will support. The requirements are broken down into three configurations:
•
•
•
Table 2 summarizes the recommended minimum requirements for small, medium, and large configurations including the maximum number of NAMs supported in each configuration.
Verifying the X Virtual Frame Buffer Installation
If you are installing Cisco PVM 1.0.2 on a server that uses RHEL, Version 4, verify that X Virtual Frame Buffer (Xvfb server) is installed. To verify that Xvfb server is installed, complete the following steps:
Step 1
rpm -qa | fgrep Xvfb
Step 2
xorg-x11-Xvfb-6.8.2-1.EL.13.36XFree86-Xvfb-4.3.0-81.ELIf the command produces any output, the X Virtual Frame Buffer is installed. If the command generates no output, you must manually install the X Virtual Frame Buffer.
If you need to install the X Virtual Frame Buffer, use one of the following procedures.
Installing the Xvfb Server During RHEL 4.0 OS Installation
To install the Xvfb package during the RHEL 4.0 OS installation, complete the following steps:
Step 1
Step 2
Step 3
Step 4
Installing the Xvfb Server Using the Graphical User Interface
To install the X Virtual Frame Buffer using the graphical user interface on an existing RHEL server, complete the following steps:
Note
Step 1
Step 2
Step 3
Minimum Disk Space Requirements
Cisco PVM requires a minimum 79 GB of disk space as shown in Table 3.
Table 3 Minimum Disk Space Requirements
Cisco PVM
4 GB
Oracle
4 GB
Database
70 GB
Temporary directory
1 GB
Note
Minimum Client Requirements
Table 4 shows the minimum Cisco PVM client machine requirements.
Minimum Network Requirements
Cisco PVM requires a 100 Mbps Fast Ethernet LAN with the following firewall ports open and not in use by any other application or process:
•
•
•
•
•
•
•
•
Note
Network devices must be configured for SNMP access. Firewall and access list restrictions must be appropriately configured.
Software Compatibility
Cisco PVM software compatibility includes the following:
•
•
•
Installation Overview
Cisco PVM uses 32-bit Oracle. The installation DVD includes Oracle 9i Standard Edition, and the installation software partitions and assigns Oracle variable values. You must shut down Oracle if you are repeating the Cisco PVM installation or if you currently have a version of Oracle running.
The installation process is automated using Cisco PVM installation software on a dedicated server. The installation software installs all components and sets the environment to run Cisco PVM with little user interaction.
The Cisco PVM installation requires root-level access to a Linux server with the disk space specified in the "Minimum Disk Space Requirements" section. The automated installation process does the following:
1.
2.
3.
4.
5.
6.
7.
During the installation, status and progress messages are displayed on the console and are also written to a log. In addition, errors related to the application and database installations are displayed on the console and written to the log.
Note
Note
The Cisco PVM installation will ask you to specify the locations for the Cisco PVM application, Oracle application, data storage, and installation logs. At each prompt, you can accept the default, shown in Table 5, or specify an alternate location.
Supplemental License Agreement
SUPPLEMENTAL LICENSE AGREEMENT FOR CISCO SYSTEMS NETWORK MANAGEMENT SOFTWARE: CISCO PERFORMANCE VISIBILITY MANAGER
IMPORTANT-READ CAREFULLY
This Supplemental License Agreement (SLA) contains additional limitations on the license to the Software provided to Customer under the Software License Agreement between Customer and Cisco. Capitalized terms used in this SLA and not otherwise defined herein shall have the meanings assigned to them in the Software License Agreement. To the extent that there is a conflict among any of these terms and conditions applicable to the Software, the terms and conditions in this SLA shall take precedence.
By installing, downloading, accessing or otherwise using the Software, Customer agrees to be bound by the terms of this SLA. If Customer does not agree to the terms of this SLA, Customer may not install, download, or otherwise use the Software. When used below, the term server refers to central processor unit.
Additional License Restrictions
Cisco Performance Visibility Manager (Cisco PVM) Base Software Kit (Software) includes the necessary software for installing Cisco PVM on to a single server running Red Hat® Enterprise Linux® (RHEL) operating system. Licensing right-to-use is based on the number of Cisco Catalyst 6500 Series and Cisco 7600 Series Network Analysis Modules NAM-1/NAM-2 and Cisco Branch Routers Series Network Analysis Modules NM-NAM managed by the Cisco PVM Software.
In addition to purchasing the Cisco PVM Base Software Kit (CPVM-1.0-BASE-K9), the Customer is required to purchase any one of the following Device License Options that correspond to the number of NAM-1/NAM-2 or NM-NAM devices managed:
•
•
•
•
•
•
When used anywhere in this SLA, a device means a Cisco Catalyst 6500 Series and Cisco 7600 Series Network Analysis Module NAM-1/NAM-2 module or a Cisco Branch Routers Series Network Analysis Module NM-NAM module, belonging to a switch or router that has its own IP address.
Customers who are returning to add additional device licenses to their Cisco PVM Software and server installation may do so by purchasing the Spare Device License Add-on Options. The Spare Device License Add-on Option product ordering codes follow a similar convention as above and simply include an equal sign (=) at the end of the part number (as in CPVM-10-6K10-LIC=, CPVM-10-6K25-LIC=, CPVM-10-6K50-LIC=, CPVM-1.0-NM10-LIC=, CPVM-1.0-NM25-LIC=, CPVM-1.0-NM50-LIC=).
Device restrictions are enforced by license registration.
Installation and Use
The Software components are provided to Customer solely to install or supplement existing functionality of the applicable Network Management Software product. Some license terms such as device count and proof of preexisting licenses might be electronically enforced.
Customer may install and use the Cisco PVM Software on a single server running Red Hat Linux. The Customer is required to purchase at least one Device License Option that corresponds to the number of NAM-1/NAM-2 or NM-NAM devices they plan on managing in their network management environment.
Reproduction and Distribution
Customer may not reproduce nor distribute software.
Other Rights and Limitations
Please refer to the Cisco Systems, Inc. End User License Agreement.
Licensing Your Product
Cisco PVM requires a license file to be installed to operate in the non-evaluation mode. The license file is not included in the Cisco PVM distribution. You use a Product Authorization Key (PAK) printed on a Software Claim Certificate in the package you receive and specific information about the host that will run Cisco PVM to register your product and obtain a license file. This section contains the following topics:
•
Evaluation and Production Modes of Operation
Without a valid license file installed, Cisco PVM will operate in evaluation mode for 90 days, but will cease operating after the 90-day evaluation period expires. Attempting to log in to Cisco PVM from the web interface after the 90-day evaluation period will cause an error indicating an invalid license.
If you have received the Cisco PVM as an evaluation copy, you need not register the product during the 90-day evaluation period. During the installation process, check that you are installing for Evaluation Only.
The installation process for an evaluation copy is same as that of a purchased product, except that you are prompted by the Cisco PVM application to select the Evaluation Only option from the Licensing Information page.
If you choose to run any application in evaluation mode, the application stops functioning after 90 days. The evaluation period cannot be extended. If you have a purchased copy and you decide to install it in evaluation mode, please use your PAK to register the product on the Cisco online licensing site and receive a valid license.
If you have not purchased the product, the Cisco PVM evaluation server can be reactivated by purchasing Cisco PVM from your authorized Cisco reseller. You can license the product using the PAK provided with the product. For details see the "Installing the License File" section.
Note
Obtaining the License File
A PAK is printed on a Software Claim Certificate and included with the product you receive from Cisco. The PAK contains resource limitations and is used to register Cisco PVM on Cisco.com. A license file is sent by e-mail to you after you use the PAK to register on Cisco.com.
To obtain your license file, use one of the following URLs to register the PAK with Cisco.com:
•
http://www.cisco.com/go/license
•
http://www.cisco.com/go/license/public
You will need the hostname and host ID when you register your product and request your production license.
Step 1
su - pvmadm
Step 2
hostname
Step 3
cd /opt/CSCOpvm/flexlm/bin/lmhostid
You can obtain and install your license file at any time. We recommend that you complete the Cisco PVM license registration and receive the product license before installing Cisco PVM.
If the person installing Cisco PVM is not authorized to obtain the license on behalf of the administrator, the product can be installed and used for 90 days in evaluation mode. During the 90-day period, Cisco PVM will remind all users to complete the licensing process.
Installing the License File
After you receive the product license file and install Cisco PVM software, copy the license file to the host computer where Cisco PVM is installed.
Step 1
su - pvmadm
Step 2
Step 3
lmreread
License Administration
Cisco PVM includes the following command-line programs, located in [install directory]/flexlm/bin, for handling the licenses.
•
•
•
The Cisco PVM log file, [install directory]/logs provides detailed information about when licensed features were checked in and checked out.
Testing the License Manager
After installing the license file, verify the license manager status. Ensure that the following Cisco PVM components are up and running:
•
•
•
Verifying the License Manager Status
Perform the following steps to check the status of the License Manager.
Step 1
Step 2
/opt/CSCOpvm/flexlm/bin/lmstat -c
/opt/CSCOpvm/server/etc/sp_license.dat
Step 3
Additional Licensing Information
Cisco PVM Software might need to run on additional servers to support large numbers of NAM-1/NAM-2 and NM-NAM devices or to meet certain performance criteria. When more than one server is used to host the Cisco PVM Software, each server must have an additional licensed copy of the Cisco PVM Base Software Kit and at least one registered NAM-1/NAM-2 or NM-NAM Device License Option installed.
You should not modify the license file. Legal restrictions concerning the distribution of the Cisco PVM Software is described in the "Supplemental License Agreement" section. More than one copy of Cisco PVM Base Software Kit should not be running in the network unless additional copies of the Software and Device License Options have been purchased and licensed.
Getting Started With Cisco PVM
This section provides information about getting started with Cisco PVM including the following:
•
•
•
Logging in Using the Host Machine
At the command prompt, log in as the Cisco PVM Administrator by entering:
su - pvmadm
Starting Cisco PVM
Enter the following to start Cisco PVM:
[installation directory]/bin/pvm start
Verify that Cisco PVM started properly by entering:
pvm status
You can also check running processes by using the ps and grep commands:
ps -ef | grep pvm
You should also check the PVM and Oracle processes:
ps -ef | grep ora
Statuses should be in "S" (sleeping) state. No errors or statuses "D" (process was started but is dead) or "U" (process is not started, or is in an unknown status, or has an unknown process ID) should be shown.
Changing the Default Administrator Password
As a security precaution, you should change the default password before you start using Cisco PVM. To change the default password, complete the following steps:
Step 1
Step 2
•
•
Step 3
Step 4
Step 5
Step 6
Step 7
Step 8
Step 9
Logging in to the Client
To log in to the Cisco PVM client and begin using the system, complete the following steps:
Step 1
Step 2
Step 3
Step 4
Setting Up NAMs
The Add NAM feature allows administrators to manually add individual NAMs to Cisco PVM for collection and monitoring. Supporting switch and router information can be added concurrently with the NAM parameters, but a NAM can be added to the system without its supporting device information, and Cisco PVM will still collect and aggregate data from the NAM. In this case, however, switch and router information is unavailable to the Monitor and Report functions. However you can use the Cisco PVM edit function to add switch/router information later.
Timesaver
Step 1
The NAMs window appears, showing the list of NAMs that have been set up in Cisco PVM. Initially, the list is empty.
Step 2
The Add a New NAM window appears to enable entry of NAM details for both NAM and supporting device parameters.
Step 3
•
•
•
•
•
Note
Step 4
•
•
•
•
Step 5
•
•
•
•
•
Note
Step 6
•
•
•
•
Step 7
Tip
Step 8
a.
b.
The NAMs window displays the filtered list of NAMs.
Setting Up Data Source Groups
To supply traffic information to the Monitor and Reports functions, Cisco PVM uses the concept of the Data Source Group (DSG), a logical collection of raw data sources that Administrators can customize into groups for NAMs, switches, and routers.
Cisco PVM automatically collects all the traffic statistics provided by NAMs or supporting devices as soon as they have been added or imported into the system. Cisco PVM uses DSGs for those system functions that require calculating statistics over multiple data sources, such as in Thresholds and reports.
The DSG setup displays all existing data sources possible by NAM or supporting device, and you can specify only those sources they want to include in the group. It is possible, therefore, to combine similar data sources from multiple NAMs or supporting devices into a single DSG. You can then generate reports, including aggregated statistics, containing performance data from only those sources in the DSG.
Note
Default Switch DSGs
For every switch that is added to Cisco PVM, the system automatically creates the following DSGs:
•
•
Neither of these DSGs can be modified or removed.
Adding Data Source Groups
The Cisco PVM Add a New Data Source Group function allows you to add DSGs across multiple NAMs or switches/routers in a single window. After you assign data sources to the group from one device, you can select another device of the same type and add its data sources to the group. Cisco PVM will not allow you to create a DSG if the DSG:
•
•
•
•
To add a data source group, complete the following steps:
Step 1
Step 2
Step 3
The Add a New Data Source Group window appears.
Step 4
Step 5
Step 6
•
•
The Select Device list is populated with the devices available in the system based on the device type you selected.
Note
Step 7
The Select Data Source(s) list is populated with the data sources available for the device you selected.
Note
Step 8
Tip
Step 9
The data source(s) you selected are moved to the Selected Device Data Source(s) list.
Step 10
Step 11
The window refreshes to display the Selected Device Data Source(s) list without the data source(s) you selected for removal. The removed data source(s) reappear in the Select Data Source(s) list when that list is populated from the associated device in the Select Device list.
Step 12
Cisco PVM adds the new DSG to the system and the Data Source Groups window appears with the new DSG and the message, "Successfully added new Data Source Group" in the window header.
Note
Stopping Cisco PVM
To stop Cisco PVM, complete the following steps:
Step 1
su - pvmadm
Step 2
Step 3
pvm stop
Product Documentation Set
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.
•
•
http://www.cisco.com/en/US/products/ps6768/prod_release_notes_list.html
•
http://www.cisco.com/en/US/docs/net_mgmt/performance_visibility_
manager/1.0/user/guide/users.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
This document is to be used in conjunction with the documents listed in the "Product Documentation Set" section.
CCDE, CCVP, Cisco Eos, Cisco StadiumVision, the Cisco logo, DCE, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn is a service mark; and Access Registrar, Aironet, AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation, Enterprise/Solver, EtherChannel, EtherFast, EtherSwitch, Event Center, Fast Step, Follow Me Browsing, FormShare, GigaDrive, HomeLink, Internet Quotient, IOS, iPhone, IP/TV, iQ Expertise, the iQ logo, iQ Net Readiness Scorecard, iQuick Study, IronPort, the IronPort logo, LightStream, Linksys, MediaTone, MeetingPlace, MGX, Networkers, Networking Academy, Network Registrar, PCNow, PIX, PowerPanels, ProConnect, ScriptShare, SenderBase, SMARTnet, Spectrum Expert, StackWise, The Fastest Way to Increase Your Internet Quotient, TransPath, WebEx, and the WebEx logo are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.
All other trademarks mentioned in this document or Website are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0801R)
Cisco, Cisco Systems, the Cisco logo, and the Cisco Systems logo are registered trademarks or trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries. All other trademarks mentioned in this document or Website are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0705R)
© 2008 Cisco Systems, Inc. All rights reserved.
Guest
