Cisco Systems OL-11291-01 User Manual

User Guide for Internetwork Performance Monitor

Software Release 2.6
CiscoWorks

Corporate Headquarters

Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: [phone]

800 553-NETS (6387)

Fax: [phone]

Text Part Number: OL-11291-01

THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL
STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT
WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.

THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT
SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE
OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.

The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB’s public
domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.

NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS” WITH
ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT
LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF
DEALING, USAGE, OR TRADE PRACTICE.

IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING,
WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO
OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

CCSP, CCVP, the Cisco Square Bridge logo, Follow Me Browsing, and StackWise are trademarks of Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn,
and iQuick Study are service marks of Cisco Systems, Inc.; and Access Registrar, Aironet, BPX, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, Cisco, the Cisco
Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Enterprise/Solver, EtherChannel,
EtherFast, EtherSwitch, Fast Step, FormShare, GigaDrive, GigaStack, HomeLink, Internet Quotient, IOS, IP/TV, iQ Expertise, the iQ logo, iQ Net Readiness Scorecard,
LightStream, Linksys, MeetingPlace, MGX, the Networkers logo, Networking Academy, Network Registrar, Packet, PIX, Post-Routing, Pre-Routing, ProConnect,
RateMUX, ScriptShare, SlideCast, SMARTnet, The Fastest Way to Increase Your Internet Quotient, and TransPath 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. (0601R)

User Guide for Internetwork Performance Monitor

Copyright © 1998-2006, Cisco Systems, Inc. All rights reserved.

Preface ix

Audience ix
Conventions ix
Product Documentation x
Obtaining Documentation xi

Cisco.com xi
Product Documentation DVD xi

Ordering Documentation xi
Documentation Feedback xii
Cisco Product Security Overview xii

Reporting Security Problems in Cisco Products xii
Obtaining Technical Assistance xiii

Cisco Technical Support & Documentation Website xiii

Submitting a Service Request xiv

Definitions of Service Request Severity xiv

CONTENTS

CHAPTER

CHAPTER

Obtaining Additional Publications and Information xiv

1 Overview of IPM 1-1

What is IPM? 1-1
Key Terms and Concepts 1-2
How Does IPM Work? 1-3
Client/Server Architecture 1-3
New Features in IPM 2.6 1-5

2 Getting Started With IPM 2-1

Starting IPM 2-1

Starting IPM Server on Solaris 2-1

Starting IPM Server on Windows 2-2
Starting IPM Client 2-2

Starting IPM Client From the CiscoWorks Homepage 2-2

OL-11291-01

User Guide for Internetwork Performance Monitor

iii

Contents

Starting IPM as a Standalone Client 2-3

Starting IPM Standalone Client on Solaris 2-3
Enabling the IPM Password on Solaris 2-5
Starting IPM Standalone Client on Windows 2-6
Starting IPM Client from the Windows Command Prompt 2-6

Enabling the IPM Password on Windows 2-7
Running Simultaneous IPM Sessions 2-8
Configuring the IPM Components 2-8

Defining a Source Device 2-8
Defining a Target 2-10
Defining a Collector 2-12

Viewing Network Performance Statistics 2-17

Viewing Network Performance Statistics in Real Time 2-18
Viewing Historical Network Performance Statistics 2-20

Understanding Next Range 2-26

Understanding Previous Range 2-26

CHAPTER

Printing IPM Statistics 2-27
Exiting the IPM Client 2-28

3 Using IPM to Measure Network Performance 3-1

Measuring Network Performance for DHCP 3-2

Defining a DHCP Operation 3-2
Viewing Statistics for DHCP 3-4

Measuring Network Performance for DLSw 3-5

Defining a DLSw Operation 3-5
Viewing Statistics for DLSw 3-7

Measuring Network Performance for DNS 3-8

Defining a DNS Operation 3-8
Viewing Statistics for DNS 3-9

Measuring Network Performance for HTTP 3-11

Defining an HTTP Operation 3-11
Viewing Statistics for HTTP 3-13

Measuring Network Performance for FTP 3-15

Defining an FTP Operation 3-15
Viewing Statistics for FTP 3-17

iv

User Guide for Internetwork Performance Monitor

OL-11291-01

Measuring Network Performance for IP 3-18

Measuring End-to-End Performance for IP 3-19

Defining an IP Echo Operation 3-19
Viewing End-to-End Statistics for IP 3-21

Measuring Hop-by-Hop Performance for IP 3-22

Defining an IP Path Echo Operation 3-22
Viewing Hop-by-Hop Statistics for IP 3-24

Measuring Network Performance for SNA 3-29

Defining an SNA Echo Operation 3-30
Viewing Statistics for SNA 3-31

Measuring Network Performance for TCP 3-33

Defining a TCP Operation 3-33
Viewing Statistics for TCP 3-35

Measuring Network Performance for UDP 3-36

Defining a UDP Operation 3-36
Viewing Statistics for UDP 3-38

Contents

CHAPTER

Measuring Network Performance for Enhanced UDP 3-39

Defining an Enhanced UDP Operation 3-40
Viewing Statistics for Enhanced UDP 3-41

4 Modifying IPM Components 4-1

Working With Source Devices 4-1

Viewing a List of Configured Source Devices 4-2
Viewing Source Properties 4-2
Adding a New Source Device 4-3
Deleting Source Devices 4-3

Working With Target Devices 4-3

