Cisco NMS Guide
Cisco NMS Guide
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
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.
Access Registrar, AccessPath, Any to Any, Are You Ready, AtmDirector, Browse with Me, CCDA, CCDE, CCDP, CCIE, CCNA, CCNP, CCSI, CD-PAC,
the Cisco logo, Cisco Certified Internetwork Expert logo, CiscoLink, the Cisco Management Connection logo, the Cisco NetWorks logo, the Cisco Powered
Network logo, Cisco Systems Capital, the Cisco Systems Capital logo, Cisco Systems Networking Academy, the Cisco Systems Networking Academy
logo, the Cisco Technologies logo, Fast Step, FireRunner, Follow Me Browsing, FormShare, GigaStack, IGX, Intelligence in the Optical Core, Internet
Quotient, IP/VC, IQ Breakthrough, IQ Expertise, IQ FastTrack, IQ Readiness Scorecard, The IQ Logo, Kernel Proxy, MGX, Natural Network Viewer,
NetSonar, Network Registrar, the Networkers logo, Packet, PIX, Point and Click Internetworking, Policy Builder, Precept, RateMux, ReyMaster, ReyView,
ScriptShare, Secure Script, Shop with Me, SlideCast, SMARTnet, SVX, The Cell, TrafficDirector, TransPath, VlanDirector, Voice LAN, Wavelength
Router, Workgroup Director, and Workgroup Stack are trademarks; Changing the Way We Work, Live, Play, and Learn, Empowering the Internet
Generation, The Internet Economy, and The New Internet Economy are service marks; and Aironet, ASIST, BPX, Catalyst, Cisco, Cisco IOS, the Cisco
IOS logo, Cisco Systems, the Cisco Systems logo, the Cisco Systems Cisco Press logo, CollisionFree, Enterprise/Solver, EtherChannel, EtherSwitch,
FastHub, FastLink, FastPAD, FastSwitch, GeoTel, IOS, IP/TV, IPX, LightStream, LightSwitch, MICA, NetRanger, Post-Routing, Pre-Routing, Registrar,
StrataView Plus, Stratm, TeleRouter, and VCO are registered trademarks of Cisco Systems, Inc. or its affiliates in the U.S. 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. (0005R)
Preface vii
Purpose vii
Audience vii
Scope vii
Conventions viii
Acknowledgements xii
About SNMP 13
What is SNMPv1? 18
What is SNMPv2? 19
Network Topology 30
Hardware Requirements 31
Software Requirements 32
Enabling SNMP 42
About MRTG 53
Task 4Using Syslog, NTP, and Modem Call Records to Isolate and Troubleshoot Fault s 67
About Syslog 67
About NTP 69
Enabling Syslog and Modem Call Records in the Cisco IOS Software 74
Using the HPOV CLI to Enter a Device into the Database 115
INDEX
Purpose
This Internetworking Solutions Guide (ISG) describes how to implement and operate a dial network
management system (NMS) that provides management functions for a dial Internet access service
(DIAS).
Audience
This guide is intended for network engineers and operators who implement and operate dial NMS
systems.
This guide assumes that you have the following level of knowledge and experience:
An understanding of NMS protocols, such as Simple Network Management Protocol (SNMP),
Network Time Protocol (NTP), and syslog.
Hands-on experience working with Cisco routers, IOS technologies, and UNIX.
Success configuring a Cisco network access server (NAS) for basic IP modem services.
A Cisco Certified Network Associate (CCNA) certificate or equivalent level of experience.
Scope
This guide provides guidelines and a case study for:
Designing a dial NMS.
Collecting and using data-management streams to operate a dial access network.
Managing important connection events and alarms for statistical analysis.
Reporting on the performance of a DIAS.
Addressing the perception problems that are commonly associated with dial access networks.
This guide describes the following network protocols, functions, and NMS applications:
Protocols—SNMP and NTP.
Functions—Syslog, modem call records, Cisco IOS command-line interface (CLI),
Log File Rotator, Device Navigator, web-based management, and War Dialer.
NMS applications—UCD-SNMP, Multi Router Traffic Grapher (MRTG), HP OpenView (HPOV),
and CiscoWorks 2000 Resource Manager Essentials (CW2000 RME).
This guide does not provide the following information:
Descriptions about the basics of network management.
http://www.cisco.com/univercd/cc/td/doc/product/software/ios121/121cgcr/fun_c/index.htm
Windows NT-based management of Cisco routers.
http://www.cisco.com/univercd/cc/td/doc/product/rtrmgmt/index.htm
Detailed authentication, authorization, and accounting (AAA).
http://www.cisco.com/univercd/cc/td/doc/product/software/ios121/121cgcr/secur_c/index.htm
Basic access server configurations.
http://www.cisco.com/pcgi-bin/Support/PSP/index.pl?i=Products#Access_Products
Information about integrating high-end NMS systems in to a dial access environment.
http://www.cisco.com/univercd/cc/td/doc/cisintwk/intsolns/index.htm
Conventions
Convention Description
bold Command or keyword that you must enter.
italic File names, directory paths to files, user names, and arguments for which you supply
values.
[x] Optional keyword or argument that you enter.
{x | y | z} Required keyword or argument that you must enter.
[x {y | z}] Optional keyword or argument that you enter with a required keyword or argument.
string Set of characters that you enter. Do not use quotation marks around the character
string, or the string will include the quotation marks.
screen Information that appears on the screen.
^ or Ctrl Control key—for example, ^D means press the Control and the D keys
simultaneously.
< > Nonprinting characters, such as passwords.
! Comment line at the beginning of a line of code.
Caution Means reader be careful. In this situation, you might do something that could result in
equipment damage or loss.
Note Means reader take note. Notes contain helpful suggestions or reference to materials not
contained in this manual.
Timesaver Means the described action saves time. You can save time by performing the action
described in the paragraph.
Tips Means the information might help the reader solve a problem.
Freeware
Sunfreeware.com—A repository of freeware programs and news for Solaris.
http://www.sunfreeware.com./
The UCD-SNMP Home Page—Provides an overview of UCD-SNMP, links to the FTP site,
recent news, documentation, bug reports, mailing lists, and where to go for more information.
http://ucd-snmp.ucdavis.edu/
Multi Router Traffic Grapher (MRTG) Product Site—Provides an overview of MRTG, links to the
FTP site, documentation, frequently asked questions, mailing lists, and contact information.
http://ee-staff.ethz.ch/~oetiker/webtools/mrtg/mrtg.html
Managing Modems (Cisco IOS 12.1)—Describes configuration and troubleshooting tasks for dial
access environments.
http://www.cisco.com/univercd/cc/td/doc/product/software/ios121/121cgcr/dialts_c/dtsprt2/dcdm
odmg.htm
Modem Management Commands (Cisco IOS 12.1 and 12.0)—Provides two lists of Cisco IOS
modem commands used for configuring and troubleshooting modems.
http://www.cisco.com/univercd/cc/td/doc/product/software/ios121/121cgcr/dial_r/drdshom.htm
http://www.cisco.com/univercd/cc/td/doc/product/software/ios120/12cgcr/dial_r/drprt1/drmodmgt
.htm
CiscoWorks 2000 Documentation Set—A collection of configuration guides and reference manuals.
http://www.cisco.com/univercd/cc/td/doc/product/rtrmgmt/cw2000/index.htm
Note If you are a network administrator and need personal technical assistance with a Cisco
product that is under warranty or covered by a maintenance contract, contact the Cisco
Technical Assistance Center (TAC) at 800 553-2447, 408 526-7209, or [email protected]. To
obtain general information about Cisco Systems, Cisco products, or upgrades, contact 800
553-6387, 408 526-7208, or [email protected].
Documentation CD-ROM
Cisco documentation and additional literature are available in a CD-ROM package that ships with your
product. The Documentation CD-ROM, a member of the Cisco Connection Family, is updated monthly.
Therefore, it might be more current than printed documentation. To order additional copies of the
Documentation CD-ROM, contact your local sales representative or call customer service. The
CD-ROM package is available as a single package or as an annual subscription.
You can also access Cisco documentation on the World Wide Web at http://www.cisco.com,
http://www-china.cisco.com, or http://www-europe.cisco.com.
Documentation Feedback
If you are reading Cisco product documentation on the World Wide Web, you can submit comments
electronically. Click Feedback in the toolbar and select Documentation. After you complete the form,
click Submit to send it to Cisco.
You can also submit feedback on Cisco documentation by sending an e-mail to [email protected] or
sending a fax to (408) 527-8089. We appreciate your comments.
Acknowledgements
This guide was created as a collaborative effort. The following Cisco team members participated:
David Anderson, Oscar Bauer, Robert Brown, Drew Cupp, Katie Creegan, Barry Raveendran Greene,
Jessica Janis, Andrew Kennedy, Jim Leonard, Robert Lewis, Lori Livingston, Greg McMillan,
Roger Moises, Rizwan Mushtaq, Anjali Puri, Annie Shi, David Simms, Jim Thompson,
Kris Thompson, Craig Tobias, Patrick Van Deynse, and Mario Villarreal.
About SNMP
The Simple Network Management Protocol (SNMP) is an application-layer protocol that facilitates the
exchange of management information between a network management system (NMS), agents, and
managed devices. SNMP uses the Transmission Control Protocol/Internet Protocol (TCP/IP) protocol
suite.
There are three versions of SNMP:
SNMP Version 1 (SNMPv1)—The initial implementation of the SNMP protocol, which is
described in RFC 1157 (http://www.ietf.org/rfc/rfc1157).
SNMP Version 2 (SNMPv2)—An improved version of SNMPv1 that includes additional protocol
operations. For the SNMPv2 Structure of Management Information (SMI), see RFC 1902
(http://www.ietf.org/rfc/rfc1902).
SNMP Version 3 (SNMPv3)—SNMPv3 has yet to be standardized.
The case study in this guide describes how to create a dial NMS environment. To successfully manage
the environment, you must be familiar with the SNMP feature set. The following NMS applications use
SNMP to help manage the network devices in the case study:
UCD-SNMP
Multi-Router Traffic Grapher (MRTG)
HP OpenView (HPOV)
Cisco Works 2000 Resource Manager Essentials (CW2000 RME)
Figure 1 illustrates the relationship between the managed devices, the agent, and the NMS.
Management
Entity
NMS
35640
Managed Devices
Figure 2 SNMP Event Interactions Between the NMS and the Agent
Get request
Response
Get next
NMS
Response initiated
Get next
Response
NMS
26095
Agent
(Cisco IOS device)
…
dod (6)
…
internet (1)
directory (1) mgmt (2) experimental (3) private (4) security (5) snmpV2 (6)
… … … … cisco (9) …
… … temporary … … …
variables (3)
DECnet (1) XNS (2) Apple Talk (3) Novell (3) VINES (4) Chassis (5)
… … … … …
… … atInput (1) … … …
atLocal (2)
atBcastin (3)
atForward (4)
24187
…
As shown in Figure 3, top-level MIB object IDs belong to different standards organizations while
low-level object IDs are allocated by associated organizations. Vendors define private branches that
include managed objects for products. Non standard MIBs are typically in the experimental branch.
A managed object has these unique identities:
The object name—For example, iso.identified-organization.dod.internet.private.enterprise.cisco.
temporary variables.AppleTalk.atInput
or
The equivalent object descriptor—For example, 1.3.6.1.4.1.9.3.3.1.
SNMP must account for and adjust to incompatibilities between managed devices. Different computers
use different data-representation techniques, which can compromise the ability of SNMP to exchange
information between managed devices.
What is SNMPv1?
SNMPv1 is the initial implementation of the SNMP protocol and is described in RFC 1157
(http://www.ietf.org/rfc/rfc1157).
SNMPv1:
Functions within the specifications of the Structure of Management Information (SMI).
Operates over protocols such as User Datagram Protocol (UDP), Internet Protocol (IP), OSI
Connectionless Network Service (CLNS), AppleTalk Datagram-Delivery Protocol (DDP),
and Novell Internet Packet Exchange (IPX).
Is the de facto network-management protocol in the Internet community.
The SMI defines the rules for describing management information by using Abstract Syntax Notation
One (ASN.1). The SNMPv1 SMI is defined in RFC 1155 (http://www.ietf.org/rfc/rfc1155). The SMI
makes three specifications:
ASN.1 data types
SMI-specific data types
SNMP MIB tables
What is SNMPv2?
SNMPv2 is an improved version of SNMPv1. Originally, SNMPv2 was published as a set of proposed
Internet standards in 1993; currently, it is a Draft Standard. As with SNMPv1, SNMPv2 functions
within the specifications of the SMI. SNMPv2 offers many improvements to SNMPv1, including
additional protocol operations.
Note Because SNMP does not implement authentication, many vendors do not implement Set
operations, which reduce SNMP to a monitoring facility.
Firewall
Backbone
router
Remote modem
users
Firewall
38198
Backbone
POP #2 router
Internet
All remote modem users share a common pool of modem resources. Users can dial in to either POP.
The dial POPs are redundant. If one POP loses service, traffic is re-routed to the other POP.
Describing how traffic is re-routed is outside the scope of this case study, and the diagrams in the
case study show simplified IP paths only.
THEnet uses this model to identify the different functional areas of the dial NMS:
F = Fault management
C = Configuration management
A = Accounting management
P = Performance management
S = Security management
A dial NMS provides the FCAPS management functions for a DIAS.
THEnet
Network Design Questions Answers
What types of services does your network provide? Dial Internet access services
(V.90 analog modem services)
How many dial POP sites are you managing? Two sites in Austin, Texas
What types of network services will the DIAS support? Residential subscriber
(Network management is based on customer requirements.) services
Corporate-outsourcing
services
What is the user-growth projection for the next 5 years? 3 months—50,000 users
3 months = Current deployment requirement. 1 year—100,000 users
1 year = Current design plan requirement. 5 years—1 million users
5 years = Future scalability plan requirement.
What is the user-to-line ratio during busy hours? 10:1
What level of service must you guarantee to your customers? Guaranteed up time
Do you have redundant connections to the Internet? Yes
Do you have redundant connections to the NOC? Yes
What existing servers do you have available in the NOC? SNMP management server
Syslog server
AAA server
Database server
What SNMP framework management system do you want to HP OpenView (HPOV)
use?
What element management system do you use for collecting and CiscoWorks 2000 Resource
managing syslog? Manager Essentials
(CW2000 RME)
Do you have a preferred platform and operating system for Yes
monitoring the network?
Sun Sparc, Solaris 2.6
What type of network access servers will you use? Cisco AS5800s
Do you have a staff of UNIX experts? Yes
THEnet
Network Design Questions Answers
Do you provide reports for any service level commitments with Yes
your customers? If yes, what management systems will you use?
Multi Router Traffic Grapher
(MRTG)
Custom-based AAA
accounting tools and database
query tools
Identify the types of users who require network management Network managers
reports. Network operators
Network engineers
Help desk operators
Corporations who outsource
their dial-up service
End users
What types of reports do you provide? Periodic performance reports
Billing reports
Security reports
Router operations reports
High-priority syslog reports
What format do the managers want to view the reports in? HTML web pages and
online graphs
Who will monitor the management systems? The network operations staff
How will network operators be notified of network problems? By sending e-mail to their pagers
For fault and performance management purposes, do you need to Yes
provide call detail records? Disconnect cause codes and retrain
counters must be inspected.
What security protocols do you use for authentication, RADIUS for the remote
authorization, and accounting (AAA)? modem users
TACACS+ for the router
administrators in the NOC
What dial NMS freeware do you plan to use? MRTG, UCD-SNMP, Linux, and
Apache
What software tools do you plan to develop internally? Log File Rotator
Device Navigator
Modem Call Record Viewer
Web-based management
War Dialer for performance
testing (optional)
Do you plan to build and maintain customized scripts? Yes
FCAPS
Function Service Requirements and Ways to Collect Management Data
Fault SNMP—Use UCD-SNMP and HPOV to explore the SNMP Management
management Information Bases (MIBs) and create the SNMP framework for the
dial NMS.
The Cisco IOS command-line interface (CLI)—Troubleshoot network
connectivity problems by collecting robust network statistics.
For example, use the following commands:
` show controller t1
` show isdn status
` debug ppp negotiation
` show isdn service
` debug ppp error
` debug isdn events
` debug isdn q921
` debug isdn q931
Syslog—Troubleshoot and isolate faults in the network by collecting
syslog data and modem call records. Important syslog messages will be
e-mailed daily to the operations staff.
Log file management—Collect and archive syslog data from network
access servers.
Web-based management—Navigate devices and enable HTTP access to
the CLI.
AAA—Collect accounting disconnect cause codes and view authentication
and authorization failures.
FCAPS
Function Service Requirements and Ways to Collect Management Data
Configuration SNMP—Use CW2000 RME to archive configuration files, manage
management Cisco IOS images, determine how much memory is installed, and discover
which boot ROMs are present.
CLI—Inspect and modify Cisco IOS configuration files and images.
For example, use the following commands:
` show version
` show running
` show modem version
AAA authentication—Control access to the routers.
AAA authorization—Limit CLI command access to router administrators
on a per group basis. Authorization is also used for limiting network
service assignments, such as static IP addresses and access lists.
AAA accounting—Monitor which configuration changes are made to the
routers and identify who is making the changes. Authenticated usernames
also appear in syslog.
Effective IP address management—Manage all assigned IP subnets by
using a DNS server and the application Cisco Network Registrar.
Web-based management—Navigate devices and enable HTTP access to
the CLI.
Accounting Send accounting information to a database that is accessible by Standard
management Query Language (SQL). Archive user-accounting data for billing and
auditing purposes.
Syslog—Collect basic accounting information by using modem call
records.
CLI—Collect accounting statistics. For example, use the following
commands:
` show interface accounting
` show isdn history
` show controller t1 call-counters
` show modem log
` show modem summary
` show modem call-stats
FCAPS
Function Service Requirements and Ways to Collect Management Data
Performance SNMP—For the initial installation, use MRTG to monitor key Object
management Identifications (OIDs) in the device MIBs. In the future, use commercial
software applications that collect mass scale management data streams for
large numbers of access servers.
CLI—Monitor the performance of the access servers. For example, use the
following commands:
` show modem operational-status
` show modem connect-speeds
` show modem summary
` show modem call-stats
Web-based management—Navigate devices and enable HTTP access to
the CLI.
War Dialer—Test remote client PCs by using a free client simulator.
Security Authenticate, authorize, and account for dial access clients (modem users)
management in each POP by using RADIUS.
Authenticate, authorize, and account for router administrators in the NOC
by using TACACS+.
Review the AAA service security logs.
Review the AAA server database by using SQL queries.
CLI—Inspect security information. For example, use the following
commands:
` show snmp group
` show access-lists
` show location
` show tacacs
` show radius statistics
` show logging
Web-based management—Navigate devices and enable HTTP access to
the CLI.
Network Topology
Based on the dial NMS service definition in Table 3, the network engineers at THEnet defined
the network topology for the POPs and NOC.
NOC
Firewall
Backbone
router
Cisco AS5800
access servers
Intranet
WAN
Backbone
router
Cisco 2511
OOB console server
AAA server
38197
(for remote client users)
Data Control
An intranet WAN connects the two POPs together and routes traffic to the Internet. The NOC collects
management data from both POPs.
Cisco PIX
firewall
HP OpenView UCD-SNMP
CW 2000 MRTG
38199
AAA
An important design issue to consider is where to send syslog data. If syslog data is sent back to a
central site NOC, the syslog data must travel across WAN links. Estimate and monitor how much syslog
data is generated by each POP and the impact on the WAN links. Modem call records can add a
significant amount of traffic to syslog data.
In this case study, THEnet initially sends syslog data across WAN links to the NOC. The WAN links are
designed to support a large network capacity in a metropolitan area. Collecting syslog locally in each
POP is a future design consideration.
Hardware Requirements
To design the dial NMS for the two POPs and the NOC, the network engineers at THEnet defined these
hardware requirements:
Hardware Purpose
4 Cisco AS5800 Two access servers in each POP to provide access in to the Internet from the
access servers PSTN. Cisco IOS Release 12.0(7)T is installed in each access server.
2 backbone Enables management data streams to enter the NOC.
gateways Routes traffic to the intranet WAN and the Internet.
2 Cisco 2511 OOB Accesses the console ports in the Cisco AS5800s by using out-of-band (OOB)
console servers management lines.
3 AAA servers One server in each POP to authenticate, authorize, and account for dial access
clients by using RADIUS.
One server in the NOC to authenticate, authorize, and account for router
administrators by using TACACS+.
1 Cisco PIX firewall Protects the NOC by filtering the devices that can access management services,
such as TACACS+, RADIUS, syslog, and SNMP.
3 Sun Ultra 10 Operates the dial NMS inside the NOC. Solaris version 2.6 is used.
workstations
The following capacity-planning calculations were made to determine the number of required lines and
Cisco AS5800s for the next five years.
Basic parameters:
There are 23 available bearer channels per PRI line
There are 28 PRI lines per T3 card (644 channels)
Each Cisco AS5800 has two T3 cards
There are 1288 available bearer channels per dual T3 Cisco AS5800
These calculations in Table 5 are based on a PRI system integration—not a system signalling 7 (SS7)
integration.
For each POP site, also plan for the following elements:
Power, space, and cooling for each Cisco AS5800
Required number of AAA servers
Required number of Cisco 2511s (OOB ports)
WAN link capacity
Software Requirements
To design the dial NMS inside the NOC, the network engineers at THEnet identified these software and
management system requirements:
POP #1 NOC
Access
172.21.0.0/16
Firewall
Device ID
IP pool
PSTN Intranet
Modems WAN
Clients
POP #2 Access
172.22.0.0/16
Firewall
35229
Device ID
IP pool
Internet
Caution Do not use “public” or “private” strings, which are well known in the industry, are
common hardware defaults, and invite attacks from hackers—regardless if you use filters.
To maximize security, choose community strings that are not associated with your
personal life or company.
The information in Table 9 is posted and maintained on web-based management pages. Easy access to
this information reduces network downtime.
The examples in this document are taken from a Sun Microsystems workstation running Solarus 2.6.
Some commands and filenames may vary slightly on other Unix systems, such as Linux and HP UX.
This section describes the MIBs and OIDs used to manage the dial Internet access service in the
case study.
See the following tables and choose the variables you want to use in your network. Explore the OIDs
and determine whether to poll and graph the results on a regular basis.
To explore the MIBs and OIDs, use UCD-SNMP. For more information, see the
“Task 2— Exploring SNMP Capabilities by Using UCD-SNMP” section on page 45.
To graph the trending statistics for a specific OID, use Multi Router Traffic Grapher (MRTG).
For more information, see the “Task 3—Using MRTG to Monitor and Graph Traffic Loads” section
on page 53.
Caution Be cautious when polling network elements. Polling OIDs that retrieve large amounts of
data can cause CPU problems on a Cisco IOS device. For example, do not get the ARP
table, walk large portions of a MIB tree, poll the wrong OID too frequently, or get statistics
that have an entry for every interface. For example, a Cisco 7200 may have 10 interfaces;
whereas, a Cisco AS5800 may have 3,000 interfaces.
For more information about other NMS enhancements for dial, see Call Tracker plus ISDN and
AAA Enhancements for the Cisco AS5300 and Cisco AS5800 at
http://www.cisco.com/univercd/cc/td/doc/product/software/ios121/121newft/121limit/121x/121xh
/121xh_2/dt_cltrk.htm
Note To protect a network access server from over polling, use the SNMP get bulk feature.
It’s available in SNMP v2 in CISCO-BULK-FILE-MIB.
Table 11 and Table 12 identify useful OIDs and variables within selected MIBs from Table 10.
Equivalent Cisco IOS commands are shown wherever applicable. Sometimes data is more clearly
inspected by using OIDs and a graphing tool instead of CLI commands.
To see the complete structure of the CISCO-POP-MGMT-MIB and CISCO-MODEM-MGMT-MIB,
go to the following URLs:
CISCO-POP-MGMT-MIB
http://www.cisco.com/univercd/cc/td/doc/cisintwk/intsolns/dialnms/popmgt.txt
CISCO-MODEM-MGMT-MIB
http://www.cisco.com/univercd/cc/td/doc/cisintwk/intsolns/dialnms/modemmgt.txt
Caution Avoid using well-known community strings, such as “public,” “private,” or “cisco.”
These strings are easily guessed and leave your device open to malicious attacks or
inadvertent access. To further enhance SNMP security, apply access lists to the community
strings.
Enabling SNMP
To enable SNMP on a Cisco IOS device in the network, follow these steps.
Note In some software releases, the commands snmp-server engineID local and
snmp-server packetsize are enabled by default.
Step 1 To use Loopback0 for device management and set SNMP traps to use that IP address, enter the
following commands. This configuration also eliminates the need to change IP addresses if a different
interface is used to send traps.
!
interface Loopback0
ip address 172.21.10.1 255.255.255.255
!
!
snmp-server trap-source Loopback0
!
Step 2 To enable a basic SNMP configuration, enter the following commands. See Table 13 for descriptions of
each command.
snmp-server community 5urf5h0p RO
snmp-server community 5crapmeta1 RW
snmp-server location Lake Travis (Austin) Dial POP
snmp-server contact [email protected]
snmp-server enable traps
snmp host 172.23.10.1 traps SNMPv1
Command Purpose
snmp-server community 5urf5h0p RO Assigns a read only (RO) community string. Only get
requests (queries) can be performed.
The RO community string in this example (5urf5h0p)
allows Get requests but no Set operations. The NMS and the
managed device must reference the same community string.
snmp-server community 5crapmeta1 RW Assigns a read write (RW) community string. SNMP
applications require RW access for Set operations.
The RW community string in this example (5crapmeta1)
enables write access to OID values. For example, you can
shut down an interface, download a configuration file, or
change a password.
snmp-server location Lake Travis Specifies the location of the device for administrative
(Austin) Dial POP purposes.
snmp-server contact admin Specifies a contact name to notify whenever a MIB problem
[email protected] occurs.
Command Purpose
snmp-server enable traps Enables traps for unsolicited notifications for configuration
changes, environmental variables, and critical device
conditions.
This command enables 14+ other commands for distinct
types of SNMP traps. Edit this command list to include only
the traps that are used by your network environment.
snmp host 172.23.10.1 traps SNMPv1 Identifies the host destination for the traps. Traps are sent in
the SNMP v1 format in this case study.
Step 1 Go to http://ucd-snmp.ucdavis.edu
Step 2 Download, compile, and install UCD-SNMP. In this case study, the UCD-SNMP commands are
installed in the /usr/local/bin directory.
Step 3 From the Cisco FTP site, download the MIBs into the /usr/local/share/snmp/mibs directory on your
Solaris workstation. By using the following Unix commands, you can copy the entire bundled v1 MIB
tar file from ftp.cisco.com.
cd /usr/local/share/snmp/mibs
ftp ftp.cisco.com
cd /pub/mibs/v1
bin
get v1.tar.gz
exit
Note There are many MIBs in the tar file that you may not use. Regardless, Cisco
recommends you keep all the MIBs on file to support your evolving network
needs.
Note This section assumes you already have a basic understanding of UCD-SNMP
and know how to use its CLI commands.
Step 1 To determine the last restart reason for the router, enter the snmpget command and the relevant OID.
In the following example, the restart reason is “reload.”
onionring:~$ snmpget travis-nas-01.the.net 5urf5h0p .1.3.6.1.4.1.9.2.1.2.0
Counter32 (is a reserved word): At line 6 in /usr/local/share/snmp/mibs/SNMPv2-S
MI-V1SMI.my
Gauge32 (is a reserved word): At line 7 in /usr/local/share/snmp/mibs/SNMPv2-SMI
-V1SMI.my
Integer32 (is a reserved word): At line 8 in /usr/local/share/snmp/mibs/SNMPv2-S
MI-V1SMI.my
Did not find 'mib-2' in module RFC1213-MIB (/usr/local/share/snmp/mibs/IANAifTyp
e-MIB-V1SMI.my)
enterprises.9.2.1.2.0 = "reload"
If SNMP-parsing errors are generated, suppress them by appending 2>/dev/null to the end of the
command. Standard output is tagged as 1. Error output is tagged as 2.
onionring:~$ snmpget travis-nas-01.the.net 5urf5h0p .1.3.6.1.4.1.9.2.1.2.0 2> /dev/null
enterprises.9.2.1.2.0 = "reload"
onionring:~$
Note If no response is returned by the SNMP agent, allow error messages to print to the
screen by removing the 2>/dev/null argument.
Step 2 Check the system up time by entering the snmpget command and sysUpTime OID:
onionring:~$ snmpget travis-nas-01.the.net 5urf5h0p .1.3.6.1.2.1.system.sysUpTime.0 2>
/dev/null
system.sysUpTime.0 = Timeticks: (45450609) 5 days, 6:15:06.09
onionring:~$
Step 3 To gather basic configuration management information about the Cisco IOS device, enter the
snmpwalk command and the system OID.
onionring:~$ snmpwalk travis-nas-01.the.net 5urf5h0p system 2> /dev/null
system.sysDescr.0 = "Cisco Internetwork Operating System Software ..IOS (tm) 5800
Software (C5800-P4-M), Version 12.1(2a)T1, RELEASE SOFTWARE (fc2)..Copyright
(c) 1986-2000 by cisco Systems, Inc...Compiled Mon 12-Jun-00 23:13 by ccai"
system.sysObjectID.0 = OID: enterprises.9.1.188
system.sysUpTime.0 = Timeticks: (45492606) 5 days, 6:22:06.06
system.sysContact.0 = "[email protected]"
system.sysName.0 = "travis-nas-01.the.net"
system.sysLocation.0 = "Lake Travis (Austin) Dial POP"
system.sysServices.0 = 78
system.8.0 = Timeticks: (0) 0:00:00.00
onionring:~$
Step 4 Change the OID environmental prefix by entering the commands prefix and export prefix. This step
reduces the number of key strokes you must enter at the command line.
onionring:~$ snmpget travis-nas-01.the.net 5urf5h0p .1.3.6.1.4.1.9.2.1.2.0 2> /
dev/null
enterprises.9.2.1.2.0 = "reload"
onionring:~$ PREFIX=.1.3.6.1.4.1.9
onionring:~$ export PREFIX
onionring:~$ snmpget travis-nas-01.the.net 5urf5h0p 2.1.2.0 2> /dev/null
enterprises.9.2.1.2.0 = "reload"
onionring:~$
The UCD-SNMP application attaches a prefix to the requested variable unless it is fully qualified (for
example, unless the variable starts with a period “.”). By default, the prefix points to the MIB-II node
.1.3.6.1.2.1 location. The Cisco enterprises prefix points to .1.3.6.1.4.1.9
Step 5 Inspect the IP address entry table by entering the snmptable command and ipAddrTable OID:
onionring:~$ snmptable travis-nas-01.the.net 5urf5h0p ip.ipAddrTable 2> /dev/null
SNMP table: ip.ipAddrTable.ipAddrEntry
ipAdEntAddr ipAdEntIfIndex ipAdEntNetMask ipAdEntBcastAddr ipAdEntReasmMaxSize
172.21.10.1 351 255.255.255.255 1 18024
172.21.101.20 289 255.255.255.0 1 18024
onionring:~$
Step 6 Poll the interfaces table and redirect the output to a text file by entering the snmptable command and
ifTable OID:
onionring:~$ snmptable travis-nas-01.the.net 5urf5h0p interfaces.ifTable
> /export/home/www/travis-nas-01_ifTable.txt
onionring:~$
Step 7 Inspect the contents of the interfaces table by entering the cat command. In the following Cisco AS5800
example, notice the interface descriptions (ifDescr) and types (ifType). There is one PPP and DS0 entry
for each serial interface.
onionring:~$ cat /export/home/www/travis-nas-01_ifTable.txt
SNMP table: interfaces.ifTable.ifEntry
About MRTG
Multi Router Traffic Grapher (MRTG) is a free performance management application for Unix that
monitors SNMP statistics from any SNMP capable device on your network and performs the following
functions:
Captures, stores, and graphically presents SNMP data. By default, a web page with four graphs per
MIB object (OID) is created by MRTG. The graphs show the variation of MIB data over time.
Runs from the crontab. Every five minutes, a cron job runs MRTG to query a user-configured list
of OIDs and network devices. After each data collection cycle, the MRTG perl script posts updated
graphs to a web page.
Efficiently compresses and archives data samples to create graphs.
Enables you to determine if trending data is useful for monitoring your environment before you
invest in costly network performance software. If trending data is critical to manage your network,
it may be necessary to purchase a commercial network performance package, such as Concord
Network Health. However, you may find that MRTG is all you need.
Figure 10 MRTG Polls for OIDs; OID Values that Are Returned to MRTG
Cisco
IOS
devices Polling OID
MRTG
35193
For each OID referenced in the configuration file, MRTG creates the following graphs:
Daily graph—5 minute average data points with approximately 33 hours of data presented.
Weekly graph—30 minute average data points with approximately 8 days of data presented.
Monthly graph—2 hour average data points with approximately 5 weeks of data presented.
Yearly graph—1 day average data points with approximately 1 year of data presented.
To quickly create images by using the GD graphics library, go to http://www.boutell.com/gd
Caution Be cautious when polling network elements. Polling OIDs that retrieve large amounts of
data can cause CPU problems on a Cisco IOS device. For example, do not get the ARP
table, walk large portions of a MIB tree, poll the wrong OID too frequently, or get statistics
that have an entry for every interface. For example, a Cisco 7200 may have 10 interfaces;
whereas, a Cisco AS5800 may have 3,000 interfaces.
In this case study, the tools UCD-SNMP and SNMP Commander were used to inspect and understand
the MIBs. Based on this research, the network engineers at THEnet identified the OIDs in the following
tables to program in to MRTG.
To see the complete structure of the CISCO-POP-MGMT-MIB and CISCO-MODEM-MGMT-MIB,
go to the following URLs:
CISCO-POP-MGMT-MIB
http://www.cisco.com/univercd/cc/td/doc/cisintwk/intsolns/dialnms/popmgt.txt
CISCO-MODEM-MGMT-MIB
http://www.cisco.com/univercd/cc/td/doc/cisintwk/intsolns/dialnms/modemmgt.txt
The Connection Success Rate (CSR) is an important metric for tracking and measuring the stability of
a dial service. The CSR is defined by the number of modems that successfully train up and go in to
connected state. In addition to the CSR, you must track and analyze additional areas. For example,
SNMP MIBs can be used to measure the success rate for items such as PPP, AAA, and IP negotiation.
To collect the CSR service level counters, inspect the connection success and failure rate by using
modem OIDs or the show modem Cisco IOS command. SNMP, rather than the Cisco IOS CLI, is the
preferred method to collect these counters. SNMP can scale to support large numbers of access servers.
The following graphs show the DS0s and PPP sessions in use for 70,000 modem users calling in to a
dial-up service at a large university. The graphs are taken from one Cisco AS5300 in a large dial-up
modem pool.
The jagged saw-tooth pattern at the top of the graph indicates a telephone-switch hunt group for the dial
lines passing by the access servers. A “jump up” occurs each time the hunt group passes by a different
T1 line. For a hunt group that rotates in a round-robin fashion, a jagged saw-tooth pattern is normal.
MRTG efficiently compresses and archives data to create graphs. For example, you can keep
information for an entire year on a server without using much disk space.
To enable MRTG to locate a device and poll it for network statistics, follow these steps:
Step 1 Collect the hostnames, IP address, and read only (RO) SNMP community strings for the devices to be
monitored.
Step 2 Download, compile, and install MRTG on to a Solaris workstation:
For the source code, go to http://ee-staff.ethz.ch/~oetiker/webtools/mrtg/pub/
For the documentation, see the section “Getting and Installing MRTG on a UNIX System” at
http://ee-staff.ethz.ch/~oetiker/webtools/mrtg/mrtg.html
Step 3 Create a configuration file.
There are two basic ways to create the file:
Manually create it by using the MRTG files config.text and sample-mrtg.config. These files are in
the /mrtg/doc directory.
or
Use the configuration maker (cfgmaker) in the /mrtg/run directory. MRTG creates a basic
configuration file for you. The default configuration file made with cfgmaker automatically polls
for a standard set of MIBs and pre-defined values.
Generic command syntax:
./cfgmaker communitystring@hostname-or-ipaddress >> outputfilename.cfg
Example:
./cfgmaker 5urf5h0p@travis-nas-01 >> travis-nas-01.cfg
Note If the domain name server (DNS) is not working, MRTG cannot use a hostname.
You must use an IP address instead.
Step 4 By using a text editor, edit the configuration file (.cfg) to enable polling of dial variables and OIDs.
For a complete list of OIDs to poll, see the “About Selecting Dial OIDs” section on page 54.
The following configuration file is from a Cisco AS5300. This file can be used as a configuration
template for your environment, but use your own community string, work directory, and device name.
The following definitions are used in the example:
The RO community string is 5urf5h0p
The work directory is WorkDir: /export/home/www/mrtg/travis-nas-01/dial
######################################################################
#----------------------------------------------------------------------------------------
------
# purpose: DS0s and PPP Sessions.
#----------------------------------------------------------------------------------------
------
Target[travis-nas-01_DS0PPP]:
1.3.6.1.4.1.9.10.19.1.1.4.0&1.3.6.1.4.1.9.10.19.1.1.5.0:5urf5h0p@travis-nas-01
MaxBytes1[travis-nas-01_DS0PPP]: 200
MaxBytes2[travis-nas-01_DS0PPP]: 200
Title[travis-nas-01_DS0PPP]: DS0s and PPP sessions in Use
PageTop[travis-nas-01_DS0PPP]: <H2>DS0s and PPP sessions in Use</H2>
<TABLE>
<TR><TD>Device:</TD><TD>travis-nas-01</TD></TR>
<TR><TD><a href="/mrtg/mrtg.html">HOME</a></TD></TR>
</TABLE>
Options[travis-nas-01_DS0PPP]: gauge
#---------------------------------------------------------------------------------------
# purpose: DS0s and Analog
#---------------------------------------------------------------------------------------
Target[travis-nas-01_DS0ANALOG]:
1.3.6.1.4.1.9.10.19.1.1.4.0&1.3.6.1.4.1.9.10.19.1.1.2.0:5urf5h0p@travis-nas-01
MaxBytes1[travis-nas-01_DS0ANALOG]: 200
MaxBytes2[travis-nas-01_DS0ANALOG]: 200
Title[travis-nas-01_DS0ANALOG]: DS0s and Analog in Use
PageTop[travis-nas-01_DS0ANALOG]: <H2>DS0s and Analog in Use</H2>
<TABLE>
<TR><TD>Device:</TD><TD>travis-nas-01</TD></TR>
<TR><TD><a href="/mrtg/mrtg.html">HOME</a></TD></TR>
</TABLE>
Options[travis-nas-01_DS0ANALOG]: gauge
#----------------------------------------------------------------------------------------
------
# purpose: DS0s and SerialX:Y
#----------------------------------------------------------------------------------------
------
Target[travis-nas-01_DS0SERIAL]:
1.3.6.1.4.1.9.10.19.1.1.4.0&1.3.6.1.4.1.9.10.19.1.1.3.0:5urf5h0p@travis-nas-01
MaxBytes1[travis-nas-01_DS0SERIAL]: 200
MaxBytes2[travis-nas-01_DS0SERIAL]: 200
Title[travis-nas-01_DS0SERIAL]: DS0s and SerialX:Y in Use
PageTop[travis-nas-01_DS0SERIAL]: <H2>DS0s and SerialX:Y in Use</H2>
<TABLE>
<TR><TD>Device:</TD><TD>travis-nas-01</TD></TR>
<TR><TD><a href="/mrtg/mrtg.html">HOME</a></TD></TR>
</TABLE>
Options[travis-nas-01_DS0SERIAL]: gauge
#----------------------------------------------------------------------------------------
------
# purpose: DS0s and Sw56
#----------------------------------------------------------------------------------------
------
Target[travis-nas-01_DS0Sw56]:
1.3.6.1.4.1.9.10.19.1.1.4.0&1.3.6.1.4.1.9.10.19.1.1.10.0:5urf5h0p@travis-nas-01
MaxBytes1[travis-nas-01_DS0Sw56]: 200
MaxBytes2[travis-nas-01_DS0Sw56]: 200
Title[travis-nas-01_DS0Sw56]: DS0s and Sw56 in Use
PageTop[travis-nas-01_DS0Sw56]: <H2>DS0s and Sw56 in Use</H2>
<TABLE>
<TR><TD>Device:</TD><TD>travis-nas-01</TD></TR>
<TR><TD><a href="/mrtg/mrtg.html">HOME</a></TD></TR>
</TABLE>
Options[travis-nas-01_DS0Sw56]: gauge
#----------------------------------------------------------------------------------------
------
# purpose: cpmISDNCallsRejected and cpmModemCallsRejected
#----------------------------------------------------------------------------------------
------
Target[travis-nas-01_callrejects]:
1.3.6.1.4.1.9.10.19.1.2.1.0&1.3.6.1.4.1.9.10.19.1.2.2.0:5urf5h0p@travis-nas-01
MaxBytes1[travis-nas-01_callrejects]: 200
MaxBytes2[travis-nas-01_callrejects]: 200
Title[travis-nas-01_callrejects]: travis-nas-01 cpmISDNCallsRejected and
cpmModemCallsRejected
PageTop[travis-nas-01_callrejects]: <H2>cpmISDNCallsRejected and
cpmModemCallsRejected</H2>
<TABLE>
<TR><TD>Device:</TD><TD>travis-nas-01</TD></TR>
<TR><TD><a href="/mrtg/mrtg.html">HOME</a></TD></TR>
</TABLE>
#----------------------------------------------------------------------------------------
------
# purpose: cpmISDNCallsClearedAbnormally and cpmModemCallsClearedAbnormally
#----------------------------------------------------------------------------------------
------
Target[travis-nas-01_clearAbnormal]:
1.3.6.1.4.1.9.10.19.1.2.3.0&1.3.6.1.4.1.9.10.19.1.2.4.0:5urf5h0p@travis-nas-01
MaxBytes1[travis-nas-01_clearAbnormal]: 200
MaxBytes2[travis-nas-01_clearAbnormal]: 200
Title[travis-nas-01_clearAbnormal]: travis-nas-01 cpmISDNCallsClearedAbnormally and
cpmModemCallsClearedAbnormally
PageTop[travis-nas-01_clearAbnormal]: <H2>cpmISDNCallsClearedAbnormally and
cpmModemCallsClearedAbnormally</H2>
<TABLE>
<TR><TD>Device:</TD><TD>travis-nas-01</TD></TR>
<TR><TD><a href="/mrtg/mrtg.html">HOME</a></TD></TR>
</TABLE>
#----------------------------------------------------------------------------------------
------
# purpose: cpmISDNNoResource and cpmModemNoResource
#----------------------------------------------------------------------------------------
------
Target[travis-nas-01_callNoResource]:
1.3.6.1.4.1.9.10.19.1.2.5.0&1.3.6.1.4.1.9.10.19.1.2.6.0:5urf5h0p@travis-nas-01
MaxBytes1[travis-nas-01_callNoResource]: 200
MaxBytes2[travis-nas-01_callNoResource]: 200
Title[travis-nas-01_callNoResource]: travis-nas-01 cpmISDNNoResource and
cpmModemNoResource
PageTop[travis-nas-01_callNoResource]: <H2>cpmISDNNoResource and cpmModemNoResource</H2>
<TABLE>
<TR><TD>Device:</TD><TD>travis-nas-01</TD></TR>
<TR><TD><a href="/mrtg/mrtg.html">HOME</a></TD></TR>
</TABLE>
#----------------------------------------------------------------------------------------
------
# purpose: cmSystemModemsInUse and cmSystemModemsAvailable
#----------------------------------------------------------------------------------------
------
Target[travis-nas-01_modemcount]:
1.3.6.1.4.1.9.9.47.1.1.6.0&1.3.6.1.4.1.9.9.47.1.1.7.0:5urf5h0p@travis-nas-01
MaxBytes1[travis-nas-01_modemcount]: 200
MaxBytes2[travis-nas-01_modemcount]: 200
Title[travis-nas-01_modemcount]: cmSystemModemsInUse and cmSystemModemsAvailable
PageTop[travis-nas-01_modemcount]: <H2>cmSystemModemsInUse and
cmSystemModemsAvailable</H2>
<TABLE>
<TR><TD>Device:</TD><TD>travis-nas-01</TD></TR>
<TR><TD><a href="/mrtg/mrtg.html">HOME</a></TD></TR>
</TABLE>
Options[travis-nas-01_modemcount]: gauge
#----------------------------------------------------------------------------------------
------
# purpose: cvpdnTunnelTotal and cvpdnDeniedUsersTotal
#----------------------------------------------------------------------------------------
------
Target[travis-nas-01_vpdn_tunnelanddenied]:
1.3.6.1.4.1.9.10.24.1.1.1.0&1.3.6.1.4.1.9.10.24.1.1.3.0:5urf5h0p@travis-nas-01
MaxBytes1[travis-nas-01_vpdn_tunnelanddenied]: 200
MaxBytes2[travis-nas-01_vpdn_tunnelanddenied]: 200
Title[travis-nas-01_vpdn_tunnelanddenied]: cvpdnTunnelTotal and cvpdnDeniedUsersTotal
PageTop[travis-nas-01_vpdn_tunnelanddenied]: <H2>cvpdnTunnelTotal and
cvpdnDeniedUsersTotal</H2>
<TABLE>
<TR><TD>Device:</TD><TD>travis-nas-01</TD></TR>
<TR><TD><a href="/mrtg/mrtg.html">HOME</a></TD></TR>
</TABLE>
Options[travis-nas-01_vpdn_tunnelanddenied]: gauge
#----------------------------------------------------------------------------------------
------
# purpose: activeDS0s and cvpdnSessionTotal
#----------------------------------------------------------------------------------------
------
Target[travis-nas-01_activeDS0vpdnSession]:
1.3.6.1.4.1.9.10.19.1.1.4.0&1.3.6.1.4.1.9.10.24.1.1.2.0:5urf5h0p@travis-nas-01
MaxBytes1[travis-nas-01_activeDS0vpdnSession]: 200
MaxBytes2[travis-nas-01_activeDS0vpdnSession]: 200
Title[travis-nas-01_activeDS0vpdnSession]: activeDS0s and cvpdnSessionTotal
PageTop[travis-nas-01_activeDS0vpdnSession]: <H2>activeDS0s and cvpdnSessionTotal</H2>
<TABLE>
<TR><TD>Device:</TD><TD>travis-nas-01</TD></TR>
<TR><TD><a href="/mrtg/mrtg.html">HOME</a></TD></TR>
</TABLE>
Options[travis-nas-01_activeDS0vpdnSession]: gauge
Step 5 Open the crontab file in your system by entering crontab -e. The -e enables edit mode. You can run
crontab from any directory.
igloo:/ ->crontab -e
"/tmp/crontabmMaqZd" 14 lines, 610 characters
#ident "@(#)root 1.19 98/07/06 SMI" /* SVr4.0 1.1.3.1 */
#
# The root crontab should be used to perform accounting data collection.
#
# The rtc command is run to adjust the real time clock if and when
# daylight savings time changes.
#
10 3 * * 0,4 /etc/cron.d/logchecker
10 3 * * 0 /usr/lib/newsyslog
15 3 * * 0 /usr/lib/fs/nfs/nfsfind
1 2 * * * [ -x /usr/sbin/rtc ] && /usr/sbin/rtc -c > /dev/null 2>&1
30 3 * * * [ -x /usr/lib/gss/gsscred_clean ] && /usr/lib/gss/gsscred_clean
Caution Although the crontab file is a flat text file, do not manually edit it by using vi crontab.
vi can corrupt the crontab, which causes all cron jobs to stop working. You must use the
crontab -e command, which synchronizes and updates all the crontab daemons
accordingly.
Step 6 Insert the directory path for the MRTG configuration file (.cfg) you created. At the bottom of the file,
enter a line similar to this one:
0,5,10,15,20,25,30,35,40,45,50,55 * * * * /opt/mrtg/run/mrtg
/opt/mrtg/run/conf/travis-nas-01.cfg
On a 5-minute time interval, MRTG will start up, read the configuration file, and re-generate
performance graphs.
Step 1 Verify that the configuration file points to the correct working directory (WorkDir:) on your web server
by entering the more command. See WorkDir: in the following example.
igloo:/opt/downloads/mrtg/mrtg-2.8.8/run ->more travis-nas-01.cfg
WorkDir: /export/home/www/mrtg/travis-nas-01/dial
# set defaults
Options[_]: growright
# make legends reflect these are call counters
YLegend[_]: Active Calls
ShortLegend[_]: calls
LegendI[_]: calls:
LegendO[_]: calls:
.
.
.
Step 2 To send the web pages and graphs to the web-server directory, enter the following command:
igloo:/opt/downloads/mrtg/mrtg-2.8.8/run ->./mrtg travis-nas-01.cfg
igloo:/opt/downloads/mrtg/mrtg-2.8.8/run ->
Now, the crontab will automatically perform this function every five minutes.
Ignore any Rateup WARNING errors, which means that crontab is working in the background.
Rateup WARNING: .//rateup The backup log file for 172.21.101.20.178 was invalidl
Rateup WARNING: .//rateup Can't remove 172.21.101.20.178.old updating log file
Rateup WARNING: .//rateup Can't rename 172.21.101.20.178.log to 172.21.101.20.1e
Rateup WARNING: .//rateup could not read the primary log file for 172.21.101.209
Step 3 Use a web browser to view the MRTG output files in the web page directory.
Note If the domain name server (DNS) is not working, a hostname cannot be used by
MRTG. Use the IP address instead.
About Syslog
Syslog, Network Time Protocol (NTP), and modem call records work together to isolate and
troubleshoot faults in a dial access network.
Syslog enables you to:
Centrally log and analyze configuration events and system error messages, such as router
configuration changes, interface up and down status, modem events, security alerts, environmental
conditions, trace backs, and CPU process overloads.
Capture client debug output sessions in a real-time scenario.
Reserve telnet sessions for making configurations changes and using show commands.
Telnet sessions that are cluttered with debug output interfere with troubleshooting procedures.
Reduce network downtime by knowing when the network has quality problems.
Syslog messages
Syslog server
Cisco IOS
Internal view
Syslog messages
written to
24528
hard disk
You can enable syslog in any Cisco IOS device and send syslog messages to many different destinations
(host, buffer, console, history, and monitor).
By using the logging ? command, you can see the log settings for distinct destinations:
travis-nas-01(config)#logging ?
Hostname or A.B.C.D IP address of the logging host
buffered Set buffered logging parameters
console Set console logging level
facility Facility parameter for syslog messages
history Configure syslog history table
monitor Set terminal line (monitor) logging level
on Enable logging to all supported destinations
rate-limit Set messages per second limit
source-interface Specify interface for source address in logging
transactions
trap Set syslog server logging level
There are eight levels of syslog information in the Cisco IOS software. Monitor and manage logs
according to the severity level of the syslog message. By using the logging trap ? command, you can
see the logging severity levels:
travis-nas-01(config)#logging trap ?
<0-7> Logging severity level
alerts Immediate action needed (severity=1)
critical Critical conditions (severity=2)
debugging Debugging messages (severity=7)
emergencies System is unusable (severity=0)
errors Error conditions (severity=3)
informational Informational messages (severity=6)
notifications Normal but significant conditions (severity=5)
warnings Warning conditions (severity=4)
<cr>
In this case study, syslog is enabled on all Cisco access servers and backbone routers. Each device sends
syslog messages to the same log file on the same syslog server.
The terminology in the syslog messages can vary between different versions of Cisco IOS software.
To effectively manage syslog messages, ensure that wherever possible, the same version of Cisco IOS
software is running on all routers.
About NTP
The Network Time Protocol (NTP):
Provides a synchronized time base for networked routers, servers, and other devices.
Coordinates the time of network events, which helps you understand and troubleshoot the time
sequence of network events. For example, call records for specific users can be correlated within
one millisecond.
Enables you to compare time logs from different networks, which is essential for:
` Tracking security incidents
` Analyzing faults
` Troubleshooting
Without precise time synchronization between all the various logging, debug output, management,
and AAA functions in the network, you cannot make time comparisons.
For a list of NTP clients, go to http://www.eecis.udel.edu/~ntp/software.html
You can view entire log files or portions of logs in the MCR viewer. In addition, you can parse for
specific users and other call attributes for a modem call (for example, modulation, error correction,
compression, disconnect causes, and retrains).
Note Modem call records are available in syslog starting with Cisco IOS
Releases 11.3AA and 12.0T.
Step 1 From the Cisco IOS device, enter the following commands. Enable debug timestamps and include the
date, time, and milliseconds relative to the local time zone:
!
service timestamps debug datetime msec localtime show-timezone
service timestamps log datetime msec localtime show-timezone
!
Step 2 Identify the local timezone and enable recurring time adjustments for daylight savings time by entering
the following commands:
!
clock timezone CST -6
clock summer-time CST recurring
!
Step 3 Locate an NTP server that can be reached by the Cisco IOS device.
Step 4 Specify the IP address for the NTP server and enable automatic-calendar updates by entering the
following commands:
!
ntp update-calendar
ntp server 172.22.255.1
!
Note By default, the ntp clock-period command is enabled in some Cisco IOS releases.
The Cisco IOS software appends an arbitrary number to the end of the command.
Step 5 Verify that the clock is synchronized with the NTP server by entering the following command:
travis-nas-01>show ntp status
Clock is synchronized, stratum 9, reference is 172.22.255.1
nominal freq is 250.0000 Hz, actual freq is 249.9987 Hz, precision is 2**24
reference time is BD123336.28CCF0C4 (18:09:42.159 CST Sat Jul 8 2000)
clock offset is 0.1183 msec, root delay is 61.84 msec
root dispersion is 0.93 msec, peer dispersion is 0.79 msec
travis-nas-01>
Inspect the status and time association. Clock sources are identified by their stratum levels. The
previous display shows a stratum level nine clock.
Note If the NTP synchronization does not take place, reload the router.
Step 6 Verify that the router is receiving NTP packets from the NTP server by entering the following command:
travis-nas-01>show ntp association
The tilde (~) next to the IP address of the NTP server means the NTP service is configured. The asterisk
(*) indicates successful synchronization with the master clock.
Step 1 Locate an NTP server that can be reached by the workstation. There are many available NTP servers on
the Internet. If your workstation cannot reach the Internet, locate an NTP server within your network.
Note A common practice is to configure an area border router as an NTP server for a
particular subnet. The area border router then points to an external NTP server.
Other equipment on that subnet uses the loopback 0 IP address on the area border
router as an NTP server.
Step 2 Go to the /etc/inet directory and inspect the template file called ntp.client:
onionring:~$ cd /etc/inet
onionring:/etc/inet$ more ntp.client
# @(#)ntp.client 1.2 96/11/06 SMI
#
# /etc/inet/ntp.client
#
# An example file that could be copied over to /etc/inet/ntp.conf; it
# provides a configuration for a host that passively waits for a server
# to provide NTP packets on the ntp multicast net.
#
multicastclient 224.0.1.1
Step 3 Copy ntp.client and create the ntp.conf configuration file in the /etc/inet default directory:
onionring:/etc/inet$ cp ntp.client ntp.conf
onionring:/etc/inet$
The NTP daemon reads ntp.conf at startup to locate the NTP server.
Note You must have root-level permissions to edit or copy any files in the /etc/inet/
directory.
Step 4 Edit the ntp.conf file by changing multicastclient to server followed by the IP address of the target
NTP server:
# @(#)ntp.client 1.2 96/11/06 SMI
#
# /etc/inet/ntp.client
#
# An example file that could be copied over to /etc/inet/ntp.conf; it
# provides a configuration for a host that passively waits for a server
# to provide NTP packets on the ntp multicast net.
#
server 172.22.255.1
Step 5 Go to the directory /usr/lib/inet/ and start the NTP daemon by entering the xntpd command.
The daemon sets and maintains the time-of-day of the operating system in agreement with the master
time server.
onionring:/etc/inet$ cd /usr/lib/inet/
onionring:/usr/lib/inet$ ls
in.dhcpd xntpd
onionring:/usr/lib/inet$ xntpd
onionring:/usr/lib/inet$
Step 6 Verify that the NTP daemon is running by entering the ntpq -p command:
onionring:/usr/lib/inet$ ntpq -p
remote refid st t when poll reach delay offset disp
==============================================================================
*maui-rtr-01.mau CHU(1) 8 u 49 64 377 1.08 -0.131 0.08
onionring:/usr/lib/inet$
Problem Solution
The ntp.client file or the xntpd Verify that the workstation is running Solaris v2.6 or a later
daemon cannot be found in the version of Solaris. Enter the uname -a command to see the
directories shown in the examples. version.
Versions earlier than Solaris v2.6 do not support NTP and must
be supplemented with additional NTP software available from
http://www.sunfreeware.com/
The error message “No Associations There are three possible solutions:
IDs Returned” when you enter the
ntpq -p command. The network traffic is slow, and the workstation has not
had time to poll the NTP server. Allow the workstation
enough time to issue the poll (a few seconds); then, enter
the ntpq -p command.
The mulitcastclient line in the ntp.conf file was not
replaced with the server line.
The NTP server you have chosen is down, or it is not
configured correctly.
Enabling Syslog and Modem Call Records in the Cisco IOS Software
To enable syslog messages in the Cisco IOS software and send them to a syslog server,
follow these steps:
Step 1 Inspect the current logging status by entering the following command:
travis-nas-01#show logging
Syslog logging: enabled (0 messages dropped, 0 flushes, 0 overruns)
Console logging: level debugging, 42 messages logged
Monitor logging: level debugging, 93 messages logged
Buffer logging: level debugging, 3 messages logged
Trap logging: level informational, 121 message lines logged
Step 2 Set up a basic syslog configuration by entering the following commands. See Table 20 for command
descriptions.
!
logging buffered 10000 debugging
no logging console guaranteed
logging console informational
!
!
logging trap debugging
logging facility local0
logging 172.21.100.100
!
Command Purpose
logging buffered 10000 debugging Sets the internal log buffer to 10000 bytes for debug output.
New messages overwrite old messages.
You can tune buffered-logging parameters for collecting logs
on a NAS when you are at a remote location. For example, turn
on debugs and start logging them in the history buffer. Make
your test call; then, re-connect in shell mode and inspect the
debugs.
logging console informational Sends the most urgent informational logs to the console port in
no logging console guaranteed the event the IP network or syslog server fails. Alternatively,
send messages to the console by using the commands logging
console errors or logging console warnings.
Step 3 Enable modem call records in the Cisco IOS by entering the following command:
!
modem call-record terse
!
Step 4 (Optional) To disable syslog messages and SNMP traps when dial interfaces go up and down, use the
commands no logging event link-status and no snmp trap link-status. Although up and down events
are legitimate events on dial interfaces, these events should not cause alarms as LAN and WAN
interfaces would.
!
interface Serial1/0/0:4:23
no logging event link-status
no snmp trap link-status
!
interface Group-Async0
no logging event link-status
no snmp trap link-status
!
Note In some Cisco IOS images, the logging event link-status command is disabled by
default.
Step 1 On the syslog server, edit the file syslog.conf in the /etc/ directory by using a text editor. To get syslog
working, you must add the following line to the file:
|
local0.debug /var/log/router.log
|
The local facility number is local0.debug. It must match the facility number configured in the
Cisco IOS device. See the logging facility command in Table 20.
The log file path name is /var/log/router.log
One tab exists between the facility number and the path name. Spaces are not permitted.
You can define any directory location/path for the .txt log file.
In the following example, the new line is in bold:
"syslog.conf" 53 lines, 1861 characters
#ident "@(#)syslog.conf 1.3 93/12/09 SMI" /* SunOS 5.0 */
#
# Copyright (c) 1991-1993, by Sun Microsystems, Inc.
#
# syslog configuration file.
#
# This file is processed by m4 so be careful to quote (`') names
# that match m4 reserved words. Also, within ifdef's, arguments
# containing commas must be quoted.
#
#
#
#
#Following is the new line. It adds a logging facility number and direcory path for the
#log file (router.log).
local0.debug /var/log/router.log
Note The previous syslog.conf example has been abbreviated to fit this document. The
actual file size is much larger than the example. Add the new line to the end of the
file.
Step 2 Create the log file and check the read/write privileges by entering the following commands:
aurora:/etc ->touch /var/log/router.log
aurora:/etc ->ls -l /var/log/router.log
-rw-r--r-- 1 root other 27110 Jul 8 19:56 /var/log/router.log
aurora:/etc ->
Step 3 Verify the syslog daemon is running by entering the ps -elf | grep syslog command from the
/etc directory. If the daemon is running, a process ID is returned by the system (for example, 169). If the
daemon is not running, no ID is returned.
aurora:/etc ->ps -elf | grep syslog
8 S root 169 1 0 41 20 60756cc8 187 604e3156 Jun 19 ? d
aurora:/etc ->
Step 4 Activate the configuration changes you made in syslog.conf by restarting the syslog daemon. Enter the
start/stop S74syslog scripts from the /etc/rc2.d directory.
aurora:/etc ->rc2.d/S74syslog stop
Stopping the syslog service.
aurora:/etc ->rc2.d/S74syslog start
syslog service starting.
aurora:/etc ->ps -elf | grep syslog
8 S root 4405 1 0 44 20 6042d320 187 604e3156 09:16:35 ? d
aurora:/etc ->
Confirm that a new syslog process ID was assigned (for example, 4405) after the start/stop process.
Note You must have root-level permissions to run system scripts, such as the files in
/etc/rc2.d
Step 1 From the Cisco IOS device, create basic syslog messages by entering these commands:
travis-nas-01#configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
travis-nas-01(config)#^Z
travis-nas-01#configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
travis-nas-01(config)#^Z
travis-nas-01#
Step 2 From the syslog server, verify that the syslog messages went in to the log file. Enter the tail -f command
to monitor the last 10 lines of an active log file. To exit tail -f mode, press Ctrl-C.
aurora:/etc ->tail -f /var/log/router.log
May 26 17:43:12 [172.21.101.20.6.122] 629: May 26 20:35:23.551 CST: %SYS-5-CONFIG_I:
Configured from console by vty0 (172.22.61.200)
May 26 17:51:15 [172.21.101.20.6.122] 630: May 26 20:43:27.068 CST: %SYS-5-CONFIG_I:
Configured from console by console
May 26 17:51:19 [172.21.101.20.6.122] 631: May 26 20:43:30.932 CST: %SYS-5-CONFIG_I:
Configured from console by console
May 26 17:54:38 [172.21.101.20.6.122] 632: May 26 20:46:50.344 CST: %SYS-5-CONFIG_I:
Configured from console by vty0 (172.22.61.200)
^C
aurora:/etc ->
Step 3 View the syslog messages in a web browser. Notice the wide horizontal scroll bar, which is helpful for
viewing debug messages and modem call records.
Figure 18 Syslog Messages that Appear by Using FTP and a Web Browser
ftp://[email protected]/var/log/router.log
Table 21 shows the generic URL syntax to use. Be sure to replace the variables with your own
information. The FTP server automatically prompts you for a login password.
Table 22 Utilities Provided by the Web Portal for the Dial NMS
Utility Function
Documentation Center A web server used as an online-documentation hub to share
network operations information.
Device Linker A web page used for bookmarking URLs for quick device telnet
and out of band (console) access.
See the “Building a Device Linker Web Page” section on page 83.
Table 22 Utilities Provided by the Web Portal for the Dial NMS (continued)
Utility Function
Cisco IOS CLI Command Center A web page that provides HTTP access to frequently used
Cisco IOS CLI commands. The operations team and help desk can
use this utility to troubleshoot connectivity problems.
See the “Using HTTP to Access CLI Commands” section on
page 86.
IP Tracker A web page that uses two scripts to keep track of IP address block
assignments by using DNS reverse lookup zones.
See the “Creating an IP Tracker Web Page” section on page 96.
SNMP Commander A script that aids the MIB research task by enabling engineers to
build web-based object identification (OIDs) bookmarks. You can
poll for network statistics by using OID bookmarks and a web
browser. No keyboard is required.
See the “About SNMP Commander” section on page 49.
Syslog Viewer A utility that uses FTP to access a syslog server and a web browser
to view syslog messages. Migration to HTTP is straightforward
after security issues are addressed. The use of non-wrapping text
is useful when viewing debug messages and modem call records.
See the “Inspecting Syslog Messages in the Log File” section on
page 78.
Modem Call Record Viewer Light-weight scripts used to parse and view modem call records.
See the “About Syslog” section on page 67.
CiscoWorks 2000 Resource A utility used to remotely monitor and maintain devices through
Manager Essentials a web-based browser interface.
See the “Task 8—Using CiscoWorks 2000 Resource Manager
Essentials” section on page 117.
Line 1
RS-232 Telnet access
cable telnet://172.21.10.10
Cisco AS5800
35192
HTTP access to the CLI
http://172.21.10.10
By using a Cisco terminal server for out-of-band console access, such as a Cisco 2511, the consoles are
available at TCP port 20xx on a terminal server. The target line number replaces xx. For example to get
to line 1, telnet to port 2001. The equivalent URL is telnet://172.21.101.250:2001
To build a device linker web page, follow these steps:
<td><a href="http://172.21.10.1">travis-nas-01</a></td>
<td><a href="telnet://172.21.10.1">172.21.10.1</a></td>
<td><a href="telnet://172.21.101.250:2001">travis-oob-01:2001</a></td>
<td>5800</td>
<td>Dial POP #1</td>
</tr>
</table>
</body>
</html>
Table 23 Functions and Parameters for Designing a Device Linker Web Page
Step 4 Post the device linker web page to a WWW server in the NOC.
Step 5 Click on an active device link. After a telnet session opens, log in.
Step 1 Verify that the configuration on the terminal server is correct. Telnet is the only service that must be
supported to access the lines. The following configuration fragment shows you how to configure
16 TTY lines on a Cisco 2511 terminal server.
!
line 1 16
no exec
transport input telnet
!
Step 2 If the console port is blocked, you may need to telnet to the terminal server and clear the line. Enter the
show users EXEC command followed by the clear line type number command.
c2511-oob#show users
Line User Host(s) Idle Location
0 con 0 admin idle
4 tty 4 admin incoming 0 dhcp-172-71-218-198.guessme.com
* 10 vty 0 admin incoming 0 dhcp-172-71-218-198.guessme.com
Step 3 (Optional) Sometimes administrators inadvertently leave lines in use. To make idle telnet sessions end
after 30 minutes, enter the exec-timeout 30 0 command on all the lines.
!
line 1 16
no exec
exec-timeout 30 0
transport input telnet
!
Step 1 Enable HTTP services on the Cisco IOS device by entering the following commands:
!
ip http server
ip http authentication aaa
!
Command Purpose
ip http server Enables the router to function as an HTTP server.
ip http authentication aaa Uses the AAA facility as an authentication method
for HTTP server users.
Step 2 Create a table in an HTML web page and enter your list of frequently used Cisco IOS CLI commands.
Note To create the link for a CLI command, specify the IP address of the Cisco IOS
device followed by the command. Remember to include the forward slashes (/)
between each command mode and key word.
Formula Example
http://ip-address/exec/ios-key-word/.../cr http:/172.23.84.20/exec/sh/caller/cr
The web page can include many types of commands useful for managing a dial Internet access service,
including:
System commands (Table 26)
Interface commands (Table 27)
Call state commands (Table 28)
Debug commands (Table 29)
Step 3 Post the HTML page that you created in Step 2 to a web server.
For the source code that created the Cisco IOS CLI Commander in Figure 22, go to
http://www.cisco.com/univercd/cc/td/doc/cisintwk/intsolns/dialnms/httpcli.txt
Step 4 Click on a CLI command and view the command output in a web page.
Note This section assumes you are familiar with the basics of DNS. For more information about
DNS, see DNS and Bind, Third Edition, by Paul Albitz and Cricket Liu. The ISBN number
is 1565925122.
Reference URL
Internet Software Consortium for BIND (Berkeley Internet http://www.isc.org/products/BIND/
Name Daemon)—Describes the DNS protocols.
Cisco Network Registrar—A collection of DNS/DHCP http://www.cisco.com/univercd/cc/td/doc
user guides and reference manuals. /product/rtrmgmt/ciscoasu/nr/index.htm
Step 1 Log in to the Cisco Network Registrar application by entering the following directory path:
/opt/nwreg2/usrbin/nrcmd
nrcmd>
After logging in, the command mode is accessed and the prompt “nrcmd>” appears.
Step 2 To create an account for an administrator, enter the admin command and an associated password:
nrcmd> admin bob create password=xyz
Step 3 To see a list of existing administrators, enter the admin list command:
nrcmd> admin list
bob: password=********;
omar: password=********;
padma: password=********;
Step 4 Inspect a reverse zone by entering the zone command and listRR option:
nrcmd> zone 101.21.172.in-addr.arpa. listRR
100 Ok
Static Resource Records
@ IN SOA onionring.the.net. netadmin.the.net 1997121601
3600 1800 86400 86400
@ IN NS onionring.the.net.com.
205 IN PTR unused-205.the.net.
203 IN PTR unused-203.the.net.
210 IN PTR unused-210.the.net.
204 IN PTR unused-204.the.net.
1 IN PTR unused-1.the.net.
10 IN PTR unused-10.the.net.
101 IN PTR unused-101.the.net.
102 IN PTR unused-102.the.net.
103 IN PTR unused-103.the.net.
104 IN PTR unused-104.the.net.
(truncated for brevity)
Step 5 When working with a reverse zone, you can map an IP address to a router by entering the zone command
and the addRR resource record (RR) option:
nrcmd> zone 101.21.172.in-addr.arpa. addRR 7 PTR bobslake-nas-01.the.net
Step 6 Remove a resource record by entering the zone command and removeRR option:
nrcmd> zone 101.21.172.in-addr.arpa. removeRR 7 PTR unused-07.the.net
Step 7 To minimize the lock-time on the database, enter the following CNR command from the Unix command
line. Use quotations (“ ”) to contain the command and pass it to the shell.
/opt/nwreg2/usrbin/nrcmd "zone 101.21.172.in-addr.arpa. listRR"
Step 8 Sort the records and parse the output by entering the following CNR command from the Unix command
line:
/opt/nwreg2/usrbin/nrcmd "zone 101.21.172.in-addr.arpa. listRR" | sort -n | more
username: password:
0 IN PTR broadcast-0.the.net.
@ IN NS onionring.the.net.
@ IN SOA onionring.the.net. netadmin.the.net.101.
21.172.in-addr.arpa. 1997121606 3600 1800 86400 86400
Dynamic Resource Records
Static Resource Records
1 IN PTR unused-1.the.net.
2 IN PTR unused-2.the.net.
3 IN PTR unused-3.the.net.
4 IN PTR unused-4.the.net.
5 IN PTR unused-5.the.net.
6 IN PTR unused-6.the.net.
7 IN PTR unused-7.the.net.
8 IN PTR unused-8.the.net.
9 IN PTR unused-9.the.net.
10 IN PTR unused-10.the.net.
(truncated for brevity)
Step 9 To add an “A” Resource Record (RR) to a forward zone (domain) and map a name to an IP address,
enter the zone command:
nrcmd> zone the.net. addRR bobslake-nas-02 A 172.21.10.18
@ IN NS onionring.the.net.
@ IN SOA onionring.the.net. netadmin.the.net. 56 10800
3600 604800 86400
Dynamic Resource Records
Static Resource Records
aurora IN A 172.21.100.100
bobslake-nas-01 IN A 172.21.10.10
bobslake-nas-02 IN A 172.21.10.18
doc-2610-01 IN A 172.21.10.13
doc-3810a-01 IN A 172.21.10.14
doc-3810d-01 IN A 172.21.10.15
doc-AS5850-01 IN A 172.21.10.11
doc-core-01 IN A 172.21.10.5
doc-core-02 IN A 172.21.10.6
doc-core-03 IN A 172.21.10.7
(truncated for brevity)
Step 10 To reload the server to make all IP assignments or changes take effect, enter the following command:
nrcmd> server dns reload
Note Reload all changes into the DNS database, so that the changes can be resolved
upon lookup.
The previous batch-file example shows how to add two new device/IP addresses. In addition to adding
two “A” records (lines 1 and 2), remove the “unused” PTR records from the reverse zone (lines 3 and
4) before adding the new “PTR” records, in place of the unused records, to the reverse zone (lines 5 and
6). See line 7 to reload the DNS server.
Step 2 Run the script by using the -b option:
nrcmd> -b < 172.21.10.batch
nrcmd>
zone the.net. addRR doc-core-03 A 172.21.10.7
100 Ok
doc-core-03 IN A 172.21.10.7
nrcmd>
zone 10.21.172.in-addr.arpa. removeRR 6 PTR unused-6.the.net.
100 Ok
removing 6 IN PTR unused-6.the.net.
nrcmd>
zone 10.21.172.in-addr.arpa. removeRR 7 PTR unused-7.the.net.
100 Ok
removing 7 IN PTR unused-7.the.net.
nrcmd>
zone 10.21.172.in-addr.arpa. addRR 6 PTR doc-core-02.the.net.
100 Ok
6 IN PTR doc-core-02.the.net.
nrcmd>
zone 10.21.172.in-addr.arpa. addRR 7 PTR doc-core-03.the.net.
100 Ok
7 IN PTR doc-core-03.the.net.
nrcmd>
server dns reload
100 Ok
Step 1 Create a domain and include all forward mapping (the “A” records) by entering the zone command with
the create option:
nrcmd> zone the.net create primary file=the.net.zone.txt
To create new subnets by using the CLI, import a BIND zone definition file, which can be edited by
using an ASCI text editor. The following example shows an edited BIND file.
@ IN SOA onionring.the.net. netadmin.the.net. (
2000071600 ; serial number
3600 ; Refresh 1 hours
1800 ; Retry 30 minutes
86400 ; Expire 24 hours
86400 ; TTL 24 hours
)
IN NS onionring.the.net.
doc-rtr58-01 IN A 172.21.101.20
doc-rtr54-01 IN A 172.21.101.21
doc-rtr53-01 IN A 172.21.101.22
doc-rtr53-05 IN A 172.21.101.23
doc-3810a-01 IN A 172.21.10.14
doc-3810d-01 IN A 172.21.10.15
doc-ubr7246-01 IN A 172.21.10.16
doc-switch-02 IN A 172.21.10.17
Step 2 Verify that the primary zone was created by entering the zone command with the listRR option:
nrcmd> zone the.net listRR
100 Ok
Static Resource Records
@ IN SOA onionring.the.net.
netadmin.the.net.0
@ IN NS onionring.the.net.
doc-rtr58-01 IN A 172.21.101.20
doc-rtr54-01 IN A 172.21.101.21
doc-rtr53-01 IN A 172.21.101.22
doc-rtr53-05 IN A 172.21.101.23
(Truncated for brevity)
Dynamic Resource Records
Step 1 Become familiar with the layout of an IP tracker web page. In Figure 24, the subnet column shows a list
of all managed zones. The assignment column describes the purpose of each zone.
[www.the.net]
0 host = broadcast-0.the.net
1 host = unused-1.the.net
2 host = unused-2.the.net
3 host = unused-3.the.net
4 host = unused-4.the.net
5 host = doc-core-01.the.net
6 host = doc-core-02.the.net
7 host = doc-core-03.the.net
8 host = doc-ls1010-01.the.net
9 host = doc-switch-01.the.net
10 host = doc-pix-01.the.net
10.21.172.in-addr.arpa. server = onionring.the.net
11 host = doc-AS5850-01.the.net
12 host = doc-oob-03.the.net
13 host = doc-2610-01.the.net
14 host = doc-3810a-01.the.net
15 host = doc-3810d-01.the.net
16 host = doc-ubr7246-01.the.net
17 host = doc-switch-02.the.net
Step 3 Download the source code for the scripts and customize them for your environment.
Go to http://www.cisco.com/univercd/cc/td/doc/cisintwk/intsolns/dialnms/dnszone.txt
For a sample BIND file that can be used as a template and edited for your environment, go to
http://www.cisco.com/univercd/cc/td/doc/cisintwk/intsolns/dialnms/bindtemp.txt
About HP OpenView
The primary function of HP OpenView (HPOV) is to manage faults.
In this case study, HP OpenView:
Discovers all the devices in the network.
Functions as the central-starting point for other element managers (EM). After HPOV is installed,
the remaining components of the network management architecture are built around HPOV.
Resides on the same Unix workstation as CiscoWorks 2000 Resource Manager Essentials,
which gathers the following database information from HPOV:
` Device names and IP addresses
` Community strings
HPOV
Note This section assumes that HP Network Node Manager Release 5.0 is already installed on
a Solaris workstation.
Describing the advanced capabilities of HPOV is outside the scope of this document. For more
information, go to http://ovweb.external.hp.com/lpe/doc_serv/ and http://www.openview.hp.com
For Cisco IOS SNMP configurations, see the “Task 1—Enabling SNMP in a Cisco IOS Device” section
on page 41.
Step 1 Start HPOV from the command line by entering the ovw& command from the /opt/OV/bin directory:
aurora:/opt/OV/bin ->ovw&
[1] 5079
Step 2 Verify that all the HPOV daemons are running by entering the ovstatus command from the root
directory:
aurora:/ ->ovstatus
object manager name: OVsPMD
state: RUNNING
PID: 430
exit status: -
Note If a daemon is not running, try restarting it by using the commands ovstop
daemon-name and ovstart daemon-name. If a daemon is still not running, an
HPOV license issue may exist. For more information, go to
http://www.openview.hp.com
Step 3 From HPOV, enter the SNMP community strings and target loopback IP addresses for each Cisco IOS
device. From the Options menu, select SNMP Configuration.
In the SNMP Configuration screen, enter the following information:
Target field—The target loopback IP address (for example, 172.21.10.1)
Community field—The Read-Only (RO) community string (for example, 5urf5h0p)
Set Community field—The Read-Write (RW) community string (for example, 5crapmeta1)
Note Accept the default SNMP parameters in the other fields in the SNMP Configuration
screen.
Caution Do not use the SNMP community strings “public,” “private,” or “cisco.” These strings are
well-known within the industry, and they are common defaults. These strings are open
invitations to attacks—even if you use filters.
Step 1 From the Root screen, double click the planet Earth Internet icon.
Step 2 Inspect the top-level map of the discovered devices in your network.
Field Description
Changing SNMP sysobjectID Indicates SNMP is working and the system identifier for the device
to .1.3.6.1.4.1.9.1.162 was found. This field appears only the first time a device is
successfully polled.
HPOV changes a generic router icon into a Cisco device icon after
the sysobjectID is found. The trailing number series, for example
.1.3.6.1.4.1.9.1.162, is the OID that identifies a node as a
Cisco device.
Supported versions Describes which versions of SNMP are supported by HPOV, such as
SNMPv1 and SNMPv2C.
Verify node name Verifies the node name is valid.
Field Description
Interface Confirms the interfaces were successfully pinged.
Get system description Verifies that the system description information was collected, so
you can identify the software version running on the device.
This action performs one ICMP echo, one TCP connection, and one SNMP get. SNMP is working if the
“OK” message appears under the SNMP Get field.
Table 32 describes the important fields in Figure 29.
Step 1 Poll a different device to see if it responds to SNMP. If the device responds, HPOV is not the problem.
Step 2 Ping the device that is not responding. If the ping works, the devices are communicating.
Note A firewall in the communication path can block ping and SNMP packets.
Options:
-d dump ASN.1 packet trace
-v version protocol version (1 or 2c)
-c community community string
-p port remote port
-t timeout retransmission timeout (1/10th seconds)
-r retries maximum retransmission attempts
Caution Overpolling the wrong OIDs overloads CPUs and crashes network devices.
Setting up alarms for different kinds of traps is outside the scope of this document.
To verify that HPOV is receiving traps from devices in the network, follow these steps:
Step 1 Open the All Events Browser. From the Fault menu, select Events.
Step 2 Force a trap to be sent into the browser by manually causing a fault. Pull out a card on a Cisco device
or shut down an interface.
Caution Do not shut down a communication link that can cause a service outage.
Step 1 From the top-level map, double click on an access server icon. The available interfaces and ports appear.
Color legend:
Green—The port is managed, and it is up.
Blue—The port is managed, but it is administratively down on the Cisco IOS.
Tan—The port is unmanaged.
Red—The port is managed, but it is in a down state.
Note You must unmanage the serial and asynchronous ports, which appear tan.
Tips When the status of an object changes (to managed or unmanaged), HPOV switches to
synchronization mode.
Caution Deleting a device from a submap removes the device from the database. To load a device
back into the database, see the “Using the HPOV CLI to Enter a Device into the Database”
section on page 115.
To manually re-structure device maps to adequately represent your network and turn off the
automatic-layout function for the top-level map, follow these steps:
Step 1 Re-structure the top-level map by selecting and moving device icons. For example, put a collapsed
backbone in the center of the map; then, position devices around the backbone.
Step 2 Go to View.
Step 3 Select Automatic Layout.
Step 4 Choose Off For This Submap.
After a filter is set up, HPOV will not discover devices unless they are defined by the filter. Edit the
filter each time a new device is added to the network.
For more information about discovery filters, go to http://www.openview.hp.com
Step 2 Edit the filters file by using a text editor to include a node list and a filter list for your network
environment:
aurora:/etc/opt/OV/share/conf/C ->vi filters
//
// @(#)$OV_CONF/$LANG/filters
// @(#)HP OpenView NNM Release B.05.01 Jun 21 1997
// @(#)Copyright (c) 1990-1997 Hewlett-Packard Company
// $Revision: /main/TORNADO/NNM_NT/5 $ $Date: 1997/01/13 19:35 UTC $
//
// This is the default filter file. These filters are examples
// which may be useful in your environment. Feel free to modify
// these filters and/or add your own. See OVfilterIntro(5)
// for more information on this file.
//
// Sets are a simple way to list string values to test
// against in a filter. The "IN" operator tests a field value
// for membership in a set defined here.
//
Sets {
//
// These are simple examples of sets.
//
servers "Set of Servers" { "sv1", "sv2", "sv3" }
gateways "Backbone gateways " { "gw1", "gw2", "gw3" }
TheNetNodes "TheNet Node List" { "AS5800-1", “AS5800-2" }
}
.
.
.
FilterExpressions {
//
// The following combines the two set filters
// defined above into one FilterExpression.
// It works unmodified as a discovery filter.
// To work as a map filter, network and segment filtering
// must be added (see below).
VitalNodes "All Gateways and Servers" { GatewaysSet || ServersSet }
//
// One can turn the filters defined above into viable map or
// topology filters by simply adding "|| NetsNSegs". (Doing so
// does not invalidate the filters as discovery
// filters. It just adds a superfluous test.)
//
VitalNodesMap "All nets & segs, but only gateway and server nodes"
{ GatewaysSet || ServersSet || NetsNSegs}
LocalLANView "All nets & segs, but only local nodes"
{ LocalLAN || NetsNSegs }
NetInfrastructure "Any network connecting device and what they connect"
{ Routers || Bridges || Hubs || NetsNSegs }
NetBackbone "Networks and gateways/routers"
{ Routers || Networks }
Step 1 This step ensures that new host entries are safely loaded in to the database. Shutdown the netmon
daemon by entering the ovstop netmon command from the root directory. All automatic network
polling and database updates stops.
aurora:/ ->ovstop netmon
aurora:/ ->ovstatus netmon
object manager name: netmon
state: NOT_RUNNING
PID: 450
last message: Exited due to user request
exit status: Exit(0)
Step 2 To load new devices in to the database, enter the loadhosts -m command from the root directory
followed by a single netmask for the devices. Include an end of file statement (EOF) to enter multiple
lines with one return.
aurora:/ ->loadhosts -m 255.255.255.0 <<EOF
> 10.10.10.104 hostname
> 14.14.14.14 host2name
> EOF
aurora:/ ->
Note Enter devices by using a DNS format (IP address then hostname). Use spaces (not
tabs) to separate IP addresses from hostnames.
Step 4 Go to the GUI and look for the new devices that appear in the new object holding area.
Step 5 Perform a demand poll on each device to get the sysobjectIDs. After the demand poll is performed,
HPOV puts each new device into its correct place in the map.
Reference URL
CiscoWorks 2000 TAC Support Page—Provides links to http://www.cisco.com/pcgi-bin/Support/
technical information for implementing, operating, and PSP/psp_view.pl?p=Software:CiscoWor
troubleshooting Cisco Works 2000. ks2000
CiscoWorks 2000 Documentation Set—A collection of http://www.cisco.com/univercd/cc/td/do
configuration guides and reference manuals. c/product/rtrmgmt/cw2000/index.htm
Note Alternatively, you can use Cisco Works for Switched Internetworking (CWSI) to
discover devices instead of using HPOV.
To import the list of devices and SNMP community strings from HPOV into CW2000 RME, follow
these steps:
Step 1 Verify that the basic setup for HPOV is working correctly.
Incorrect SNMP community strings prevent polling cycles. For basic verification steps, see the
“Task 7—Using HP OpenView to Create the SNMP Framework” section on page 101.
Step 2 From the root directory, verify that the HPOV database daemon is running in the background by
entering the ovstatus ovwdb command:
aurora:/ ->ovstatus ovwdb
object manager name: ovwdb
state: RUNNING
PID: 442
last message: Initialization complete.
exit status: -
aurora:/ ->
Note If a daemon is not running, try restarting it by using the commands ovstop
daemon-name and ovstart daemon-name. If a daemon is still not running, an
HPOV license issue may exist. For more information, go to
http://www.openview.hp.com
38628
Step 7 Click Next.
The devices are imported and a status summary appears.
Step 8 Click Update until you see all the devices classified as managed devices.
A constant pending or conflicting state indicates a problem that requires resolution:
Inspect the details of the device.
Verify that the SNMP community strings are correct.
Step 1 From the Admin menu, click on Availability: Change Polling Options.
Step 2 In the Select Polled Views screen, select All Views and All Polled Views.
38629
Step 2 Click a device to become familiar with the different management elements. Green arrows indicate
devices that are up. Red arrows indicate devices that are down.
Step 3 To turn on continuous availability monitoring and reporting, go to the Tasks menu. Click on
Availability: Availability Monitor.
38630
Step 5 Select one or more devices.
Step 6 Click Finish.
Step 7 Inspect the available elements for the devices.
To back up the Cisco IOS start-up configuration files for devices within the network, follow these steps:
Step 1 From the Tasks menu, select Device Configuration: Update Archive.
Using CiscoView
CiscoView is a GUI-based device management software application that lets you access dynamic status,
statistics, and comprehensive configuration information for Cisco products.
To inspect device-specific characteristics on different Cisco devices, follow these steps:
D H
L
N
line requirements 31
loadhosts -m command 115 network topology, dial NMS 30
logging, See syslog 67 NTP
logging buffered command 75 about 69
logging command 75 client, setting up 72
logging console command 75 client, troubleshooting 74
logging facility command 75 enabling on a Cisco IOS device 71
logging trap command 75 verifying 71
loopback address 34 ntp clock-period command 71
ntpq -p command 73
ntp server command 71
M
ntp update-calendar command 71
MIBs
about 16
O
downloading from Cisco 46
exploring by using UCD-SNMP 45 OIDs 38
ftp.cisco.com 46 circuit utilization 54
new dial features 38 description 16
OIDs for MRTG 54 modem information 54
recommended for the dial NMS 37 user information 54
modem call records OpenView, See HP OpenView 101
about 69 operation tasks for a dial NMS 35
Cisco IOS configuration 75 out-of-band console 83
modems ovstatus command 102, 115
call records 70, 75 ovstop command 115
modulation trends 69 ovw& command 102
OIDs to poll 55
MRTG
P
configuration files, editing 59, 60
design 32 performance management
dial counters 54, 59 CLI commands 27, 29
electronic template 60 Connection Success Rate 57
functions 53 OIDs to query 54
installing 59 planning questionnaire 25
HTTP 86 SNMPv2 19
xntpd command 73
T
T3 cards 31
TACACS+ design 26, 29
tail -f command 78
terminal server, setting up 83
topology
NOC 30
POP 30
touch command 77
troubleshooting
HP OpenView 108
terminal server 85
using modem call records 69, 75
using NTP 69
using syslog 69
UCD-SNMP
about 45
design 32
downloading MIBs 46
installing 46
MIBs for dial, exploring 46
web-based access, setting up 49
web site 46