Table of Contents

Cisco Broadband Troubleshooter Users' Guide

Cisco Broadband Troubleshooter Users' Guide

This document contains the following sections:

Overview of the Cisco Broadband Troubleshooter

Cisco Broadband Troubleshooter (Cisco BT) 1.0 is a GUI-based application that manages point-to-multipoint networks. Cisco BT enables you to quickly isolate provisioning problems and characterize upstream and downstream trouble patterns.

Cisco BT is a standalone application that runs on the Solaris workstation and has the following features:

System Requirements for Solaris Workstations

Enabling SNMP on the Router

Note   To be SNMP-enabled, make sure that the Cisco uBR7200 series router is running a Cisco IOS Release 11.3(X)NA or a later release.

Tip Use SNMP to read the Cisco IOS release, router name, and type of router. You can retrieve broadband modem device information by using the command-line interface (CLI) commands over Telnet sessions to the Cisco uBR7200 series router.

Step 1   To enable Simple Network Management Protocol (SNMP) on the router, enter:

Router(config)# snmp-server community public RW

Step 2   Enable the password:

Router(config)# enable password <password>

Step 3   To configure the line password to enable Telnet, enter:

Router(config)# line vty 0 4 Router(config)# password <password>

Step 4   To configure the session timeout for all vty lines (because Telnet is used to communicate with the router), enter:

Router(config)# line vty 0 4 Router(config-line)# session-timeout 10

Installing Cisco BT on a Solaris Workstation

Note   Before installing Cisco BT, be sure to check the Readme file for additional information.

Step 1   Insert the Cisco Broadband Troubleshooter CD-ROM into the CD-ROM drive.

Step 2   Extract the files from the CD-ROM. Enter:

cp /cdrom/cdrom0/fla.tar /cbt

cd /cbt

tar xvf fla.tar

Step 3   Set up file permissions by using these commands:

chmod +x FlapListAnalyzerSetup.unix


Step 4   To start the application, enter:


Uninstalling Cisco BT

Step 1   Exit Cisco BT.

Step 2   Remove or delete the files that you have installed.

About Getting Started with Cisco BT

An Administrator can perform the following tasks:

Users cannot add or delete routers, perform administrative tasks, or modify application settings.

To use Cisco BT, follow these procedures:

Setting Up a User

Note   Only an administrator can perform this procedure.

To set up a user as the root administrator who can add users and manage devices, perform the following steps:

Step 1   Log in as admin with the default password, changeme.

Step 2   To change the password, click Task>User List.

Step 3   For additional users, click Task>User List to create a list that contains all valid end users who can access Cisco BT application.

Step 4   Enter the following user data:

Setting Up a Router

Note   Only an administrator can perform this procedure.

To add or delete the Cisco uBR7200 series routers that you want to manage, perform the following steps:

Note   To successfully manage routers, make sure that you enter the correct router passwords and enable SNMP on these routers. For routers authenticated by authentication, authorization and accounting (AAA) servers, click the User Name and User Password field for more information.

Step 1   To create a router list, choose Task>UBR List.

Step 2   Enter the IP address.

Step 3   Enter the SNMP read community strings configured on the router in the Community String (Read) filed. The default value is public. Verify that access lists, if configured in the router, allow for SNMP read access from your workstation.

Step 4   Enter the Domain Name System (DNS) name of the router. If the DNS name is not available, the IP address appears.

Step 5   (Optional) If you have configured a username on the router, enter the vty username .

Note   If login local is the authentication method on the router's vty lines, then you can find the username by entering the router's show config command. For AAA server authentication, enter your TACACS account name.

Step 6   Enter the same user password as configured on the router.

For AAA server authentication, enter your TACACS password.

Step 7   Enter the same line password as the router if the router has a password configured on its vty lines.

This is the case when both the login name and a password are in the router configuration file under an entry such as line vty 0 4. Routers with no line passwords cannot be managed by Cisco BT.

Step 8   Enter enable password <password> or enable secret <password> as set up on the router.

Tip You cannot manage the routers with no enable passwords with Cisco BT.

Note   You cannot edit the IOS Version column, which indicates the Cisco IOS software image that is running on the router; the router type column, which indicates the model of the Cisco uBR7200 series router.

About Troubleshooting Broadband Modems

You can perform the following troubleshooting tasks with Cisco BT:

The Flap-list Analysis screen shows the output of the following data for modems with a total online time of more than 60 seconds:

Global Summary Report

This is a global summary report for each upstream port for each line card in the selected Cisco uBR7200 series router. The following data appears for each upstream port:

Problem Categories for Flapping Modems

Cisco BT shows flapping modems in the following four problem categories on the Flap List Analysis screen:

Note   The categories are not exclusive, so one modem can appear in multiple lists.

You can also view account information for a modem by clicking on LDAP information.

Refreshing the Information on the Screen

Note   If the flaplist analysis does not show any flapping modems, but the modems appear as part of the show cable flap list command on the router, then click Apply to obtain the Cisco IOS release information.

Step 1   To perform a new capture of the flap list and modem data and to analyze the new data, click Capture and Analyze Flap List.

Step 2   Click Save to save the current set of captured data from the selected Cisco uBR7200 series router.

The save operation generates two files: flaplist.ip address of router and analysis.ip address of router.

About Viewing Flap-list Details

You can view the raw output captured from the selected Cisco uBR7200 series router. Use this data to check on the various operating parameters, state, and flap counters reported by the router for each broadband modem on the Flap-list Details screen.

show cable modem—Includes the total number of modems reported from the router, followed by the actual output from the router in a tabular format.

For each broadband modem, you can view the following data on the router:

show radio flap-list—Total number of modems reported from the router followed by the actual output from the router in a tabular format.