Viewing a List of Defined Targets 4-4
Viewing Target Properties 4-4
Adding a New Target 4-5
Deleting Targets 4-5

Working With Operations 4-6

Viewing a List of Defined Operations 4-6
Viewing Operation Properties 4-8
Adding a New Operation 4-9
Setting Thresholds and Generating Alerts 4-9
Deleting Operations 4-11

OL-11291-01

User Guide for Internetwork Performance Monitor

v

Contents

Working With Collectors 4-11

Viewing a List of Defined Collectors 4-12
Viewing a Collector State Summary 4-12
Viewing Collector Properties 4-13
Adding a New Collector 4-14
Stopping Collectors 4-15
Deleting Collectors 4-15

Adding Components Using Seed Files 4-16

Creating a Seed File 4-16

Seed File Syntax 4-17

Sample Source Seed File 4-18

Sample Target Seed File 4-19

Sample Collector Seed File 4-19

Loading Components From a Seed File 4-21

Viewing Seed File Output Files 4-21
Changing IP Addresses 4-22
Setting the Baseline 4-23
Setting IPM Database Preferences 4-24

Displaying the Current Database Preferences 4-25

Changing the Database Preferences 4-25

Database Preferences File Format 4-27
Setting SNMP Timeout and Retry Environment Variables 4-29

Setting SNMP Environment Variables in Solaris 4-30

Setting SNMP Environment Variables in Windows 4-31
Setting New IPM Server Process Timeout Values 4-32

Setting Server Timeout Values in Solaris 4-33

Setting Server Timeout Values in Windows 4-33
Setting the DISPLAY Variable in Solaris 4-34
Backing Up or Restoring the IPM Database 4-35
NVRAM Settings 4-35
Managed Source Interface Settings 4-36
Changing Administrative Password 4-37

vi

Changing IPM Database Password 4-37
Working With Message Log Window 4-38

Log Control 4-38

Log Display 4-39

User Guide for Internetwork Performance Monitor

OL-11291-01

Contents

CHAPTER

5 Working With IPM From the CiscoWorks Homepage 5-1

Accessing IPM Data From the CiscoWorks Homepage 5-1
Viewing IPM Server Information 5-2

Viewing Status Information for IPM Servers 5-3
Viewing Version Information for the IPM Server and Components 5-4
Viewing the IPM Server Log 5-4
Viewing the IPM Console Log 5-5

Viewing the Troubleshooting Log for IPM 5-6
Importing Devices From Device and Credential Repository 5-7
Downloading the IPM Client 5-10

Downloading the IPM Client for Solaris 5-10

Downloading the IPM Client for Windows 5-11
Viewing Configuration Information 5-13

Viewing Source Configuration Information 5-13

Viewing Target Configuration Information 5-14

Viewing Operation Configuration Information 5-14

Viewing Collector Configuration Information 5-15

Viewing Path Echo Collector Path Usage Data 5-16

APPENDIX

Viewing Latency Data 5-17

Viewing Daily Latency Data 5-18

Viewing Weekly Latency Data 5-21

Viewing Monthly Latency Data 5-22
Viewing Jitter Data 5-23

Viewing Daily Jitter Data 5-23

Viewing Weekly Jitter Data 5-25

Viewing Monthly Jitter Data 5-26
Viewing HTTP Data 5-27

Viewing Daily HTTP Data 5-27

Viewing Weekly HTTP Data 5-28

Viewing Monthly HTTP Data 5-29
Accessing Software Updates and Additional Information 5-30

Viewing Information About IPM on Cisco.com 5-30

A IPM FAQs and Troubleshooting Tips A-1

IPM FAQs A-1
Troubleshooting IPM A-11

OL-11291-01

User Guide for Internetwork Performance Monitor

vii

Contents

APPENDIX

APPENDIX

G

LOSSARY

I

NDEX

B IPM Command Reference B-1

Output of ipm status Command B-8
Output of ipm help Command B-8
Output of ipm export help Command B-11
IPM Internal Commands B-13

C SA Agent Feature Mapping C-1

Verify Your SA Agent Version C-2

viii

User Guide for Internetwork Performance Monitor

OL-11291-01

Audience

Preface

This document describes how to use Internetwork Performance Monitor (IPM) 2.6, a software to monitor
the performance of multi-protocol networks. This preface describes who should read this guide, and
outlines the document conventions used in this guide.

This document is for the network administrator or operator who uses the Internetwork Performance
Monitor software. Network administrators or operators should have:

• Basic network management skills

Conventions

This document uses the following conventions:

• Basic Windows system administrator skills

• Basic Solaris system administrator skills

Item Convention

Commands and keywords boldface font
Variables for which you supply values italic font
Displayed session and system information
Information you enter
Variables you enter
Menu items and button names boldface font
Selecting a menu item in paragraphs Option > Network Preferences
Selecting a menu item in tables Option > Network Preferences

screen font

boldface screen font

italic screen font

OL-11291-01

Note Means reader take note. Notes contain helpful suggestions or references to material not covered in the

publication.

User Guide for Internetwork Performance Monitor

ix

Product Documentation

Caution Means reader be careful. In this situation, you might do something that could result in equipment

Preface

damage or loss of data.

Warning

This symbol means danger. You are in a situation that could cause bodily injury.

Product Documentation

Note We sometimes update the printed and electronic documentation after original publication. Therefore,

you should also review the documentation on Cisco.com for any updates.

Table 1 describes the product documentation that is available.

Table 1 Product Documentation

