Table Of Contents
DistributedDirector MIB Support
Related Features and Technologies
Supported Standards, MIBs, and RFCs
Enabling DistributedDirector SNMP Notifications
Specifying the Recipient of an SNMP Notification
Verifying DistributedDirector Notification Information
Enabling DistributedDirector SNMP Notifications Example
Specifying the Recipient of an SNMP Notification Example
DistributedDirector MIB Support
First Published: February 25, 2002Last Updated: February 27, 2009
Note
Effective with Cisco IOS Release 12.4(24)T, this feature is not available in Cisco IOS software.
Feature History
This document describes DistributedDirector MIB support and the enhancements and modifications made to the Cisco IOS Simple Network Management Protocol (SNMP) infrastructure in order to support DistributedDirector in Cisco IOS Release 12.2(8)T. It includes the following sections:
•
Supported Standards, MIBs, and RFCs
Feature Overview
Network management takes place between two major types of systems: those in control, called managing systems, and those observed and controlled, called managed systems. The most common type of managing system is called a network management system (NMS). Managed systems can include hosts, servers, or network components such as routers or intelligent repeaters.
To promote interoperability, cooperating systems must adhere to a common framework and a common language, called a protocol. In the Internet network management framework, that protocol is the SNMP.
In a managed device, specialized low-impact software modules, called agents, access information about the device and make it available to the NMS. Managed devices maintain values for a number of variables and report those, as required, to the NMS. For example, an agent might report such data as the number of bytes and packets passing in and out of the device, or the number of broadcast messages sent and received. In the Internet network management framework, each variable is referred to as a managed object, which is anything that an agent can access and report back to the NMS.
All managed objects are contained in the Management Information Base (MIB), which is a database of the managed objects. The managed objects, or variables, can be set or read to provide information on network devices and interfaces. An NMS can control a managed device by sending a message to an agent of that managed device requiring the device to change the value of one or more of its variables.
The Cisco DistributedDirector MIB provides MIB support for DistributedDirector. This MIB contains DistributedDirector statistics, configurations, and status.
The DistributedDirector MIB contains five groups of object type definitions:
•
ciscoDistDirGeneralGroup—A group of objects related to DistributedDirector general configurations, statistics, and status.
•
ciscoDistDirHostGroup—A group of objects related to DistributedDirector host-specific configurations, statistics, and status.
•
ciscoDistDirServerGroup—A group of objects related to DistributedDirector server-specific configurations, statistics, and status.
•
ciscoDistDirMappingGroup—A group of objects related to associations between DistributedDirector host names and real servers.
•
ciscoDistDirNotificatonGroup—A group of objects related to DistributedDirector significant events.
The DistributedDirector MIB defines the following tables:
•
cddGeneralMetricProfTable—DistributedDirector metric profiles. A profile contains priority and weight values of DistributedDirector metrics, which can be applied to specific hosts or to the DistributedDirector default configuration.
•
cddHostTable—DistributedDirector virtual host name or subdomain-specific configurations, statistics, and status entries.
•
cddHostConnectCfgTable—DistributedDirector per-host server connect test configuration information entries.
•
cddHostTolCfgTable—DistributedDirector per-host priority-level metric tolerance configuration information entries.
•
cddServerTable—DistributedDirector server-specific information entries. This information includes the configuration parameters and statistics for each server.
•
cddServerPortTable—DistributedDirector server port-specific information entries. This information includes the configuration parameters, statistics, and availability status for each service port on servers.
•
cddServerPortMetricTable—DistributedDirector per-service per-metric weight entries.
•
cddHostServerMappingTable—DistributedDirector associations of virtual host name to real server.
The DistributedDirector MIB defines the following notifications:
•
ciscoDistDirEventServerUp—This trap is generated whenever a distributed server changes to the "up" state.
•
ciscoDistDirEventServerDown—This trap is generated whenever a distributed server changes to the "down" state.
•
ciscoDistDirEventHitRateHigh—This trap is generated whenever the incoming Domain Name system (DNS) HTTP query rate reaches a certain threshold. Use the Event MIB described in RFC 2981 to control the trigger of this notification.
The ciscoDistDirEventServerUp and ciscoDistDirEventServerDown notifications can be enabled or disabled using the Cisco IOS snmp-server enable traps director and snmp-server host commands.
The snmp-server host command is used in conjunction with the snmp-server enable traps director command. Use the snmp-server enable traps director command to specify which DistributedDirector SNMP notifications are sent globally. For a host to receive most notifications, at least one snmp-server enable traps director command and the snmp-server host command for that host must be enabled.
Benefits
The DistributedDirector MIB provides network management functionality to DistributedDirector.
Restrictions
The DistributedDirector MIB implementation for Cisco IOS Release 12.2(8)T supports read-only capability to the objects defined in the MIB.
Related Features and Technologies
•
Event MIB
•
SNMP
•
Network management
Related Documents
•
The "Configuring SNMP Support" chapter of Cisco IOS Configuration Fundamentals Configuration Guide, Release 12.2
•
The "SNMP Commands" chapter of Cisco IOS Configuration Fundamentals Command Reference, Release 12.2
•
RFC 1157, "Simple Network Management Protocol"
•
Event MIB: RFC 2981, Event MIB
Supported Platforms
•
Cisco 2600 series
•
Cisco 3620 series
•
Cisco 3640 series
•
Cisco 3660 series
•
Cisco 7200 series
Determining Platform Support Through Cisco Feature Navigator
Cisco IOS software is packaged in feature sets that support specific platforms. To get updated information regarding platform support for this feature, access Cisco Feature Navigator. Cisco Feature Navigator dynamically updates the list of supported platforms as new platform support is added for the feature.
Cisco Feature Navigator is a web-based tool that enables you to quickly determine which Cisco IOS software images support a specific set of features and which features are supported in a specific Cisco IOS image. You can search by feature or release. Under the release section, you can compare releases side by side to display both the features unique to each software release and the features in common.
Cisco Feature Navigator is updated regularly when major Cisco IOS software releases and technology releases occur. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.
Supported Standards, MIBs, and RFCs
Standards
No new or modified standards are supported by this feature.
MIBs
•
Cisco DistributedDirector MIB (CISCO-DIST-DIRECTOR-MIB.my)
•
Event MIB (EVENT-MIB.my)
To obtain lists of supported MIBs by platform and Cisco IOS release, and to download MIB modules, go to the Cisco MIB website on Cisco.com at the following URL:
http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml
RFCs
•
Event MIB: RFC 2981, Event MIB
Prerequisites
DistributedDirector must be running on the router.
Configuration Tasks
See the following sections for configuration tasks for the DistributedDirector MIB support feature. Each task in the list is identified as either required or optional.
•
Enabling DistributedDirector SNMP Notifications (required)
•
Specifying the Recipient of an SNMP Notification (required)
Enabling DistributedDirector SNMP Notifications
To enable DistributedDirector SNMP notifications, use the following command in global configuration mode:
Command PurposeRouter(config)# snmp-server enable traps director
Enables DistributedDirector SNMP notifications.
To disable DistributedDirector SNMP notifications, use the following command in global configuration mode:
Command PurposeRouter(config)# no snmp-server enable traps director
Disables DistributedDirector SNMP notifications.
Specifying the Recipient of an SNMP Notification
To specify the recipient of a DistributedDirector SNMP notification, use the following command in global configuration mode:
To remove the specified recipient, use the following command in global configuration mode:
Command PurposeRouter(config)# no snmp-server host host-address director
Removes the recipient of a DistributedDirector SNMP notification.
Verifying DistributedDirector Notification Information
Enter the show running-config command to verify that DistributedDirector SNMP notification information is configured. Both server up and server down information is included, unless you specify one or the other.
Router# show running-configip host myhost 172.2.2.10 172.2.2.20 172.2.2.30...snmp-server enable traps director server-up server-downConfiguration Examples
This section provides the following configuration examples:
•
Enabling DistributedDirector SNMP Notifications Example
•
Specifying the Recipient of an SNMP Notification Example
Enabling DistributedDirector SNMP Notifications Example
In the following example, both ciscoDistDirEventServerUp and ciscoDistDirEventServerDown notifications are enabled:
Router(config)# snmp-server enable traps directorRouter# show running-configip host myhost 172.2.2.10 172.2.2.20 172.2.2.30...snmp-server enable traps director server-up server-downSpecifying the Recipient of an SNMP Notification Example
In the following example, the ciscoDistDirEventServerUp and ciscoDistDirEventServerDown notifications are to be sent to the host 10.0.0.1 using the community string defined as "public":
Router(config)# snmp-server host 10.0.0.1 public directorRouter# show snmpChassis:87684900 SNMP packets input0 Bad SNMP version errors0 Unknown community name0 Illegal operation for community name supplied0 Encoding errors0 Number of requested variables0 Number of altered variables0 Get-request PDUs0 Get-next PDUs0 Set-request PDUs0 SNMP packets output0 Too big errors (Maximum packet size 1500)0 No such name errors0 Bad values errors0 General errors0 Response PDUs0 Trap PDUsSNMP logging:enabledLogging to 10.0.0.1.162, 0/10, 0 sent, 0 dropped.Command Reference
The following commands are introduced or modified in the feature or features documented in this module. For information about these commands, see the Cisco IOS Network Management Command Reference at http://www.cisco.com/en/US/docs/ios/netmgmt/command/reference/nm_book.html. For information about all Cisco IOS commands, go to the Command Lookup Tool at http://tools.cisco.com/Support/CLILookup or to the Cisco IOS Master Commands List.
•
snmp-server enable traps director
•
snmp-server host
CCDE, CCENT, CCSI, Cisco Eos, Cisco HealthPresence, Cisco IronPort, the Cisco logo, Cisco Lumin, Cisco Nexus, Cisco Nurse Connect, Cisco Pulse, Cisco StackPower, Cisco StadiumVision, Cisco TelePresence, Cisco Unified Computing System, Cisco WebEx, DCE, Flip Channels, Flip for Good, Flip Mino, Flipshare (Design), Flip Ultra, Flip Video, Flip Video (Design), Instant Broadband, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn, Cisco Capital, Cisco Capital (Design), Cisco:Financed (Stylized), Cisco Store, and Flip Gift Card are service marks; and Access Registrar, Aironet, AllTouch, AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation, Continuum, EtherFast, EtherSwitch, Event Center, Explorer, Fast Step, Follow Me Browsing, FormShare, GainMaker, GigaDrive, HomeLink, iLYNX, Internet Quotient, IOS, iPhone, iQuick Study, IronPort, the IronPort logo, Laser Link, LightStream, Linksys, MediaTone, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, Network Registrar, PCNow, PIX, PowerKEY, PowerPanels, PowerTV, PowerTV (Design), PowerVu, Prisma, ProConnect, ROSA, ScriptShare, SenderBase, SMARTnet, Spectrum Expert, StackWise, The Fastest Way to Increase Your Internet Quotient, TransPath, WebEx, and the WebEx logo are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.
All other trademarks mentioned in this document or website are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0908R)
Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.
© 2002-2009 Cisco Systems, Inc. All rights reserved.

