CISCO-LOCAL-DIRECTOR-MIB

All MIBs › CISCO-LOCAL-DIRECTOR-MIB

Organization: Cisco Systems, Inc.

Last Updated: 2001-05-14

Category: Cisco Devices, Web and Application Servers

Description: Manages Cisco LocalDirector legacy load balancer virtual servers, real servers, and session statistics.

Start monitoring vendor-neutral, standards-based MIB, any SNMPv3-capable network device (SNMP engine identity/boot/clock status) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

What Is CISCO-LOCAL-DIRECTOR-MIB?

CISCO-LOCAL-DIRECTOR-MIB manages the legacy Cisco LocalDirector, a dedicated hardware load-balancing appliance that distributed TCP traffic across a pool of "real" servers behind one or more publicly reachable "virtual" server addresses. It exposes configuration and statistics data for virtual servers and their bound real servers, including IP address, port, bind ID, weight, and cumulative connection/packet/byte counters. It is used to monitor the software/operational status and performance of the load-balancing service, tracking cldVirtualState to confirm a virtual server is up and watching cldVirtualTotalConnections/cldVirtualTotalPackets/cldVirtualTotalBytes for traffic-volume anomalies or a real server silently dropping out of rotation. It is a self-contained, LocalDirector-specific MIB predating more modern Cisco load-balancing MIBs. It is typically deployed on legacy Cisco LocalDirector 400/416 series appliances at Internet-facing data center edges providing simple TCP load balancing. Engineers still operating or decommissioning a legacy cisco local director appliance typically consult this MIB to confirm real-server status before migrating load-balancing duties to a modern platform.

IPNetwork Monitor allows you to monitor SNMP objects defined in CISCO-LOCAL-DIRECTOR-MIB. Use the built-in SNMP Monitoring Browser to explore available variables, view their current values and descriptions, and select the objects you want to monitor. You can then create SNMP monitors, configure thresholds, and receive alerts when monitored values change.

Supported Devices

Cisco LocalDirector 400/416 series load balancer

Monitoring Examples

An admin would poll cldVirtualTable/cldVirtualTableEntry, keyed by cldVirtualIpAddress and cldVirtualPort, to check cldVirtualState and cldVirtualWeight for each virtual server, then cross-reference cldRealTable/cldRealTableEntry to see which real servers are currently bound. cldVirtualTotalConnections and cldVirtualTotalBytes reveal traffic load per virtual server over time. A virtual server whose cldVirtualState shows down, or whose connection counters stop incrementing, would indicate that all its bound real servers have failed or been taken out of rotation.

What Can Be Monitored

virtual server operational state
bound real servers
connection count
packet count
byte count
server weight

Imported Objects

From CISCO-SMI

ciscoMgmt

OBJECT-IDENTITY

From SNMP-FRAMEWORK-MIB

SnmpAdminString

From SNMPv2-CONF

MODULE-COMPLIANCE
NOTIFICATION-GROUP
OBJECT-GROUP

From SNMPv2-SMI

Counter32
Integer32
IpAddress
MODULE-IDENTITY
NOTIFICATION-TYPE
OBJECT-TYPE

From SNMPv2-TC

TEXTUAL-CONVENTION
TimeStamp

How to Use in IPNetwork Monitor

Example using cldeRealTotalConnections OID:

Select a Cisco LocalDirector 400/416 series load balancer (legacy) as the target host to create a monitor — the SNMP service should be up and running on it. Click New Monitor, then check SNMP Custom on the Favorites tab, click Next, and confirm the host. On the next page, click Select... to open the built-in SNMP MIB Browser and type cldeRealTotalConnections into the Find box to locate it in the OID tree, selecting the specific row/instance you want to monitor since this is a table column, then select it and click OK. The total number of connections to this machine since reboot. On the monitor's Main parameters page you can set the target's SNMP port (default 161), credentials, polling interval, and other settings — see the SNMP Monitor help for details. On the State conditions and Alerting tabs, configure when the monitor should change state and trigger an alert; since this is a Counter32-type OID, Value bounds is the most useful condition here — trigger an alert if the counter increases sharply between polls relative to its normal baseline, since an unexpected spike often reflects a real change in traffic or activity. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
ciscoLocalDirectorMIB	1.3.6.1.4.1.9.9.99			The MIB module to view information about LocalDirector. The Cisco LocalDirector is a device designed for the purpose of load balancing TCP traffic at an Internet site. To implement load balancing, an IP address (and optionally a port and a 'bind ID') is chosen to be the publically accessible 'virtual machine'. Then a number of actual Internet servers are 'bound' to this virtual machine. The servers are called 'real machines'. The relationships between virtual and real machines can be one to many, many to one, or many to many. More detailed information about the LocalDirector is available in the 'Cisco LocalDirector Installation and Configuration Guide', available online at www.cisco.com.
ciscoLocalDirectorMIBObjects	1.3.6.1.4.1.9.9.99.1
cldVirtualMachine	1.3.6.1.4.1.9.9.99.1.1
cldVirtualTable	1.3.6.1.4.1.9.9.99.1.1.1		not-accessible	Information about all Virtual machines that exist on LocalDirector.
cldVirtualTableEntry	1.3.6.1.4.1.9.9.99.1.1.1.1		not-accessible	A LocalDirector Virtual Table entry. Entries are added to this table via the 'virtual' command on the command line interface.
IP cldVirtualIpAddress	1.3.6.1.4.1.9.9.99.1.1.1.1.1	IpAddress	not-accessible	The IP address of the virtual machine.
I32 cldVirtualPort	1.3.6.1.4.1.9.9.99.1.1.1.1.2	Integer32	not-accessible	The TCP port of the virtual machine (default is 0, which is all ports).
I32 cldVirtualBindID	1.3.6.1.4.1.9.9.99.1.1.1.1.3	Integer32	not-accessible	The Bind ID of the virtual machine (default is 0, which is for all clients.
CLD cldVirtualState	1.3.6.1.4.1.9.9.99.1.1.1.1.4	CldMachineState	read-only	The service state of the virtual machine.
C32 cldVirtualTotalConnections	1.3.6.1.4.1.9.9.99.1.1.1.1.5	Counter32	read-only	The total number of connections to/from the virtual machine since reboot.
C32 cldVirtualTotalPackets	1.3.6.1.4.1.9.9.99.1.1.1.1.6	Counter32	read-only	The total number of packets to/from the virtual machine since reboot.
C32 cldVirtualTotalBytes	1.3.6.1.4.1.9.9.99.1.1.1.1.7	Counter32	read-only	The total number of bytes to/from the virtual machine since reboot.
I32 cldVirtualWeight	1.3.6.1.4.1.9.9.99.1.1.1.1.8	Integer32	read-only	The weight reflects the availability of a virtual machine, which is the total weights/availability of all real machines bound the virtual machine.
cldeVirtualTable	1.3.6.1.4.1.9.9.99.1.1.2		not-accessible	Information about all Virtual machines that exist on LocalDirector.
cldeVirtualTableEntry	1.3.6.1.4.1.9.9.99.1.1.2.1		not-accessible	A LocalDirector Virtual Table entry. Entries are added to this table via the 'virtual' command on the command line interface.
IP cldeVirtualIpAddress	1.3.6.1.4.1.9.9.99.1.1.2.1.1	IpAddress	not-accessible	The IP address of the virtual machine.
I32 cldeVirtualPort	1.3.6.1.4.1.9.9.99.1.1.2.1.2	Integer32	not-accessible	The TCP port of the virtual machine (default is 0, which is all ports).
I32 cldeVirtualBindID	1.3.6.1.4.1.9.9.99.1.1.2.1.3	Integer32	not-accessible	The Bind ID of the virtual machine (default is 0, which is for all clients.
MAC cldeVirtualProtocol	1.3.6.1.4.1.9.9.99.1.1.2.1.4	MachineProtocol	not-accessible	The TCP/UDP protocol field value used in sending packets to this Virtual Server.
CLD cldeVirtualState	1.3.6.1.4.1.9.9.99.1.1.2.1.5	CldMachineState	read-only	The service state of the virtual machine.
C32 cldeVirtualTotalConnections	1.3.6.1.4.1.9.9.99.1.1.2.1.6	Counter32	read-only	The total number of connections to/from the virtual machine since reboot.
C32 cldeVirtualTotalPackets	1.3.6.1.4.1.9.9.99.1.1.2.1.7	Counter32	read-only	The total number of packets to/from the virtual machine since reboot.
C32 cldeVirtualTotalBytes	1.3.6.1.4.1.9.9.99.1.1.2.1.8	Counter32	read-only	The total number of bytes to/from the virtual machine since reboot.
I32 cldeVirtualWeight	1.3.6.1.4.1.9.9.99.1.1.2.1.9	Integer32	read-only	The weight reflects the availability of a virtual machine, which is the total weights/availability of all real machines bound the virtual machine.
cldexVirtualTable	1.3.6.1.4.1.9.9.99.1.1.3		not-accessible	Information about all Virtual machines that exist on LocalDirector.
cldexVirtualTableEntry	1.3.6.1.4.1.9.9.99.1.1.3.1		not-accessible	A LocalDirector Virtual Table entry. Entries are added to this table via the 'virtual' command on the command line interface.
IP cldexVirtualIpAddress	1.3.6.1.4.1.9.9.99.1.1.3.1.1	IpAddress	not-accessible	The IP address of the virtual machine.
I32 cldexVirtualPort	1.3.6.1.4.1.9.9.99.1.1.3.1.2	Integer32	not-accessible	The TCP port of the virtual machine (default is 0, which is all ports).
I32 cldexVirtualBindID	1.3.6.1.4.1.9.9.99.1.1.3.1.3	Integer32	not-accessible	The Bind ID of the virtual machine (default is 0, which is for all clients.
MAC cldexVirtualProtocol	1.3.6.1.4.1.9.9.99.1.1.3.1.4	MachineProtocol	not-accessible	The TCP/UDP protocol field value used in sending packets to this Virtual Server.
STR cldexVirtualRule	1.3.6.1.4.1.9.9.99.1.1.3.1.5	SnmpAdminString	not-accessible	The administratively assigned content rule name associated with this Virtual Server.
CLD cldexVirtualState	1.3.6.1.4.1.9.9.99.1.1.3.1.6	CldMachineState	read-only	The service state of the virtual machine.
C32 cldexVirtualTotalConnections	1.3.6.1.4.1.9.9.99.1.1.3.1.7	Counter32	read-only	The total number of connections to/from the virtual machine since reboot.
C32 cldexVirtualTotalPackets	1.3.6.1.4.1.9.9.99.1.1.3.1.8	Counter32	read-only	The total number of packets to/from the virtual machine since reboot.
C32 cldexVirtualTotalBytes	1.3.6.1.4.1.9.9.99.1.1.3.1.9	Counter32	read-only	The total number of bytes to/from the virtual machine since reboot.
I32 cldexVirtualWeight	1.3.6.1.4.1.9.9.99.1.1.3.1.10	Integer32	read-only	The weight reflects the availability of a virtual machine, which is the total weights/availability of all real machines bound the virtual machine.
cldRealMachine	1.3.6.1.4.1.9.9.99.1.2
cldRealTable	1.3.6.1.4.1.9.9.99.1.2.1		not-accessible	Information about all Real machines that exist on LocalDirector.
cldRealTableEntry	1.3.6.1.4.1.9.9.99.1.2.1.1		not-accessible	A LocalDirector Real Table entry. Entries are added via the 'real' command on the command line interface.
IP cldRealIpAddress	1.3.6.1.4.1.9.9.99.1.2.1.1.1	IpAddress	not-accessible	The IP address of the real machine.
I32 cldRealPort	1.3.6.1.4.1.9.9.99.1.2.1.1.2	Integer32	not-accessible	The TCP port of the real machine (default is 0, which is all ports).
CLD cldRealState	1.3.6.1.4.1.9.9.99.1.2.1.1.3	CldMachineState	read-only	The service state of the real machine (defaul is 0, which is all clients.
C32 cldRealTotalConnections	1.3.6.1.4.1.9.9.99.1.2.1.1.4	Counter32	read-only	The total number of connections to this machine since reboot.
C32 cldRealTotalPackets	1.3.6.1.4.1.9.9.99.1.2.1.1.5	Counter32	read-only	The total number of packets to/from the real machine since reboot.
C32 cldRealTotalBytes	1.3.6.1.4.1.9.9.99.1.2.1.1.6	Counter32	read-only	The total number of bytes to/from the real machine since reboot.
I32 cldRealWeight	1.3.6.1.4.1.9.9.99.1.2.1.1.7	Integer32	read-write	The weight for the real machine.
cldeRealTable	1.3.6.1.4.1.9.9.99.1.2.2		not-accessible	Information about all Real machines that exist on LocalDirector.
cldeRealTableEntry	1.3.6.1.4.1.9.9.99.1.2.2.1		not-accessible	A LocalDirector Real Table entry. Entries are added via the 'real' command on the command line interface.
IP cldeRealIpAddress	1.3.6.1.4.1.9.9.99.1.2.2.1.1	IpAddress	not-accessible	The IP address of the real machine.
I32 cldeRealPort	1.3.6.1.4.1.9.9.99.1.2.2.1.2	Integer32	not-accessible	The TCP port of the real machine (default is 0, which is all ports).
MAC cldeRealBindID	1.3.6.1.4.1.9.9.99.1.2.2.1.3	MachineBindID	not-accessible	The Bind ID of the Real Server.
MAC cldeRealProtocol	1.3.6.1.4.1.9.9.99.1.2.2.1.4	MachineProtocol	not-accessible	The TCP/UDP protocol field value used in sending packets to this Real Server.
CLD cldeRealState	1.3.6.1.4.1.9.9.99.1.2.2.1.5	CldMachineState	read-only	The service state of the real machine (defaul is 0, which is all clients.
C32 cldeRealTotalConnectionsEx	1.3.6.1.4.1.9.9.99.1.2.2.1.6	Counter32	read-only	The total number of connections to this machine since reboot.
C32 cldeRealTotalPackets	1.3.6.1.4.1.9.9.99.1.2.2.1.7	Counter32	read-only	The total number of packets to/from the real machine since reboot.
C32 cldeRealTotalBytes	1.3.6.1.4.1.9.9.99.1.2.2.1.8	Counter32	read-only	The total number of bytes to/from the real machine since reboot.
I32 cldeRealWeight	1.3.6.1.4.1.9.9.99.1.2.2.1.9	Integer32	read-write	The weight for the real machine.
cldFailover	1.3.6.1.4.1.9.9.99.1.3
CLD cldFailoverEnabled	1.3.6.1.4.1.9.9.99.1.3.1	CldFailoverEnabledState	read-only	Is failover mechanism enabled.
CLD cldFailoverCableStatus	1.3.6.1.4.1.9.9.99.1.3.2	CldFailoverCableState	read-only	Status of failover serial cable.
CLD cldFailoverUnitType	1.3.6.1.4.1.9.9.99.1.3.3	CldFailoverUnitTypeDescriptor	read-only	The failover unit type, which is determined by Failover serial cable; primary or secondary.
CLD cldFailoverUnitStatus	1.3.6.1.4.1.9.9.99.1.3.4	CldFailoverUnitStatusDescriptor	read-only	The unit's failover activity; active or standby.
TIM cldFailoverActiveTimeStamp	1.3.6.1.4.1.9.9.99.1.3.5	TimeStamp	read-only	The value of sysUpTime when unit went active.
ciscoLocalDirectorMIBNotificationPrefix	1.3.6.1.4.1.9.9.99.2
ciscoLocalDirectorMIBNotifications	1.3.6.1.4.1.9.9.99.2.0
NTF ciscoLocalDirectorVirtualStateChange	1.3.6.1.4.1.9.9.99.2.0.1			When a Virtual machine changes state, a notification is sent.
NTF ciscoLocalDirectorRealStateChange	1.3.6.1.4.1.9.9.99.2.0.2			When a Real machine changes state, a notification is sent.
NTF ciscoLocalDirectorFailoverEnableChange	1.3.6.1.4.1.9.9.99.2.0.3			Failover is turned on/off.
NTF ciscoLocalDirectorFailoverCableChange	1.3.6.1.4.1.9.9.99.2.0.4			Failover's serial cable has a status change.
NTF ciscoLocalDirectorFailoverUnitStatus	1.3.6.1.4.1.9.9.99.2.0.5			Failover event occurs.
NTF ciscoLocalDirectorEVirtualStateChange	1.3.6.1.4.1.9.9.99.2.0.6			When a Virtual machine changes state, a notification is sent.
NTF ciscoLocalDirectorERealStateChange	1.3.6.1.4.1.9.9.99.2.0.7			When a Real machine changes state, a notification is sent.
NTF ciscoLocalDirectorExVirtualStateChange	1.3.6.1.4.1.9.9.99.2.0.8			When a Virtual machine changes state, a notification is sent.
ciscoLocalDirectorMIBConformance	1.3.6.1.4.1.9.9.99.3
ciscoLocalDirectorMIBCompliances	1.3.6.1.4.1.9.9.99.3.1
ciscoLocalDirectorMIBCompliance	1.3.6.1.4.1.9.9.99.3.1.1			The compliance statement for entities which implement the Cisco LocalDirector MIB.
ciscoLocalDirectorMIBGroups	1.3.6.1.4.1.9.9.99.3.2
ciscoLocalDirectorMIBGroup	1.3.6.1.4.1.9.9.99.3.2.1			A collection of objects providing the LocalDirector MIB capability.
ciscoLocalDirectorFailoverGroup	1.3.6.1.4.1.9.9.99.3.2.2			A collection of objects providing the LocalDirector MIB capability.
ciscoLocalDirectorEMIBGroup	1.3.6.1.4.1.9.9.99.3.2.3			A collection of objects providing the LocalDirector MIB capability.
ciscoLocalDirectorNotificationGroup	1.3.6.1.4.1.9.9.99.3.2.4			A collection of objects providing the LocalDirector MIB capability.
ciscoLocalDirectorNotificationGroupRev1	1.3.6.1.4.1.9.9.99.3.2.5			A collection of objects providing the LocalDirector MIB capability.
ciscoLocalDirectorEMIBGroupRev1	1.3.6.1.4.1.9.9.99.3.2.6			A collection of objects providing the LocalDirector MIB capability.
ciscoLocalDirectorNotificationGroupRev2	1.3.6.1.4.1.9.9.99.3.2.7			A collection of objects providing the LocalDirector MIB capability.

RFC description

Manages Cisco LocalDirector load balancer virtual and real server configurations.

Start monitoring Cisco LocalDirector 400/416 series load balancer (legacy) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

Download CISCO-LOCAL-DIRECTOR-MIB