Document Title Available Formats

Release Notes for Internetwork
Performance Monitor 2.6

Installation Guide for Internetwork
Performance Monitor 2.6

User Guide for Internetwork
Performance Monitor 2.6

Context-sensitive online help

• On Cisco.com at this URL:

http://www.cisco.com/en/US/products/sw/cscowork/ps1008/prod_release_note0
9186a008035c18b.html

• PDF on the documentation CD-ROM.

• On Cisco.com at this URL:

http://www.cisco.com/en/US/products/sw/cscowork/ps1008/products_installatio
n_guide_book09186a0080366ce9.html

• PDF on the documentation CD-ROM.

• On Cisco.com at this URL:

http://www.cisco.com/en/US/products/sw/cscowork/ps1008/products_user_guid
e_book09186a0080366cf7.html

• Select an option from the navigation tree, then click Help.

• Click the Help button in the dialog box.

User Guide for Internetwork Performance Monitor

x

OL-11291-01

Preface

Obtaining Documentation

Cisco documentation and additional literature are available on Cisco.com. Cisco also provides several
ways to obtain technical assistance and other technical resources. These sections explain how to obtain
technical information from Cisco Systems.

Cisco.com

You can access the most current Cisco documentation at this URL:

http://www.cisco.com/techsupport

You can access the Cisco website at this URL:

http://www.cisco.com

You can access international Cisco websites at this URL:

http://www.cisco.com/public/countries_languages.shtml

Obtaining Documentation

Product Documentation DVD

Cisco documentation and additional literature are available in the Product Documentation DVD package,
which may have shipped with your product. The Product Documentation DVD is updated regularly and
may be more current than printed documentation.

The Product Documentation DVD is a comprehensive library of technical product documentation on
portable media. The DVD enables you to access multiple versions of hardware and software installation,
configuration, and command guides for Cisco products and to view technical documentation in HTML.
With the DVD, you have access to the same documentation that is found on the Cisco website without
being connected to the Internet. Certain products also have .pdf versions of the documentation available.

The Product Documentation DVD is available as a single unit or as a subscription. Registered Cisco.com
users (Cisco direct customers) can order a Product Documentation DVD (product number
DOC-DOCDVD=) from Cisco Marketplace at this URL:

http://www.cisco.com/go/marketplace/

Ordering Documentation

Beginning June 30, 2005, registered Cisco.com users may order Cisco documentation at the Product
Documentation Store in the Cisco Marketplace at this URL:

http://www.cisco.com/go/marketplace/

Nonregistered Cisco.com users can order technical documentation from 8:00 a.m. to 5:00 p.m.
(0800 to 1700) PDT by calling 1 866 463-3487 in the United States and Canada, or elsewhere by
calling 011 408 519-5055. You can also order documentation by e-mail at

[e-mail] or by fax at 1 408 519-5001 in the United States and Canada,

or elsewhere at 011 408 519-5001.

OL-11291-01

User Guide for Internetwork Performance Monitor

xi

Documentation Feedback

Documentation Feedback

You can rate and provide feedback about Cisco technical documents by completing the online feedback
form that appears with the technical documents on Cisco.com.

You can send comments about Cisco documentation to [e-mail].
You can submit comments by using the response card (if present) behind the front cover of your

document or by writing to the following address:
Cisco Systems

Attn: Customer Document Ordering
170 West Tasman Drive
San Jose, CA 95134-9883

We appreciate your comments.

Cisco Product Security Overview

Cisco provides a free online Security Vulnerability Policy portal at this URL:

Preface

http://www.cisco.com/en/US/products/products_security_vulnerability_policy.html

From this site, you can perform these tasks:

• Report security vulnerabilities in Cisco products.

• Obtain assistance with security incidents that involve Cisco products.

• Register to receive security information from Cisco.

A current list of security advisories and notices for Cisco products is available at this URL:

http://www.cisco.com/go/psirt

If you prefer to see advisories and notices as they are updated in real time, you can access a Product
Security Incident Response Team Really Simple Syndication (PSIRT RSS) feed from this URL:

http://www.cisco.com/en/US/products/products_psirt_rss_feed.html

Reporting Security Problems in Cisco Products

Cisco is committed to delivering secure products. We test our products internally before we release them,
and we strive to correct all vulnerabilities quickly. If you think that you might have identified a
vulnerability in a Cisco product, contact PSIRT:

• Emergencies—[e-mail]

An emergency is either a condition in which a system is under active attack or a condition for which
a severe and urgent security vulnerability should be reported. All other conditions are considered
nonemergencies.

xii

• Nonemergencies—[e-mail]

In an emergency, you can also reach PSIRT by telephone:

• 1 877 228-7302

• 1 408 525-6532

User Guide for Internetwork Performance Monitor

OL-11291-01

Preface

Tip We encourage you to use Pretty Good Privacy (PGP) or a compatible product to encrypt any sensitive

information that you send to Cisco. PSIRT can work from encrypted information that is compatible with
PGP versions 2.x through 8.x.

Never use a revoked or an expired encryption key. The correct public key to use in your correspondence
with PSIRT is the one linked in the Contact Summary section of the Security Vulnerability Policy page
at this URL:

http://www.cisco.com/en/US/products/products_security_vulnerability_policy.html

The link on this page has the current PGP key ID in use.

Obtaining Technical Assistance

