CISCO-HSRP-MIB

File: CISCO-HSRP-MIB.mib (22048 bytes)

Imported modules

SNMPv2-SMI	SNMPv2-CONF	SNMPv2-TC
IF-MIB	CISCO-SMI

Imported symbols

MODULE-IDENTITY	NOTIFICATION-TYPE	OBJECT-TYPE
IpAddress	Unsigned32	MODULE-COMPLIANCE
NOTIFICATION-GROUP	OBJECT-GROUP	TEXTUAL-CONVENTION
DisplayString	TruthValue	RowStatus
MacAddress	ifIndex	ciscoMgmt

Defined Types

HsrpState
The current state of the HSRP protocol for a given HSRP group entry.
TEXTUAL-CONVENTION
	INTEGER	initial(1), learn(2), listen(3), speak(4), standby(5), active(6)

CHsrpGrpEntry
SEQUENCE
	cHsrpGrpNumber	Unsigned32
	cHsrpGrpAuth	DisplayString
	cHsrpGrpPriority	Unsigned32
	cHsrpGrpPreempt	TruthValue
	cHsrpGrpPreemptDelay	Unsigned32
	cHsrpGrpUseConfiguredTimers	TruthValue
	cHsrpGrpConfiguredHelloTime	Unsigned32
	cHsrpGrpConfiguredHoldTime	Unsigned32
	cHsrpGrpLearnedHelloTime	Unsigned32
	cHsrpGrpLearnedHoldTime	Unsigned32
	cHsrpGrpVirtualIpAddr	IpAddress
	cHsrpGrpUseConfigVirtualIpAddr	TruthValue
	cHsrpGrpActiveRouter	IpAddress
	cHsrpGrpStandbyRouter	IpAddress
	cHsrpGrpStandbyState	HsrpState
	cHsrpGrpVirtualMacAddr	MacAddress
	cHsrpGrpEntryRowStatus	RowStatus
	cHsrpGrpIpNone	TruthValue

Defined Values

ciscoHsrpMIB		1.3.6.1.4.1.9.9.106
The MIB module provides a means to monitor and configure the Cisco IOS proprietary Hot Standby Router Protocol (HSRP). Cisco HSRP protocol is defined in RFC2281. Terminology: HSRP is a protocol used amoung a group of routers for the purpose of selecting an 'active router' and a 'standby router'. An 'active router' is the router of choice for routing packets. A 'standby router' is a router that takes over the routing duties when an active router fails, or when preset conditions have been met. An 'HSRP group' or a 'standby group' is a set of routers which communicate using HSRP. An HSRP group has a group MAC address and a group Virtual IP address. These are the designated addresses. The active router assumes (i.e. inherits) these group addresses. 'Hello' messages are sent to indicate that a router is running and is capable of becoming the active or standby router. 'Hellotime' is the interval between successive HSRP Hello messages from a given router. 'Holdtime' is the interval between the receipt of a Hello message and the presumption that the sending router has failed.
MODULE-IDENTITY

ciscoHsrpMIBObjects		1.3.6.1.4.1.9.9.106.1
OBJECT IDENTIFIER

cHsrpGlobalConfig		1.3.6.1.4.1.9.9.106.1.1
OBJECT IDENTIFIER

cHsrpGroup		1.3.6.1.4.1.9.9.106.1.2
OBJECT IDENTIFIER

cHsrpConfigTimeout		1.3.6.1.4.1.9.9.106.1.1.1
The amount of time in minutes a row in cHsrpGrpTable can remain in a state other than active before being timed out.
Status: current	Access: read-write
OBJECT-TYPE
	Unsigned32	1..60

cHsrpGrpTable		1.3.6.1.4.1.9.9.106.1.2.1
A table containing information on each HSRP group for each interface.
Status: current	Access: not-accessible
OBJECT-TYPE
	SEQUENCE OF
		CHsrpGrpEntry

