Summary of the content on the page No. 1
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
Summary of the content on the page No. 2
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 I
Summary of the content on the page No. 3
CONTENTS Preface iii Document Revision History iii Audience iii Organization iii Related Documentation iv Conventions iv Obtaining Documentation v 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 Monitor
Summary of the content on the page No. 4
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
Summary of the content on the page No. 5
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 appli
Summary of the content on the page No. 6
Preface Related Documentation Presents error messages and possible causes of the Chapter 4 Troubleshooting (on page 4-1) error. Related Documentation The following publications are available for the Cisco Service Control Application for Broadband: Cisco Service Control Application for Broadband User Guide Cisco Service Control Application for Broadband Reference Guide Cisco Service Control Application for Broadband Service Configuration API Programmer Guide Conventions This do
Summary of the content on the page No. 7
Preface Obtaining Documentation 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 Documenta
Summary of the content on the page No. 8
Preface Obtaining Technical Assistance 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
Summary of the content on the page No. 9
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 p
Summary of the content on the page No. 10
Summary of the content on the page No. 11
CHAPTER 1 Overview SNMP-based monitoring tools, such as MRTG, allow network administrators to monitor the activity and health of network devices in real time. Cisco SCA BB includes an SNMP-based real- time monitoring solution, which is implemented using MRTG and a Round Robin Database (RRDTool). The SCA BB Real-Time Monitoring Configuration Utility (rtmcmd) is a command-line utility (CLU) for automating the production of the files required by the MRTG tool. This chapter contains the fol
Summary of the content on the page No. 12
Chapter 1 Overview Components of SNMP RTM with MRTG and RRDTool Components of SNMP RTM with MRTG and RRDTool Following are the components of an MRTG / RRDTool monitoring system: • MRTG is a script that collects SNMP data from monitored devices. It monitors SNMP network devices and stores the retrieved data in a database. It is written in Perl and works on Unix/Linux and Windows. MRTG is free software licensed under the Gnu GPL. It requires the following: • Perl • RRDTool to per
Summary of the content on the page No. 13
Chapter 1 Overview Pre-defined SCA BB Real-Time Monitoring Reports References Refer to the following links for RTM software components documentation and download: • PyCron (for windows setups): http://www.kalab.com/freeware/pycron/pycron.htm • ActivePerl (for running MRTG): http://www.activestate.com/Products/ActivePerl/ • Apache Web-Server: http://httpd.apache.org/download.cgi Pre-defined SCA BB Real-Time Monitoring Reports MRTG and RRDTool each require configuration files cont
Summary of the content on the page No. 14
Chapter 1 Overview Pre-defined SCA BB Real-Time Monitoring Reports 15 Subscriber Counters 16 RDR Counters 17 Downstream Bandwidth per TX Queue 18 Upstream Bandwidth per TX Queue Reports Note the following general information regarding charts: • Each report is actually made of the following four charts, representing different time scales. These charts are based on the round robin archives for each SNMP counter (the archives are created by MRTG). • Daily (5-minute average) •
Summary of the content on the page No. 15
Chapter 1 Overview SCA BB Real-Time Monitoring Setup The following diagram shows a report example. Figure 1 -2: Sample Graph SCA BB Real-Time Monitoring Setup An RTM setup requires the installation of the components described in Components of SNMP RTM with MRTG and RRDTool (on page 1-2) and can be set up on either Windows or Unix/Linux servers. The Getting Started (on page 2-1) section provides a step by step description how to set up a SCA BB RTM system. SCA BB RTM system r
Summary of the content on the page No. 16
Chapter 1 Overview SCA BB Real-Time Monitoring Setup The RTM Directory To view a report, RTM users browse to a URL mapped to a designated directory on their web server. This designated directory is referred to as the RTM directory. Users are required to create the RTM directory under the web server web documents directory tree; for example, when using an Apache web server on a Windows system, the RTM directory might be located at C:/PROGRA~1/APACHE~1/Apache2.2/htdocs/rtm. Upon com
Summary of the content on the page No. 17
CHAPTER 2 Getting Started This chapter contains the following sections: • Using MRTG and RRDTool for Real-Time SNMP Monitoring 2-1 • Web Server Configuration 2-2 • Using the SCA BB Real-Time Monitoring Configuration Utility 2-3 • Installing the RTMCMD Utility and the RTM Report Templates 2-4 Using MRTG and RRDTool for Real-Time SNMP Monitoring To produce graphics to monitor your network in real time using MRTG and RRDTool, follow these general steps: Step 1 Install MRTG (requir
Summary of the content on the page No. 18
Chapter 2 Getting Started Web Server Configuration b) Select a report from the available reports listed on the left. The following figure is a screenshot taken after selecting an SCE device. This guide focuses on Step 5, creating the CFG and CGI files for MRTG and RRDTool. The SCA BB Real-Time Monitoring Configuration utility creates the necessary files from the specified PQB file or Service Configuration. The other steps in this process are explained in detail in the relevant
Summary of the content on the page No. 19
Chapter 2 Getting Started Using the SCA BB Real-Time Monitoring Configuration Utility /htdocs/"> Options Indexes FollowSymLinks ExecCGI AllowOverride Indexes Order allow,deny Allow from all • Restart the Apache Web Server Using the SCA BB Real-Time Monitoring Configuration Utility To use rtmcmd to produce the files for MRTG and RRDTood, follow this procedure: Step 1 If using rtmcmd for
Summary of the content on the page No. 20
Chapter 2 Getting Started Installing the RTMCMD Utility and the RTM Report Templates Step 5 Install these CFG and CGI files into your RTM setup (see Installing the CFG and CGI Files for Use by MRTG and RRD (on page 3-5)). Installing the RTMCMD Utility and the RTM Report Templates To install the SCA BB rtmcmd utility and RTM report templates, complete the following steps: Step 1 Locate the file scas_bb_util.tgz (located in the SCA BB distribution zip file), and copy it to a W