Cisco Technical Support provides 24-hour-a-day award-winning technical assistance. The Cisco
Technical Support & Documentation website on Cisco.com features extensive online support resources.
In addition, if you have a valid Cisco service contract, Cisco Technical Assistance Center (TAC)
engineers provide telephone support. If you do not have a valid Cisco service contract, contact your
reseller.

Obtaining Technical Assistance

Cisco Technical Support & Documentation Website

The Cisco Technical Support & Documentation website provides online documents and tools for
troubleshooting and resolving technical issues with Cisco products and technologies. The website is
available 24 hours a day, at this URL:

http://www.cisco.com/techsupport

Access to all tools on the Cisco Technical Support & Documentation website requires a Cisco.com user
ID and password. If you have a valid service contract but do not have a user ID or password, you can
register at this URL:

http://tools.cisco.com/RPF/register/register.do

Note Use the Cisco Product Identification (CPI) tool to locate your product serial number before submitting

a web or phone request for service. You can access the CPI tool from the Cisco Technical Support &
Documentation website by clicking the Tools & Resources link under Documentation & Tools. Choose

Cisco Product Identification Tool from the Alphabetical Index drop-down list, or click the Cisco
Product Identification Tool link under Alerts & RMAs. The CPI tool offers three search options: by

product ID or model name; by tree view; or for certain products, by copying and pasting show command
output. Search results show an illustration of your product with the serial number label location
highlighted. Locate the serial number label on your product and record the information before placing a
service call.

OL-11291-01

User Guide for Internetwork Performance Monitor

xiii

Obtaining Additional Publications and Information

Submitting a Service Request

Using the online TAC Service Request Tool is the fastest way to open S3 and S4 service requests. (S3
and S4 service requests are those in which your network is minimally impaired or for which you require
product information.) After you describe your situation, the TAC Service Request Tool provides
recommended solutions. If your issue is not resolved using the recommended resources, your service
request is assigned to a Cisco engineer. The TAC Service Request Tool is located at this URL:

http://www.cisco.com/techsupport/servicerequest

For S1 or S2 service requests or if you do not have Internet access, contact the Cisco TAC by telephone.
(S1 or S2 service requests are those in which your production network is down or severely degraded.)
Cisco engineers are assigned immediately to S1 and S2 service requests to help keep your business
operations running smoothly.

To open a service request by telephone, use one of the following numbers:
Asia-Pacific: [phone] (Australia: 1 800 805 227)

EMEA: [phone]
USA: 1 800 553-2447

For a complete list of Cisco TAC contacts, go to this URL:

http://www.cisco.com/techsupport/contacts

Preface

Definitions of Service Request Severity

To ensure that all service requests are reported in a standard format, Cisco has established severity
definitions.

Severity 1 (S1)—Your network is “down,” or there is a critical impact to your business operations. You
and Cisco will commit all necessary resources around the clock to resolve the situation.

Severity 2 (S2)—Operation of an existing network is severely degraded, or significant aspects of your
business operation are negatively affected by inadequate performance of Cisco products. You and Cisco
will commit full-time resources during normal business hours to resolve the situation.

Severity 3 (S3)—Operational performance of your network is impaired, but most business operations
remain functional. You and Cisco will commit resources during normal business hours to restore service
to satisfactory levels.

Severity 4 (S4)—You require information or assistance with Cisco product capabilities, installation, or
configuration. There is little or no effect on your business operations.

Obtaining Additional Publications and Information

Information about Cisco products, technologies, and network solutions is available from various online
and printed sources.

• Cisco Marketplace provides a variety of Cisco books, reference guides, documentation, and logo

merchandise. Visit Cisco Marketplace, the company store, at this URL:

http://www.cisco.com/go/marketplace/

xiv

User Guide for Internetwork Performance Monitor

OL-11291-01

Preface

Obtaining Additional Publications and Information

• Cisco Press publishes a wide range of general networking, training and certification titles. Both new

and experienced users will benefit from these publications. For current Cisco Press titles and other
information, go to Cisco Press at this URL:

http://www.ciscopress.com

• Pack et magazine is the Cisco Systems technical user magazine for maximizing Internet and

networking investments. Each quarter, Packet delivers coverage of the latest industry trends,
technology breakthroughs, and Cisco products and solutions, as well as network deployment and
troubleshooting tips, configuration examples, customer case studies, certification and training
information, and links to scores of in-depth online resources. You can access Packet magazine at
this URL:

http://www.cisco.com/packet

• iQ Magazine is the quarterly publication from Cisco Systems designed to help growing companies

learn how they can use technology to increase revenue, streamline their business, and expand
services. The publication identifies the challenges facing these companies and the technologies to
help solve them, using real-world case studies and business strategies to help readers make sound
technology investment decisions. You can access iQ Magazine at this URL:

http://www.cisco.com/go/iqmagazine

or view the digital edition at this URL:

http://ciscoiq.texterity.com/ciscoiq/sample/

• Internet Protocol Journal is a quarterly journal published by Cisco Systems for engineering

professionals involved in designing, developing, and operating public and private internets and
intranets. You can access the Internet Protocol Journal at this URL:

http://www.cisco.com/ipj

• Networking products offered by Cisco Systems, as well as customer support services, can be

obtained at this URL:

http://www.cisco.com/en/US/products/index.html

• Networking Professionals Connection is an interactive website for networking professionals to share

questions, suggestions, and information about networking products and technologies with Cisco
experts and other networking professionals. Join a discussion at this URL:

http://www.cisco.com/discuss/networking