cHsrpGrpEntry		1.3.6.1.4.1.9.9.106.1.2.1.1
Information about an HSRP group. Management applications use cHsrpGrpRowStatus to control entry modification, creation and deletion. Setting cHsrpGrpRowStatus to 'active' causes the router to communicate using HSRP. The value of cHsrpGrpRowStatus may be set to 'destroy' at any time. Entries may not be created via SNMP without explicitly setting cHsrpGrpRowStatus to either 'createAndGo' or 'createAndWait'. Entries can be created and modified via the management protocol or by the device's local management interface. A management application wishing to create an entry should choose the ifIndex of the interface which is to be added as part of an HSRP group. Also, a cHsrpGrpNumber should be chosen. A group number is unique only amongst the groups on a particular interface. The value of the group number appears in packets which are transmitted and received on a LAN segment to which the router is connected. The application must select the group number as explained in the description for cHsrpGrpNumber. If the row is not active, and a local management interface command modifies that row, the row may transition to active state. A row which is not in active state will timeout after a configurable period (five minutes by default). This timeout period can be changed by setting cHsrpConfigTimeout.
Status: current	Access: not-accessible
OBJECT-TYPE
	CHsrpGrpEntry

cHsrpGrpNumber		1.3.6.1.4.1.9.9.106.1.2.1.1.1
This object along with the ifIndex of a particular interface uniquely identifies an HSRP group. Group numbers 0,1 and 2 are the only valid group numbers for TokenRing interfaces. For other media types, numbers range from 0 to 255. Each interface has its own set of group numbers. There's no relationship between the groups configured on different interfaces. Using a group number on one interface doesn't preclude using the same group number on a different interface. For example, there can be a group 1 on an Ethernet and a group 1 on Token Ring. More details can be found from RFC 2281.
Status: current	Access: not-accessible
OBJECT-TYPE
	Unsigned32	0..255

cHsrpGrpAuth		1.3.6.1.4.1.9.9.106.1.2.1.1.2
This is an unencrypted authentication string which is carried in all HSRP messages. An authentication string mismatch prevents a router interface from learning the designated IP address or HSRP timer values from other HSRP-enabled routers with the same group number. The function of this object is not to supply any sort of security-like authentication but rather to confirm that what's happening is what's intended. In other words, this is meant for sanity checking only.
Status: current	Access: read-create
OBJECT-TYPE
	DisplayString	Size(0..8)

cHsrpGrpPriority		1.3.6.1.4.1.9.9.106.1.2.1.1.3
The cHsrpGrpPriority helps to select the active and the standby routers. The router with the highest priority is selected as the active router. In the priority range of 0 to 255, 0 is the lowest priority and 255 is the highest priority. If two (or more) routers in a group have the same priority, the one with the highest ip address of the interface is the active router. When the active router fails to send a Hello message within a configurable period of time, the standby router with the highest priority becomes the active router. A router with highest priority will only attempt to overthrow a lower priority active router if it is configured to preempt. But, if there is more than one router which is not active, the highest priority non-active router becomes the standby router.
Status: current	Access: read-create
OBJECT-TYPE
	Unsigned32	0..255

cHsrpGrpPreempt		1.3.6.1.4.1.9.9.106.1.2.1.1.4
This object, if TRUE, indicates that the current router should attempt to overthrow a lower priority active router and attempt to become the active router. If this object is FALSE, the router will become the active router only if there is no such router (or if an active router fails).
Status: current	Access: read-create
OBJECT-TYPE
	TruthValue

cHsrpGrpPreemptDelay		1.3.6.1.4.1.9.9.106.1.2.1.1.5
This delay is the time difference between a router power up and the time it can actually start preempting the currently active router. When a router first comes up, it doesn't have a complete routing table. If it's configured to preempt, then it will become the Active router, but it will not be able to provide adequate routing services. The solution to this is to allow for a configurable delay before the router actually preempts the currently active router.
Status: current	Access: read-create
OBJECT-TYPE
	Unsigned32	0..3600

