3D Connexion OL-12491-01 User Manual

Cisco SCA BB SNMP Real Time Monitoring

User Guide

Release 3.0.5 OL-12491-01

Corporate Headquarters

Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA http://www.cisco.com Tel: 408 526-4000 800 553-NETS (6387) Fax: 408 526-4100

Customer Order Number: DOC- OL-12491-01= Text Part Number: OL-12491-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 following information is for FCC compliance of Class A devices: This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to part 15 of the FCC rules. These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a commercial environment. This equipment generates, uses, and can radiate radio-frequency energy and, if not installed and used in accordance with the instruction manual, may cause harmful interference to radio communications. Operation of this equipment in a residential area is likely to cause harmful interference, in which case users will be required to correct the interference at their own expense.-

The following information is for FCC com pliance of Class B devices: The equipment described in this manual generates and may radiate radio-frequency energy. If it is not installed in accordance with Cisco’s installation instructions, it may cause interference with radio and television reception. This equipment has been tested and found t o comply with the limits for a Class B digital device in accordance with the specifications in part 15 of the FCC rules. These specifications are designed to provide reasonable protection against such interference in a residential installation. However, there is no guarantee that interference will not occur in a particular installation.

Modifying the equipment without Cisco’s written authorization may result in the equipment no longer complying with FCC requirements for Class A or Class B digital devices. In that event, your right to use the equipment may be limited by FCC regulations, and you may be required to correct any interference to radio or television communications at your own expense.

You can determine whether your equipment is causing interference by turning it off. If the interference stops, it was probably caused by the Cisco equipment or one of its peripheral devices. If the equipment causes interference to radio or television reception, try to correct the interference by using one or m ore of the following measures:

• Turn the television or radio antenna until the interference stops.

• Move the equipment to one side or the other of the television or radio.

• Move the equipment farther away from the television or radio.

• Plug the equipment into an outlet that is on a different circuit from the television or radio. (That is, make certain the equipment and the television or radio are on circuits controlled

by different circuit breakers or fuses.) Modifications to this product not authorized by Cisco Systems, Inc. could void the FCC approval and negate your authority to operate the product. The Cisco implementation of TCP header compression is an adaptat ion 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 INABILTY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

CCSP, the Cisco logo, and the Cisco Square Bridge logo are trademarks of Cisco Systems, Inc; Changing the Way We Work, Live, Play, and Learn is a service mark of Cisco Systems, Inc.; and Access Registrar, Aironet, ASIST, BPX, 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, Enterprise/Solver, EtherChannel, EtherFast, EtherSwitch, Fast Step, Follow Me Browsing, FormShare, GigaDrive, GigaStack, HomeLink, Internet Quotient, IOS, IP/TV, iQ Expertise, the iQ logo, iQ Net Readiness Scorecard, iQuick Study , LightStream, Linksys, MeetingPlace, MGX, Networking Academy, Network Registrar, Packet, PIX, ProConnect, RateMUX, ScriptShare, SlideCast, SMARTnet, StackWise, The Fastest Way to Increase Your Internet Quotie nt, and TransPath are registered trademarks of Cisco System s, Inc. and/or its affiliates in the United States and certain other countries.

All other trademarks mentioned in this document 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. (0609R)

Preface iii

Document Revision History iii Audience iii Organization iii Related Documentation iv Conventions iv Obtaining Documentation v

CONTENTS

World Wide Web v Documentation CD-ROM v Ordering Documentation v Documentation Feedback vi

Obtaining Technical Assistance vi

Cisco.com vi Technical Assistance Center vi

Overview 1-1

What are MRTG and RRDTool? 1-1

References 1-1

Components of SNMP RTM with MRTG and RRDTool 1-2

References 1-3

Pre-defined SCA BB Real-Time Monitoring Reports 1-3

Reports 1-4

SCA BB Real-Time Monitoring Setup 1-5

The RTM Directory 1-6

Getting Started 2-1