• World-class networking training is available from Cisco. You can view current offerings at

this URL:

http://www.cisco.com/en/US/learning/index.html

OL-11291-01

User Guide for Internetwork Performance Monitor

xv

Obtaining Additional Publications and Information

Preface

xvi

User Guide for Internetwork Performance Monitor

OL-11291-01

Overview of IPM

This chapter provides an overview of Internetwork Performance Monitor (IPM) application. It contains
the following sections:

• What is IPM?

• Key Terms and Concepts

• How Does IPM Work?

• Client/Server Architecture

What is IPM?

IPM is a network management application that allows you to monitor the performance of multi-protocol
networks. IPM measures the latency and availability of IP networks on a hop-by-hop (router-to-router)
basis. It also measures latency between routers and the mainframe in Systems Network Architecture
(SNA) networks, and monitors jitter in networks.

CHAPTER

1

You can use IPM to:

• Troubleshoot problems by checking the network performance between devices.

• Send Simple Network Management Protocol (SNMP) traps and SNA alerts when a user-configured

threshold is exceeded, a connection is lost and reestablished, or a timeout occurs.

• Analyze potential problems before they occur by accumulating statistics, which then can be used to

model and design future network topologies.

• Monitor latency, availability, and errors between two network end points.

• Monitor jitter, packet loss, and errors between two network end points.

• Discover network paths between two network end points, and monitor network performance

statistics on a hop-by-hop basis.

• Provide Web-based access to long-term information to help determine statistical trends.

• Monitor the availability of critical network servers.

• Monitor SNA performance in mainframe environments.

• Establish service-level agreements.

OL-11291-01

User Guide for Internetwork Performance Monitor

1-1

Key Terms and Concepts

The IPM/SA Agent monitoring solution is composed of:

1. The IPM server

2. The IPM client application

3. The Service Assurance (SA) Agent feature of the Cisco IOS software

The focus of this document is the IPM network management application, which includes the server and
the client. In some cases, however, it is not possible to fully describe IPM without including information
about the SA Agent feature. Therefore, we have included some information about the Cisco IOS feature.
Information about the SA Agent feature, provided in the latest Cisco IOS software documentation takes
precedence over the information about the SA Agent feature, contained in this document.

Key Terms and Concepts

The key terms and concepts in IPM are:

• Network Performance Statistics—Five key statistics measured by IPM:

–

Latency

Chapter 1 Overview of IPM

–

Availability

–

Jitter

–

Packet Loss

–

Errors

• Source—Originating switch or router running IOS, from which IPM makes network performance

measurements. The source switch or router must be running a version of Cisco IOS software that
supports the SA Agent feature. For detailed information about the supported versions of the Cisco
IOS software, see the “Cisco IOS Software Requirements” section in the Installation Guide for
Internetwork Performance Monitor.

• Targ et —Destination of the network performance measurements. The target can be any

IP-addressable device, an IBM Multiple Virtual Storage (MVS) mainframe that can be reached by
the source router, or an SA Agent-enabled Cisco router. For jitter measurements, the target must be
an SA Agent-enabled Cisco router or switch with RTR responder enabled.

• Operation—Set of parameters used in measuring network performance statistics. The parameters

specify the type of measurement to be performed.

• Collector—Entity defined to measure network performance statistics from a specific source device

to a specific target device. The collector definition includes information about its source, target,
operation, start time, duration, and type.

• Interval—How often, in seconds, the collector on the source router executes the measurement to

and from the target. The value is usually every 60 seconds. The valid range is 10 to 3600 seconds (1
hour). The source router automatically aggregates all samples for a single hour into a single set of
metrics for that hour. IPM retrieves these metrics from the source router once every hour.

• Duration—How long, in days, hours, and minutes, the collector runs and gathers information from

the source router. The default value is forever. The valid range is 1 hour to forever.

• SA Agent Responder—Component embedded in a target Cisco device, running version 12.1 or

later of the Cisco IOS software. It responds to SA Agent request packets from a source running the
SA Agent software, supporting Enhanced UDP measurements, such as jitter.

1-2

User Guide for Internetwork Performance Monitor

OL-11291-01

Chapter 1 Overview of IPM

How Does IPM Work?

IPM measures and displays network performance statistics (latency, availability, jitter, packet loss, and
error information) between a source and a target device.

The target can be an IP-addressable device, an IBM MVS mainframe, or an SA Agent-enabled Cisco
router:

• If the target is an IP-addressable device, it can be a network device, a server, or a workstation.

• If the target is an IBM MVS mainframe, it must be running an IPM Virtual Telecommunications

Access Method (VTAM) application called NSPECHO for measuring SNA latency. See the
“Installing NSPECHO to Measure SNA Response Times” chapter of the Installation Guide for
Internetwork Performance Monitor for more information.

• If the target is an SA Agent-enabled, the source must be running version 12.1 or later of the Cisco

IOS software. The IPM application is used to configure the SA Agent in each source device. The
SA Agent measures the performance between the source router and the target device.

The source aggregates all measurements into a single sample value for each network performance
statistic. IPM gathers the data from the source and stores it in the IPM database.

IPM also provides a real-time feature that allows you to display the data without waiting for the one-hour
data collection interval. However, the data displayed in the Real Time window is not stored in the IPM
database.

Additionally, IPM provides an extensive set of reports and graphs for viewing and analyzing the
collected performance metrics. IPM supports both standalone and Web-based clients in a multi-platform
environment.