cHsrpGrpUseConfiguredTimers		1.3.6.1.4.1.9.9.106.1.2.1.1.6
HSRP routers learn a group's Hellotime or Holdtime from hello messages. The Hellotime is used to determine the frequency of generating hello messages when this router becomes the active or standby router. The Holdtime is the interval between the receipt of a Hello message and the presumption that the sending router has failed. If this object is TRUE, the cHsrpGrpConfiguredHelloTime and cHsrpGrpConfiguredHoldTime will be used. If it is FALSE, the Hellotime and Holdtime values are learned.
Status: current	Access: read-only
OBJECT-TYPE
	TruthValue

cHsrpGrpConfiguredHelloTime		1.3.6.1.4.1.9.9.106.1.2.1.1.7
If cHsrpGrpUseConfiguredTimers is true, cHsrpGrpConfiguredHelloTime is used when this router is an active router. Otherwise, the Hellotime learned from the current active router is used. All routers on a particular LAN segment must use the same Hellotime.
Status: current	Access: read-create
OBJECT-TYPE
	Unsigned32

cHsrpGrpConfiguredHoldTime		1.3.6.1.4.1.9.9.106.1.2.1.1.8
If cHsrpGrpUseConfiguredTimers is true, cHsrpGrpConfiguredHoldTime is used when this router is an active router. Otherwise, the Holdtime learned from the current active router is used. All routers on a particular LAN segment should use the same Holdtime. Also, the Holdtime should be at least three times the value of the Hellotime and must be greater than the Hellotime.
Status: current	Access: read-create
OBJECT-TYPE
	Unsigned32

cHsrpGrpLearnedHelloTime		1.3.6.1.4.1.9.9.106.1.2.1.1.9
If the Hellotime is not configured on a router, it can be learned from the Hello messages from active router, provided the Hello message is authenticated. If the Hellotime is not learned from a Hello message from the active router and it is not manually configured, a default value of 3 seconds is recommended.
Status: current	Access: read-only
OBJECT-TYPE
	Unsigned32

cHsrpGrpLearnedHoldTime		1.3.6.1.4.1.9.9.106.1.2.1.1.10
If the Holdtime is not configured on a router, it can be learned from the Hello message from the active router. Holdtime should be learned only if the Hello message is authenticated. If the Holdtime is not learned and it is not manually configured, a default value of 10 seconds is recommended.
Status: current	Access: read-only
OBJECT-TYPE
	Unsigned32

cHsrpGrpVirtualIpAddr		1.3.6.1.4.1.9.9.106.1.2.1.1.11
This is the primary virtual IP address used by this group. If this address is configured (i.e a non zero ip address), this value is used. Otherwise, the agent will attempt to discover the virtual address through a discovery process (which scans the hello messages).
Status: current	Access: read-create
OBJECT-TYPE
	IpAddress

cHsrpGrpUseConfigVirtualIpAddr		1.3.6.1.4.1.9.9.106.1.2.1.1.12
If this object is TRUE, cHsrpGrpVirtualIpAddr was a configured one. Otherwise, it indicates that cHsrpGrpVirtualIpAddr was a learned one.
Status: current	Access: read-only
OBJECT-TYPE
	TruthValue

cHsrpGrpActiveRouter		1.3.6.1.4.1.9.9.106.1.2.1.1.13
Ip Address of the currently active router for this group.
Status: current	Access: read-only
OBJECT-TYPE
	IpAddress

cHsrpGrpStandbyRouter		1.3.6.1.4.1.9.9.106.1.2.1.1.14
Ip Address of the currently standby router for this group.
Status: current	Access: read-only
OBJECT-TYPE
	IpAddress

cHsrpGrpStandbyState		1.3.6.1.4.1.9.9.106.1.2.1.1.15
The current HSRP state of this group on this interface.
Status: current	Access: read-only
OBJECT-TYPE
	HsrpState