Using MRTG and RRDTool for Real-Time SNMP Monitoring 2-1 Web Server Configuration 2-2

Apache Web Server Configuration 2-2

Cisco SCA BB SNMP Real Time Monitoring User Guide

OL-12491-01 i

Contents

Using the SCA BB Real-Time Monitoring Configuration Utility 2-3 Installing the RTMCMD Utility and the RTM Report Templates 2-4

Installing the Java Runtime Environment 2-4

The Real-Time Monitoring Configuration Utility 3-1

The rtmcmd Utility 3-2

rtmcmd Utility Examples 3-3

The User Configuration File 3-3

rtmcmd User Configuration File Example 3-4 User Configuration File Format 3-4 Files and Directories 3-4 Installing the CFG and CGI Files for Use by MRTG and RRDTool 3-5

First Installation 3-5

Files Update 3-6

Troubleshooting 4-1

Error Message when Viewing a Report 4-1 Reports Missing Data 4-3

Cisco SCA BB SNMP Real Time Monitoring User Guide

ii OL-12491-01

Preface

This preface describes who should read the Cisco SCA BB SNMP Real-Time Monitoring User Guide, how it is organized, and its document conventions.

Document Revision History

Cisco Service Center Release Part Number Publication Date

Release 3.0.5 OL-12491-01 November, 2006

DESCRIPTION OF CHANGES

Created the Cisco SCA BB SNMP Real-Time Monitoring User Guide.

Audience

This guide is for experienced network administrators who are using Cisco Service Control and the SCA BB application to monitor and control their network.

Organization

The major sections of this guide are as follows:

Chapter Title Description

Chapter 1 Overview (on page 1-1) Provides an overview of MRTG and RRDTool, and

how they are used to monitor a Cisco Service Control network.

Chapter 2 Getting Started (on page 2-1) Explains the general procedure for real-time SNMP

monitoring and also the general procedure for using the Cisco SCA BB real-time monitoring configuration utility.

Chapter 3 The Real-Time Monitoring

Configuration Utility (on page

3-1)

Cisco SCA BB SNMP Real Time Monitoring User Guide

OL-12491-01 iii

Explains specific procedures for using the Cisco SCA BB real-time monitoring configuration utility, rtmcmd.

Conventions

This document uses the following conventions:

Convention Description boldface font Commands and keywords are in boldface.

italic font Arguments for which you supply values are in italics. [ ] Elements in square brackets are optional.

Presents error messages and possible causes of the error.

{x | y | z} Alternative keywords are grouped in braces and separated by

vertical bars.

[x | y | z] Optional alternative keywords are grouped in brackets and separated

by vertical bars.

string A nonquoted set of characters. Do not use quotation marks around

the string, or the string will include the quotation marks.

screen font

Terminal sessions and information that the system displays are in

screen font. boldface screen font Information you must enter is in boldface screen font. italic screen font Arguments for which you supply values are in italic screen

font. < > Nonprinting characters, such as passwords, are in angle brackets. [ ] Default responses to system prompts are in square brackets. !, # An exclamation point (!) or a pound sign (#) at the beginning of a

line of code indicates a comment line.

Note

Means reader take note. Notes contain helpful suggestions or references to materials not covered in this manual.

Cisco SCA BB SNMP Real Time Monitoring User Guide

iv OL-12491-01

Preface

Obtaining Documentation

The following sections provide sources for obtaining documentation from Cisco Systems.

World Wide Web

You can access the most current Cisco documentation on the World Wide Web at the following sites:

• http://www.cisco.com

• http://www-china.cisco.com

• http://www-europe.cisco.com

Documentation CD-ROM

Cisco documentation and additional literature are available in a CD-ROM package that ships with your product. The Documentation CD-ROM is updated monthly and may be more current than printed documentation. The CD-ROM package is available as a single unit or as an annual subscription.

Obtaining Documentation

Ordering Documentation

Cisco documentation is available in the following ways:

• Registered Cisco Direct Customers can order Cisco Product documentation from the

networking Products MarketPlace:

http://www.cisco.com/cgi-bin/order/order_root.pl

• Registered Cisco.com users can order the Documentation CD-ROM through the online

Subscription Store:

http://www.cisco.com/pcgi-bin/marketplace/welcome.pl

• Nonregistered Cisco.com users can order documentation through a local account

representative by calling Cisco corporate headquarters (California, USA) at 408 526-7208 or, in North America, by calling 800 553-NETS(6387).

Cisco SCA BB SNMP Real Time Monitoring User Guide

OL-12491-01 v

Obtaining Technical Assist ance

Documentation Feedback

If you are reading Cisco product documentation on the World Wide Web, you can submit technical comments electronically. Click Feedback in the toolbar and select Documentation. After you complete the form, click Submit to send it to Cisco.

You can e-mail your comments to bug-doc@cisco.com. To submit your comments by mail, use the response card behind the front cover of your

document, or write to the following address: Attn Document Resource Connection

Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-9883

We appreciate your comments.

Obtaining T echnical Assistance

Cisco provides Cisco.com (on page vi) as a starting point for all technical assistance. Customers and partners can obtain documentation, troubleshooting tips, and sample configurations from online tools. For Cisco.com registered users, additional troubleshooting tools are available from the TAC website.

Preface

Cisco.com

Cisco.com is the foundation of a suite of interactive, networked services that provides immediate, open access to Cisco information and resources at any time, from anywhere in the world. This highly integrated Internet application is a powerful, easy-to-use tool for doing business with Cisco.

Cisco.com provides a broad range of features and services to help customers and partners streamline business processes and improve productivity. Through Cisco.com, you can find information about Cisco and our networking solutions, services, and programs. In addition, you can resolve technical issues with online technical support, download and test software packages, and order Cisco learning materials and merchandise. Valuable online skill assessment, training, and certification programs are also available.

Customers and partners can self-register on Cisco.com to obtain additional personalized information and services. Registered users can order products, check on the status of an order, access technical support, and view benefits specific to their relationships with Cisco.

To access Cisco.com, go to http://www.cisco.com.

T echnical Assistance Center

The Cisco Technical Assistance Center (TAC) website is available to all customers who need technical assistance with a Cisco product or technology that is under warranty or covered by a maintenance contract.

Cisco SCA BB SNMP Real Time Monitoring User Guide

vi OL-12491-01

Preface

Obtaining Technical Assistance

Contacting TAC by Using the Cisco TAC Website

If you have a priority level 3 (P3) or priority level 4 (P4) problem, contact TAC by going to the TAC website http://www.cisco.com/tac.

P3 and P4 level problems are defined as follows:

• P3—Your network is degraded. Network functionality is noticeably impaired, but most

business operations continue.

• P4—You need information or assistance on Cisco product capabilities, product installation, or

basic product configuration. In each of the above cases, use the Cisco TAC website to quickly find answers to your questions. To register for Cisco.com (on page vi), go to http://tools.cisco.com/RPF/register/register.do. If you cannot resolve your technical issue by using the TAC online resources, Cisco.com

registered users can open a case online by using the TAC Case Open tool at

http://www.cisco.com/tac/caseopen.

Contacting TAC by Telephone

If you have a priority level 1 (P1) or priority level 2 (P2) problem, contact TAC by telephone and immediately open a case. To obtain a directory of toll-free numbers for your country, go to

http://www.cisco.com/warp/public/687/Directory/DirTAC.shtml.

P1 and P2 level problems are defined as follows:

• P1—Your production network is down, causing a critical impact to business operations if

service is not restored quickly. No workaround is available.

• P2—Your production network is severely degraded, affecting significant aspects of your

business operations. No workaround is available.

Cisco SCA BB SNMP Real Time Monitoring User Guide

OL-12491-01 vii

+ 21 hidden pages