How Does IPM Work?

Client/Server Architecture

IPM provides central services and database functions on an IPM server, which communicates through a
messaging interface to multiple IPM clients (Figure 1-1). The IPM software consists of server software
and client software components that can be installed on the same workstation or on different
workstations.

OL-11291-01

User Guide for Internetwork Performance Monitor

1-3

Client/Server Architecture

Figure 1-1 IPM Client/Server Architecture

Chapter 1 Overview of IPM

Solaris or Windows 2000 System

(IPM server, client, and database)

IPM client on

Windows 2000 workstation

Network

IPM client on

Solaris workstation

IPM client on

Windows XP workstation

85632

For this release of IPM, the server software runs on Solaris 2.8, Solaris 2.9, and Windows 2000
Professional and Server (with SP3 or SP4), Windows 2000 Advanced Server (with SP3 or SP4),
Windows 2000 Terminal Services Remote Administration Mode (with SP3 or SP4) or Windows 2003.

The client software runs on Solaris 2.8, Solaris 2.9, Windows 2000 Professional and Server (with SP3
and SP4), Windows XP Professional (with SP1a) or Windows 2003 platforms.

The client/server architecture is cross-platform compatible, which allows you to run the client and server
software in mixed operating system environments. For example, you can run the IPM server on a Solaris
workstation and access it from an IPM client running on a Windows workstation.

Note IPM does not support Network Address Translation (NAT) and Port Address Translation (PAT) between

the client and the server.

1-4

The IPM server software consists of a group of functional services that manage the data among the
network, client workstations, and the centralized database.

The IPM server manages the exchange of data between the IPM database and the network devices, such
as the source routers. The IPM process manager launches and manages all of the IPM servers, providing
a robust and reliable launching platform for IPM.

The IPM client integrates with the CiscoWorks homepage.
From a Web browser running on a Solaris 2.8, Solaris 2.9, Windows 2000 Professional and Server (with

SP3 and SP4), Windows XP Professional (with SP1a) or Windows 2003 platforms workstation on the
network, you can:

• Access the source, target, operation, and collector definitions.

• View Web-based reports of the performance metrics.

User Guide for Internetwork Performance Monitor

OL-11291-01

Chapter 1 Overview of IPM

• Download/Launch the IPM client.

• View Web-based troubleshooting information.

• Determine the version of IPM that has been installed.

• View seed files.

All the above functions can be launched via the CiscoWorks homepage.

New Features in IPM 2.6

These are the new features in IPM 2.6:

• Support for importing device from Device and Credential Repository — IPM 2.6 provides you the

facility to import devices from the Device and Credential Repository. You can import devices as
Sources, as Target SAA Responders, or as Target IP Devices.

• Differentiated Service Code Point (DSCP) support — In IPM 2.6 users are provided with the feature

of selecting either the IP Precedence settings or DSCP setting.

• Source interface on collector — In the earlier IPM releases, users could not specify a source

interface configuration on an individual collector basis while configuring a collector. IPM 2.6 has
features to overcome this limitation.

• Device Center Integration — In IPM 2.6, the Device Center will be launched for devices in IPM.

The Device Center will be launched irrespective of whether a device is present in Device and
Credential Repository or not.

• Improved Scalability— IPM 2.6 supports 2000 collectors in one single IPM Server.

New Features in IPM 2.6

• SSL Compliance — IPM 2.6 is SSL compliant and enables secure HTTP communication between

the client and server. The IPM web links from the CiscoWorks homepage are SSL-compliant.

OL-11291-01

User Guide for Internetwork Performance Monitor

1-5

New Features in IPM 2.6

Chapter 1 Overview of IPM

1-6

User Guide for Internetwork Performance Monitor

OL-11291-01

Getting Started With IPM

This chapter provides information about starting the IPM application and configuring a collector to
gather latency data. It includes the following major sections:

Starting IPM

• Starting IPM

• Running Simultaneous IPM Sessions

• Configuring the IPM Components

• Viewing Network Performance Statistics

• Printing IPM Statistics

• Exiting the IPM Client

CHAPTER

2

Since the IPM application is comprised of a server component and a client component, you must start
both components to run the application. If the IPM server and client are installed on the same system,
you can start the IPM server and client using a single command, or you can start them separately.

The following sections provide details for starting the IPM server and client:

• Starting IPM Server on Solaris

• Starting IPM Server on Windows

• Starting IPM Client From the CiscoWorks Homepage

• Starting IPM Standalone Client on Solaris

• Starting IPM Standalone Client on Windows

Starting IPM Server on Solaris

To start the IPM server on a Solaris system, enter:

# cd /opt/CSCOipm/bin
# ./ipm start

To enter the ipm start command, you must be logged in as the root user, or your login must have
administrator privileges.

OL-11291-01

User Guide for Internetwork Performance Monitor

2-1

Starting IPM Client

Starting IPM Server on Windows

To start the IPM server on a Windows system, enter:

cd c:\Program Files\Internetwork Performance Monitor\Server\bin
ipm start

To enter the ipm start command, you must be logged in as the administrator, or your login must have
administrator privileges.

Starting IPM Client

You can access the IPM Client in two ways: As a web client from the CiscoWorks homepage, or as a
standalone client.

This section describes:

• Starting IPM Client From the CiscoWorks Homepage

• Starting IPM as a Standalone Client

Chapter 2 Getting Started With IPM

Starting IPM Client From the CiscoWorks Homepage