cHsrpGrpVirtualMacAddr		1.3.6.1.4.1.9.9.106.1.2.1.1.16
Mac Addresses used are as specified in RFC 2281. For ethernet and fddi interfaces, a MAC address will be in the range 00:00:0c:07:ac:00 through 00:00:0c:07:ac:ff. The last octet is the hexadecimal equivalent of cHsrpGrpNumber (0-255). Some Ethernet and FDDI interfaces allow a unicast MAC address for each HSRP group. Certain Ethernet chipsets(LANCE Ethernet, VGANYLAN and QUICC Ethernet) only support a single Unicast Mac Address. In this case, only one HSRP group is allowed. For TokenRing interfaces, the following three MAC addresses are permitted (functional addresses): C0:00:00:01:00:00 C0:00:00:02:00:00 C0:00:00:04:00:00.
Status: current	Access: read-only
OBJECT-TYPE
	MacAddress

cHsrpGrpEntryRowStatus		1.3.6.1.4.1.9.9.106.1.2.1.1.17
The control that allows modification, creation, and deletion of entries. For detailed rules see the DESCRIPTION for cHsrpGrpEntry.
Status: current	Access: read-create
OBJECT-TYPE
	RowStatus

cHsrpGrpIpNone		1.3.6.1.4.1.9.9.106.1.2.1.1.18
This object specifies the disable HSRP IPv4 virtual IP address.
Status: current	Access: read-create
OBJECT-TYPE
	TruthValue

cHsrpMIBNotificationPrefix		1.3.6.1.4.1.9.9.106.2
OBJECT IDENTIFIER

cHsrpMIBNotifications		1.3.6.1.4.1.9.9.106.2.0
OBJECT IDENTIFIER

cHsrpStateChange		1.3.6.1.4.1.9.9.106.2.0.1
A cHsrpStateChange notification is sent when a cHsrpGrpStandbyState transitions to either active or standby state, or leaves active or standby state. There will be only one notification issued when the state change is from standby to active and vice versa.
Status: current	Access: read-create
NOTIFICATION-TYPE

cHsrpConformance		1.3.6.1.4.1.9.9.106.3
OBJECT IDENTIFIER

cHsrpCompliances		1.3.6.1.4.1.9.9.106.3.1
OBJECT IDENTIFIER

cHsrpComplianceGroups		1.3.6.1.4.1.9.9.106.3.2
OBJECT IDENTIFIER

cHsrpCompliance		1.3.6.1.4.1.9.9.106.3.1.1
The compliance statement for all hosts implementing the CISCO-HSRP-MIB.
Status: deprecated	Access: read-create
MODULE-COMPLIANCE

cHsrpComplianceRev1		1.3.6.1.4.1.9.9.106.3.1.2
The object group is deprecated by the cHsrpComplianceRev2
Status: deprecated	Access: read-create
MODULE-COMPLIANCE

cHsrpComplianceRev2		1.3.6.1.4.1.9.9.106.3.1.3
The compliance statement for all hosts implementing the CISCO-HSRP-MIB.
Status: current	Access: read-create
MODULE-COMPLIANCE

cHsrpConfigGroup		1.3.6.1.4.1.9.9.106.3.2.1
The collection of objects used to set global configuration objects for the HSRP MIB.
Status: current	Access: read-create
OBJECT-GROUP

cHsrpGrpGroup		1.3.6.1.4.1.9.9.106.3.2.2
The collection of objects used to add, delete and retrieve information about HSRP groups.
Status: current	Access: read-create
OBJECT-GROUP

cHsrpNotificationsGroup		1.3.6.1.4.1.9.9.106.3.2.3
The collection of notifications used to indicate HSRP state information.
Status: current	Access: read-create
NOTIFICATION-GROUP

cHsrpGrpGroupSup		1.3.6.1.4.1.9.9.106.3.2.4
The collection of objects used to add, delete and retrieve information about HSRP groups.
Status: current	Access: read-create
OBJECT-GROUP