mibs/MIBS/cisco/CISCO-HSRP-EXT-MIB

619 lines
21 KiB
Plaintext
Raw Permalink Normal View History

2023-12-05 12:25:34 +01:00
-- *****************************************************************
-- CISCO-HSRP-EXT-MIB
--
-- Jan 2010, Sreenadh Gaddam
-- Copyright (c) 1998-2005, 2009-2010 by cisco Systems Inc.
-- All rights reserved.
-- *****************************************************************
CISCO-HSRP-EXT-MIB DEFINITIONS ::= BEGIN
IMPORTS
MODULE-IDENTITY,
OBJECT-TYPE,
IpAddress,
Unsigned32
FROM SNMPv2-SMI
MODULE-COMPLIANCE,
OBJECT-GROUP
FROM SNMPv2-CONF
TruthValue,
RowStatus
FROM SNMPv2-TC
InetAddressType,
InetAddress
FROM INET-ADDRESS-MIB
ifIndex,
InterfaceIndex
FROM IF-MIB
cHsrpGrpNumber
FROM CISCO-HSRP-MIB
ciscoMgmt
FROM CISCO-SMI;
ciscoHsrpExtMIB MODULE-IDENTITY
LAST-UPDATED "201009020000Z"
ORGANIZATION "Cisco Systems, Inc."
CONTACT-INFO
"Cisco Systems
Customer Service
Postal: 170 W Tasman Drive
San Jose, CA 95134
USA
Tel: +1 800 553-NETS
E-mail: cs-hsrp@cisco.com"
DESCRIPTION
"The Extension MIB module for the CISCO-HSRP-MIB which is
based on RFC2281.
This MIB provides an extension to the CISCO-HSRP-MIB which
defines Cisco's proprietary Hot Standby Routing Protocol
(HSRP), defined in RFC2281. The extensions cover assigning
of secondary HSRP ip addresses, modifying an HSRP Group's
priority by tracking the operational status of interfaces,
etc.
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.
A 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 IP address. These are the
designated addresses. The active router assumes
(i.e. inherits) these group addresses. An HSRP group is
identified by a ( ifIndex, cHsrpGrpNumber ) pair.
BIA stands for Burned In Address."
REVISION "201009020000Z"
DESCRIPTION
"The following changes have been made.
[1] Objects cHsrpExtIfTrackedIpNone has been deprecated.
[2] Deprecates object group cHsrpExtIfTrackedGroupSup1, which
supplementary to cHsrpExtIfTrackedGroup.
[3] Added new compliance cHsrpExtComplianceRev2, which
deprecates cHsrpExtComplianceRev1."
REVISION "201002050000Z"
DESCRIPTION
"Added cHsrpExtIfTrackedIpNone to
cHsrpExtIfTrackedTable
Added new table cHsrpExtIfStandbyTable.
Added OBJECT-GROUP cHsrpExtIfStandbyGroup91.
Added OBJECT-GROUP cHsrpExtIfTrackedGroupSup1, which
supplementary to cHsrpExtIfTrackedGroup.
Added MODULE-COMPLIANCE cHsrpExtComplianceRev1, which
deprecates cHsrpExtCompliance."
REVISION "200602150000Z"
DESCRIPTION
"Updated the imports such that Unsigned32 is imported from
SNMPv2-SMI instead of CISCO-TC. Updated the module
description. Also updated the descriptions of
cHsrpExtIfTrackedEntry and cHsrpExtIfTracked. Formatted the
complete MIB."
REVISION "9808030000Z"
DESCRIPTION
"Initial version of this mib."
::= { ciscoMgmt 107 }
ciscoHsrpExtMIBObjects OBJECT IDENTIFIER
::= { ciscoHsrpExtMIB 1 }
-- HSRP Extension Tables
-- Extention group info
cHsrpExtGroup OBJECT IDENTIFIER
::= { ciscoHsrpExtMIBObjects 1 }
-- Interface Use Burned-In Address state
cHsrpExtIfBIA OBJECT IDENTIFIER
::= { ciscoHsrpExtMIBObjects 2 }
cHsrpExtIfTrackedTable OBJECT-TYPE
SYNTAX SEQUENCE OF CHsrpExtIfTrackedEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table containing information about tracked interfaces per
HSRP group."
::= { cHsrpExtGroup 1 }
cHsrpExtIfTrackedEntry OBJECT-TYPE
SYNTAX CHsrpExtIfTrackedEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Each row of this table allows the tracking of one
interface of the HSRP group which is identified by the
(ifIndex, cHsrpGrpNumber) values in this table's INDEX clause.
Weight(priority) is given to each and every interface tracked.
When a tracked interface is unavailable, the HSRP priority of
the router is decreased. i.e cHsrpGrpPriority value assigned
to an HSRP group will reduce by the value assigned to
cHsrpExtIfTrackedPriority. This reduces the likelihood
of a router with a failed key interface becoming the
active router.
Setting cHsrpExtIfTrackedRowStatus to active starts
the tracking of cHsrpExtIfTracked by the HSRP group.
The value of cHsrpExtIfTrackedRowStatus may be set
to destroy at any time.
Entries may not be created via SNMP without explicitly setting
cHsrpExtIfTrackedRowStatus to either 'createAndGo'
or 'createAndWait'.
Entries can be created and modified via the management
protocol or by the device's local management interface.
If the row is not active, and a local management interface
command modifies that row, the row may transition to active
state.
A row entry in the cHsrpExtIfTrackedTable can not be created
unless the corresponding row in the cHsrpGrpTable has been
created. If that corresponding row in cHsrpGrpTable is
deleted, the interfaces it tracks also get deleted.
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."
INDEX {
ifIndex,
cHsrpGrpNumber,
cHsrpExtIfTracked
}
::= { cHsrpExtIfTrackedTable 1 }
CHsrpExtIfTrackedEntry ::= SEQUENCE {
cHsrpExtIfTracked InterfaceIndex,
cHsrpExtIfTrackedPriority Unsigned32,
cHsrpExtIfTrackedRowStatus RowStatus,
cHsrpExtIfTrackedIpNone TruthValue
}
cHsrpExtIfTracked OBJECT-TYPE
SYNTAX InterfaceIndex
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The ifIndex value of the tracked interface."
::= { cHsrpExtIfTrackedEntry 1 }
cHsrpExtIfTrackedPriority OBJECT-TYPE
SYNTAX Unsigned32 (0..255)
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"Priority of the tracked interface for the corresponding
{ ifIndex, cHsrpGrpNumber } pair. In the range of 0 to 255, 0
is the lowest priority and 255 is the highest. When a tracked
interface is unavailable, the cHsrpGrpPriority of the router
is decreased by the value of this object instance (If the
cHsrpGrpPriority is less than the
cHsrpExtIfTrackedPriority, then the HSRP priority
becomes 0). This allows a standby router to be configured
with a priority such that if the currently active router's
priority is lowered because the tracked interface goes down,
the standby router can takeover."
DEFVAL { 0 }
::= { cHsrpExtIfTrackedEntry 2 }
cHsrpExtIfTrackedRowStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The control that allows modification, creation, and deletion
of entries. For detailed rules see the DESCRIPTION for
cHsrpExtIfTrackedEntry."
::= { cHsrpExtIfTrackedEntry 3 }
cHsrpExtIfTrackedIpNone OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-create
STATUS deprecated
DESCRIPTION
"This object specifies the disable HSRP IPv4 virtual
IP address."
DEFVAL { false }
::= { cHsrpExtIfTrackedEntry 4 }
cHsrpExtSecAddrTable OBJECT-TYPE
SYNTAX SEQUENCE OF CHsrpExtSecAddrEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table containing information about secondary HSRP IP
Addresses per interface and group."
::= { cHsrpExtGroup 2 }
cHsrpExtSecAddrEntry OBJECT-TYPE
SYNTAX CHsrpExtSecAddrEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The CHsrpExtSecAddrEntry allows creation of secondary
IP Addresses for each cHsrpGrpEntry row.
Secondary addresses can be added by setting
cHsrpExtSecAddrRowStatus to be active. The value of
cHsrpExtSecAddrRowStatus may be set to destroy at any
time.
Entries may not be created via SNMP without explicitly setting
cHsrpExtSecAddrRowStatus to either 'createAndGo'
or 'createAndWait'.
Entries can be created and modified via the management
protocol or by the device's local management interface.
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.
Before creation of a cHsrpExtSecAddrEntry row,
either cHsrpGrpConfiguredVirtualIpAddr or
cHsrpGrpLearnedVirtualIpAddr must have a valid IP Address.
This is because a secondary ip address cannot be created
unless the primary ip address has already been set.
To create a new cHsrpExtSecAddrEntry row, a management
station should choose the ifIndex of the interface which is to
be added as part of an HSRP group. Also, an HSRP group number
and a cHsrpExtSecAddrAddress should be chosen.
Deleting a {ifIndex, cHsrpGrpNumber} row in the
cHsrpGrpTable will delete all corresponding
rows in the cHsrpExtSecAddrTable.
Deleting a primary address value in the cHsrpGrpEntry row
will delete all secondary addresses for the same
{ifIndex, cHsrpGrpNumber} pair."
INDEX {
ifIndex,
cHsrpGrpNumber,
cHsrpExtSecAddrAddress
}
::= { cHsrpExtSecAddrTable 1 }
CHsrpExtSecAddrEntry ::= SEQUENCE {
cHsrpExtSecAddrAddress IpAddress,
cHsrpExtSecAddrRowStatus RowStatus
}
cHsrpExtSecAddrAddress OBJECT-TYPE
SYNTAX IpAddress
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A secondary IpAddress for the {ifIndex, cHsrpGrpNumber} pair.
As explained in the DESCRIPTION for cHsrpExtSecAddrEntry, a
primary address must exist before a secondary address for
the same {ifIndex, cHsrpGrpNumber} pair can be created."
::= { cHsrpExtSecAddrEntry 1 }
cHsrpExtSecAddrRowStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The control that allows modification, creation, and deletion
of entries. For detailed rules see the DESCRIPTION for
cHsrpExtSecAddrEntry."
::= { cHsrpExtSecAddrEntry 2 }
cHsrpExtIfStandbyTable OBJECT-TYPE
SYNTAX SEQUENCE OF CHsrpExtIfStandbyEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table containing information about standby
interfaces per HSRP group."
::= { cHsrpExtGroup 3 }
cHsrpExtIfStandbyEntry OBJECT-TYPE
SYNTAX CHsrpExtIfStandbyEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The cHsrpExtIfStandbyEntry allows an HSRP group
interface to track one or more standby interfaces.
To create a new cHsrpExtIfStandbyEntry row, a
management station should choose the ifIndex of
the interface which is to be added as part of an
HSRP group. Also, an HSRP group number and a
cHsrpExtIfStandbyIndex should be chosen."
INDEX {
ifIndex,
cHsrpGrpNumber,
cHsrpExtIfStandbyIndex
}
::= { cHsrpExtIfStandbyTable 1 }
CHsrpExtIfStandbyEntry ::= SEQUENCE {
cHsrpExtIfStandbyIndex Unsigned32,
cHsrpExtIfStandbyDestAddrType InetAddressType,
cHsrpExtIfStandbyDestAddr InetAddress,
cHsrpExtIfStandbySourceAddrType InetAddressType,
cHsrpExtIfStandbySourceAddr InetAddress,
cHsrpExtIfStandbyRowStatus RowStatus
}
cHsrpExtIfStandbyIndex OBJECT-TYPE
SYNTAX Unsigned32 (1..4)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This object defines the index of the standby table."
::= { cHsrpExtIfStandbyEntry 1 }
cHsrpExtIfStandbyDestAddrType OBJECT-TYPE
SYNTAX InetAddressType
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object specifies the type of Internet address
denoted by cHsrpExtIfStandbyDestAddr."
::= { cHsrpExtIfStandbyEntry 2 }
cHsrpExtIfStandbyDestAddr OBJECT-TYPE
SYNTAX InetAddress
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object specifies the destination IP address of
the standby router."
::= { cHsrpExtIfStandbyEntry 3 }
cHsrpExtIfStandbySourceAddrType OBJECT-TYPE
SYNTAX InetAddressType
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object specifies the type of Internet address
denoted by cHsrpExtIfStandbySourceAddr."
::= { cHsrpExtIfStandbyEntry 4 }
cHsrpExtIfStandbySourceAddr OBJECT-TYPE
SYNTAX InetAddress
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object specifies the source IP address of
the standby router."
::= { cHsrpExtIfStandbyEntry 5 }
cHsrpExtIfStandbyRowStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The control that allows modification, creation,
and deletion of entries. Entries may not be created
via SNMP without explicitly setting
cHsrpExtIfStandbyRowStatus to either
'createAndGo' or 'createAndWait'."
::= { cHsrpExtIfStandbyEntry 6 }
cHsrpExtIfTable OBJECT-TYPE
SYNTAX SEQUENCE OF CHsrpExtIfEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"HSRP-specific configurations for each physical interface."
::= { cHsrpExtIfBIA 1 }
cHsrpExtIfEntry OBJECT-TYPE
SYNTAX CHsrpExtIfEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"If HSRP entries on this interface must use the BIA (Burned
In Address), there must be an entry for the interface in this
table. Entries of this table are only accessible if HSRP has
been enabled i.e entries can not be created if HSRP is not
enabled. Also, the interfaces should be of IEEE 802 ones
(Ethernet, Token Ring, FDDI,VLAN, LANE, TR-LANE).
Setting cHsrpExtIfRowStatus to active initiates the
entry with default value for cHsrpExtIfUseBIA as FALSE.
The value of cHsrpExtIfRowStatus may be set to destroy
at any time. If the row is not initiated, it is similar to
having cHsrpExtIfUseBIA as FALSE.
Entries may not be created via SNMP without explicitly setting
cHsrpExtIfRowStatus to either 'createAndGo' or 'createAndWait'.
Entries can be created and modified via the management
protocol or by the device's local management interface.
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."
INDEX { ifIndex }
::= { cHsrpExtIfTable 1 }
CHsrpExtIfEntry ::= SEQUENCE {
cHsrpExtIfUseBIA TruthValue,
cHsrpExtIfRowStatus RowStatus
}
cHsrpExtIfUseBIA OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"If set to TRUE, the HSRP Group MAC Address for all groups
on this interface will be the burned-in-address. Otherwise,
this will be determined by ciscoHsrpGroupNumber. In case of
sub-interfaces, UseBIA applies to all sub-interfaces on an
interface and to all groups on those sub-interfaces."
DEFVAL { false }
::= { cHsrpExtIfEntry 1 }
cHsrpExtIfRowStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The control that allows modification, creation, and deletion
of entries. For detailed rules see the DESCRIPTION for
cHsrpExtIfEntry."
::= { cHsrpExtIfEntry 2 }
-- Notifications
-- None
--
-- Conformance groups
cHsrpExtConformance OBJECT IDENTIFIER
::= { ciscoHsrpExtMIB 3 }
cHsrpExtCompliances OBJECT IDENTIFIER
::= { cHsrpExtConformance 1 }
cHsrpExtComplianceGroups OBJECT IDENTIFIER
::= { cHsrpExtConformance 2 }
-- compliance statements
cHsrpExtCompliance MODULE-COMPLIANCE
STATUS deprecated
DESCRIPTION
"The compliance statement for entities which implement
the CISCO-HSRP-EXT-MIB. This is deprecated by
cHsrpExtComplianceRev1."
MODULE -- this module
MANDATORY-GROUPS {
cHsrpExtIfTrackedGroup,
cHsrpExtSecAddrGroup,
cHsrpExtIfGroup
}
::= { cHsrpExtCompliances 1 }
cHsrpExtComplianceRev1 MODULE-COMPLIANCE
STATUS deprecated
DESCRIPTION
"the compliance statement for entities which implement
the CISCO-HSRP-EXT-MIB.This is deprecated by
cHsrpExtComplianceRev2."
MODULE -- this module
MANDATORY-GROUPS {
cHsrpExtIfTrackedGroup,
cHsrpExtSecAddrGroup,
cHsrpExtIfGroup,
cHsrpExtIfStandbyGroup91,
cHsrpExtIfTrackedGroupSup1
}
::= { cHsrpExtCompliances 2 }
cHsrpExtComplianceRev2 MODULE-COMPLIANCE
STATUS current
DESCRIPTION
"the compliance statement for entities which implement
the CISCO-HSRP-EXT-MIB."
MODULE -- this module
MANDATORY-GROUPS {
cHsrpExtIfTrackedGroup,
cHsrpExtSecAddrGroup,
cHsrpExtIfGroup,
cHsrpExtIfStandbyGroup91
}
::= { cHsrpExtCompliances 3 }
cHsrpExtIfTrackedGroup OBJECT-GROUP
OBJECTS {
cHsrpExtIfTrackedPriority,
cHsrpExtIfTrackedRowStatus
}
STATUS current
DESCRIPTION
"The collection of objects used to add, delete and retrieve
the interfaces getting tracked for HSRP groups."
::= { cHsrpExtComplianceGroups 1 }
cHsrpExtSecAddrGroup OBJECT-GROUP
OBJECTS { cHsrpExtSecAddrRowStatus }
STATUS current
DESCRIPTION
"The collection of objects used to add, delete and retrieve
primary and secondary Ip Addresses for HSRP groups."
::= { cHsrpExtComplianceGroups 2 }
cHsrpExtIfGroup OBJECT-GROUP
OBJECTS {
cHsrpExtIfUseBIA,
cHsrpExtIfRowStatus
}
STATUS current
DESCRIPTION
"Object which tells if HSRP entries on this interface must
use BIA or not."
::= { cHsrpExtComplianceGroups 3 }
cHsrpExtIfStandbyGroup91 OBJECT-GROUP
OBJECTS {
cHsrpExtIfStandbyDestAddrType,
cHsrpExtIfStandbyDestAddr,
cHsrpExtIfStandbySourceAddrType,
cHsrpExtIfStandbySourceAddr,
cHsrpExtIfStandbyRowStatus
}
STATUS current
DESCRIPTION
"The collection of objects used to add, delete and
retrieve the interfaces getting standby for
HSRP groups."
::= { cHsrpExtComplianceGroups 4 }
cHsrpExtIfTrackedGroupSup1 OBJECT-GROUP
OBJECTS { cHsrpExtIfTrackedIpNone }
STATUS deprecated
DESCRIPTION
"The collection of HSRP interface tracked objects
which suppliments cHsrpExtIfTrackedGroup."
::= { cHsrpExtComplianceGroups 5 }
END