You can start IPM from an Internet Explorer or Netscape Navigator Web browser if:

• You are running Solaris 2.8, Solaris 2.9, Windows XP Professional and Server (with SP3, SP4),

Windows 2000 Advanced Server (with SP3, SP4)
Windows 2000 Terminal Services Remote Administration mode (with SP3, SP4) or Windows 2003
Server (Standard Edition and Enterprise Edition).

• You have installed the Java plug-in 1.4.2-04. (For information about installing the Java plug-in, see

the “Installing IPM on Windows” chapter of the Installation Guide for Internetwork Performance
Monitor.)

To start the IPM client from the CiscoWorks homepage:

Step 1 Make sure the IPM server to which you are connecting is currently running.
Step 2 From your browser, go to the URL where the IPM application is installed (for example,

http://youripmserver:1741).
The homepage for the IPM Client Software appears (Figure 2-1).

2-2

User Guide for Internetwork Performance Monitor

OL-11291-01

Chapter 2 Getting Started With IPM

Figure 2-1 IPM CiscoWorks Homepage

Starting IPM Client

If you do not have this URL, contact the system administrator who installed the IPM server software.

Step 3 Select Client > Web Client.

The Java applet loads and the IPM Main Window is displayed.
The IPM Main Window is the starting point from where you can carry out the various IPM operations.

In addition to and accessing the IPM Main Window from the CiscoWorks homepage, you can also launch
the IPM Main Window from a standalone Solaris or a Windows client.

For details on starting IPM on Solaris, see Starting IPM Standalone Client on Solaris, page 2-3. For
details on starting IPM on Windows, see Starting IPM Standalone Client on Windows, page 2-6.

Starting IPM as a Standalone Client

This section describes the following:

• Starting IPM Standalone Client on Solaris

• Starting IPM Standalone Client on Windows

Starting IPM Standalone Client on Solaris

To start only the IPM client on a Solaris system, enter:

# cd /opt/CSCOipm/bin
# ./ipm start client

To start the IPM server and client on a Solaris system, enter:

# cd /opt/CSCOipm/bin
# ./ipm

OL-11291-01

User Guide for Internetwork Performance Monitor

2-3

Starting IPM Client

Chapter 2 Getting Started With IPM

The default directory for installing IPM is /opt. If you installed IPM in a different directory, you must
specify that directory instead of /opt.

If you installed the IPM client and IPM server on different Solaris systems, you must enter the ipm start
command from the /opt/CSCOipmClient/bin directory:

# cd /opt/CSCOipmClient/bin
# ./ipm start client

To start the IPM client and connect to an IPM server other than the default server, enter:

# cd /opt/CSCOipmClient/bin
# ./ipm start client

where server_name is the Solaris or Windows system on which the IPM server is running.
To protect the device credentials, IPM does not allow you to disable the administrative password. IPM

will prompt you to enter the password at the time of launching the standalone client.
When the IPM client starts, it displays the IPM Main Window (Figure 2-2). The name of the system on

which the IPM server is running, appears in the title bar of the IPM Main Window.

Figure 2-2 IPM Main Window

server_name

2-4

You can also access the IPM Main Window from the CiscoWorks homepage. For more details, see

Starting IPM Client From the CiscoWorks Homepage, page 2-2. Alternatively, you can click View >

CiscoWorks Home Page to access the CiscoWorks homepage.
When you start IPM for the first time, the IPM Main Window contains no collectors. As you configure

collectors, they appear in this window. Each collector is a combination of a configured source, a target,
and an operation. For each collector, you can specify parameters for gathering statistics and scheduling.

User Guide for Internetwork Performance Monitor

OL-11291-01

Chapter 2 Getting Started With IPM

Enabling the IPM Password on Solaris

To enable IPM passwords on Solaris:

Step 1 Log in as the root user.
Step 2 Enter:

# cd /opt/CSCOipm/bin
# ./ipm password

Note The default directory for installing IPM is /opt. If you installed IPM in a different directory, you

must specify that directory instead of /opt.

IPM prompts you to enter a password.

Step 3 Enter a password and press Enter.

The password is case sensitive and should begin with an alphabet. You can enter only a maximum of 15
characters and you can enter only alphanumeric characters.

IPM prompts you to confirm the password.

Step 4 Enter the password again and press Enter.

IPM displays:

IPM Administrative Password is Changed.
Use IPM Administrative Password to access standalone IPM Client and CLI commands

The administrative password is required for launching the IPM standalone client.

Starting IPM Client

Note To protect device credentials IPM does not allow you to disable the administrative password. During

IPM installation, you will be prompted to enter the administrative password. It is important that you set
the administrative password.

OL-11291-01

User Guide for Internetwork Performance Monitor

2-5

Starting IPM Client

Starting IPM Standalone Client on Windows

When you install the IPM client on a Windows 2000 Professional and Server (with SP3 and SP4),
Windows 2000 Advanced Server (with SP3, SP4), Windows XP Pro (SP1a) or Windows 2000 (WS2K3)
system, the installation program adds two icons to your desktop: one icon for connecting to the IPM
server you specified during installation, and one icon for connecting to any IPM server.

To start the IPM client on a Windows system and connect to the default IPM server:

Step 1 Make sure the IPM server to which you are connecting is currently running.
Step 2 Double-click on the IPM client icon on your desktop.

The IPM client starts and displays the IPM Main Window (Figure 2-2).
You can also access the IPM Main Window from the CiscoWorks homepage. For more details, see

Starting IPM Client From the CiscoWorks Homepage, page 2-2. Alternatively, you can click View >

CiscoWorks Home Page to access the CiscoWorks homepage.

To start the IPM client on a Windows system and connect to any IPM server:

Chapter 2 Getting Started With IPM

Step 1 Make sure the IPM server to which you are connecting is currently running.
Step 2 Double-click on the IPM Any Server icon on your desktop.

A prompt appears asking you for the name of the IPM server to which you want to connect.

Step 3 Enter the IPM server name and click OK.

The IPM client starts and displays the IPM Main Window (Figure 2-2)

Starting IPM Client from the Windows Command Prompt

To start the IPM server and client from the command prompt on a Windows system, enter:

cd c:\Program Files\Internetwork Performance Monitor\Server\bin
ipm

The default directory for installing IPM is C:\Program Files\Internetwork Performance Monitor\. If you
installed IPM in a different directory, you must specify that directory instead of C:\Program
Files\Internetwork Performance Monitor\.

To start only the IPM client on a Windows system, enter:

cd c:\Program Files\Internetwork Performance Monitor\Server\bin
ipm start client

If you installed the IPM client and IPM server on different Windows systems, you must enter the ipm
start command from the c:\Program Files\Internetwork Performance Monitor\client\bin directory:

cd c:\Program Files\Internetwork Performance Monitor\client\bin
ipm start client

2-6

User Guide for Internetwork Performance Monitor

OL-11291-01

Chapter 2 Getting Started With IPM

To start the IPM client and connect to an IPM server other than the default server, enter:

cd c:\Program Files\Internetwork Performance Monitor\client\bin
ipm start client

server_name

where server_name is the Solaris or Windows system on which the IPM server is running.

Note To protect IPM device credentials, IPM does not allow you to disable the administrative password. IPM

will prompt you to enter the password when you launch the client.

When the IPM client starts, it displays the IPM Main Window (Figure 2-2). The name of the system on
which the IPM server is running appears in the title bar of the IPM Main Window.

When you start IPM for the first time, the IPM Main Window contains no collectors. As you configure
collectors, they are displayed in the window. Each collector is a combination of a configured source, a
target, and an operation. For each collector, you can specify parameters for gathering statistics and
scheduling.

Enabling the IPM Password on Windows

To enable an IPM password on Windows:

Starting IPM Client

Step 1 Log in as the administrator.
Step 2 Enter:

cd c:\Program Files\Internetwork Performance Monitor\Server\bin
ipm password

The default directory for installing IPM is c:\Program Files\Internetwork Performance Monitor. If you
installed IPM in a different directory, specify that directory instead of c:\Program Files\Internetwork
Performance Monitor.

IPM prompts you to enter a password.

Step 3 Enter a password and press Enter.

The password is case sensitive and should begin with an alphabet. You can enter only a maximum of 15
characters and you can enter only alphanumeric characters.

IPM prompts you to confirm the password.

Step 4 Enter the password again and press Enter.

IPM displays:

IPM Administrative Password is Changed.
Use IPM Administrative Password to access standalone IPM Client and CLI commands

The Administrative password is required for launching the IPM standalone Client.

Note To protect device credentials, IPM does not allow you to disable the administrative password. During

IPM installation, you will be prompted to enter the administrative password. It is important that you set
the administrative password.

OL-11291-01

User Guide for Internetwork Performance Monitor

2-7

Running Simultaneous IPM Sessions

Running Simultaneous IPM Sessions

IPM allows you to run multiple sessions of the IPM client simultaneously. Central services and database
functions are provided on an IPM server that communicates to multiple IPM clients. You can install the
IPM client software on the same system as the IPM server, or on a different system on the same network
as the IPM server.

Running more than one IPM client on the same workstation can degrade the workstation’s performance.

Configuring the IPM Components

To collect network performance metrics using IPM, you must define a collector in a source router. A
collector is a definition of a source router, a target device, an operation, and a collector schedule.

To define a collector, complete the following tasks:

• Defining a Source Device

• Defining a Target

Chapter 2 Getting Started With IPM

• Defining a Collector

Defining a Source Device

IPM source devices are the devices from which packets are sent to measure and store statistical data,
including network latency, jitter, availability, packet loss, and errors. Each source device must contain
the Cisco IOS software SA Agent feature.

The types of operations you can use are determined by the version of the Cisco IOS software running on
the source device. IPM automatically checks the Cisco IOS software version on the device and limits the
creation of operations to those supported by the source device.

For information about the recommended versions of Cisco IOS software to use with IPM, see the “Cisco
IOS Software Requirements” section of the Installation Guide for Internetwork Performance Monitor.

To define a new source router:

Step 1 Verify that the SNMP read community and write community strings are configured properly on the

router.
If you want to receive traps at your network management system (NMS), verify that the router is

configured to send SA Agent-generated traps to your NMS.
For information about trap configuration on the source router, see the “Configuring Your Routers to Send

SA Agent-Related Traps” section in the “Preparing to Install” chapter of the Installation Guide for
Internetwork Performance Monitor.

Step 2 From the IPM Main Window (Figure 2-2), select Edit > Configuration.

The Configuration window (Figure 2-3) appears. By default, Sources is selected in the navigation pane
and the Source Configuration window appears within the Configuration window.

2-8

User Guide for Internetwork Performance Monitor

OL-11291-01