For each broadband modem, you can view the following data on the router:

Configuring Information on LDAP

With Cisco BT, you can link broadband modem device information with subscriber information stored in an LDAP directory.

The LDAP server typically contains subscriber-specific information that is used when provisioning broadband modems. Cisco BT links the collected device information with the subscriber information by using the LDAP interface.

Note   Before accessing the provisioning database and displaying LDAP information, you must configure the LDAP server information using the LDAP Access screen from the Task menu.

Step 1   Choose Task>LDAP Access.

Step 2   Enter the LDAP server name you want Cisco BT to use for retrieving LDAP information.

Step 3   Enter the LDAP server port number of the LDAP server.

Step 4   Enter the LDAP parent name; for example,

Step 5   Enter an LDAP username if the LDAP server supports the anonymous user; for example, uid=admin, ou=Administrators, ou=TopologyManagement, o=NetscapeRoot.

Step 6   (Optional) Enter the LDAP user password if the LDAP server supports the anonymous user.

Step 7   Click Apply to validate the LDAP parameters.

If the parameters are valid, the parameters are saved.

Viewing LDAP Information

Step 1   To view LDAP information, go to the Flap List Analysis screen.

Step 2   Select a flapping modem.

Step 3   Click Display LDAP Information.

The LDAP Information window appears.

Note   If the LDAP information is stored in two nodes under the same LDAP parent, (for example, "ou=leases," and "ou=modems,"), the attributes or values from both the nodes are combined.

Step 4   Click OK.

About Saving and Loading Data

With Cisco BT you can save the current data to time-stamped files, so that you can access and analyze the data. You can also load the previously saved data when necessary.

The following files appear after you save and load the data:

The flaplist.ip address of router File

This file contains the output from the Cisco IOS commands used for the flap list analysis.

When you click Save, the appropriate file for the selected Cisco uBR7200 series router are added to the following sections of information. All these sections are delimited by the ^ character:

The analysis.ip address File

This file contains the output from the flap-list analysis report. When you click Save, the analysis.ip address of router file for the selected Cisco uBR7200 series router is added to the following sections of information:

Each upstream analysis and problem category detail section is preceded by { and followed by }. The various sections are delimited by a new line.

This file is not used by Cisco BT to restore the flap list analysis reports. This file is for reference only.

Saving and Loading Data

With Cisco BT you can save the current data to time-stamped files, so that you can access and analyze the data. You can also load the previously saved data when necessary.

Step 1   To save the current data to a file in the installed directory as tab-delimited ASCII files, click Save Analysis.

The output files are flaplist.ip address of router and analysis.ip address of router.

Step 2   (Optional) To load a previously saved file, click Load Analysis .

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:

Documentation CD-ROM

Cisco documentation and additional literature are available in a CD-ROM package, which 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.

Ordering Documentation

Cisco documentation is available in the following ways:

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

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 Technical Assistance

Cisco provides as a starting point for all technical assistance. Customers and partners can obtain documentation, troubleshooting tips, and sample configurations from online tools. For registered users, additional troubleshooting tools are available from the TAC website. is the foundation of a suite of interactive, networked services that provides immediate, open access to Cisco information and resources at anytime, from anywhere in the world. This highly integrated Internet application is a powerful, easy-to-use tool for doing business with Cisco. provides a broad range of features and services to help customers and partners streamline business processes and improve productivity. Through, 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 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, go to the following website:

Technical Assistance Center

The Cisco 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.

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:

P3 and P4 level problems are defined as follows:

In each of the above cases, use the Cisco TAC website to quickly find answers to your questions.

To register for, go to the following website:

If you cannot resolve your technical issue by using the TAC online resources, registered users can open a case online by using the TAC Case Open tool at the following website:

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 the following website:

P1 and P2 level problems are defined as follows:

This document is to be used in conjunction with the Cisco Wireless Manager 1.0 Users' Guide, CiscoView Wireless Quick Reference Guide and Overview of Cisco Wireless Network Management Suite 1.0 publications.

AtmDirector, Browse with Me, CCDA, CCDE, CCDP, CCIE, CCNA, CCNP, CCSI, CD-PAC, CiscoLink, the Cisco NetWorks logo, the Cisco Powered Network logo, Cisco Systems Networking Academy, the Cisco Systems Networking Academy logo, Fast Step, Follow Me Browsing, FormShare, FrameShare, GigaStack, IGX, Internet Quotient, IP/VC, iQ Breakthrough, iQ Expertise, iQ FastTrack, the iQ Logo, iQ Net Readiness Scorecard, MGX, the Networkers logo, Packet, PIX, RateMUX, ScriptBuilder, ScriptShare, SlideCast, SMARTnet, TransPath, Voice LAN, Wavelength Router, WebViewer are trademarks of Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn, Empowering the Internet Generation, are service marks of Cisco Systems, Inc.; and Aironet, ASIST, BPX, Catalyst, Cisco, the Cisco Certified Internetwork Expert logo,
Cisco IOS, the Cisco IOS logo, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Enterprise/Solver, EtherChannel, EtherSwitch, FastHub, FastSwitch, IOS, IP/TV, LightStream, Network Registrar, Post-Routing, Pre-Routing, Registrar, StrataView Plus, Stratm, SwitchProbe, TeleRouter, and VCO are registered trademarks of Cisco Systems, Inc. or its affiliates in the U.S. and certain other countries.

All other brands, names, or trademarks mentioned in this document or Web site 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. (0011R)

Copyright © 2001, Cisco Systems, Inc.
All rights reserved.

Posted: Sat Sep 28 01:01:37 PDT 2002
All contents are Copyright © 1992--2002 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.