VRRP-MIB
Functions Overview
As defined in the RFC 2787, VRRP-MIB is used to manage the VRRP configuration on the devices. In the scenario where a VRRP backup group is configured using the VRRP-MIB, if all VRRP attributes except the virtual IP address are configured for the VRRP backup group, the configuration files of the VRRP attributes cannot be displayed.
The OID of root objects is:
iso(1).org(3).dod(6).internet(1).mgmt(2).mib-2(1).vrrpMIB(68)
Description of Single Objects
vrrpNodeVersion
OID |
Object Name |
Syntax |
Max Access |
Description |
Implemented Specifications |
|---|---|---|---|---|---|
1.3.6.1.2.1.68.1.1 |
vrrpNodeVersion |
Integer32 |
Read-only |
This value identifies the particular version of the VRRP supported by this node. |
This object is implemented as defined in the corresponding MIB files. |
vrrpTrapPacketSrc
OID |
Object Name |
Syntax |
Max Access |
Description |
Implemented Specifications |
|---|---|---|---|---|---|
1.3.6.1.2.1.68.1.5 |
vrrpTrapPacketSrc |
OCTET STRING (SIZE (4)) |
Accessible-for-notify |
This object indicates the IP address of a received VRRP packet, which is used by vrrpTrapAuthFailure trap |
This object is implemented as defined in the corresponding MIB file. |
vrrpTrapAuthErrorType
OID |
Object Name |
Syntax |
Max Access |
Description |
Implemented Specifications |
|---|---|---|---|---|---|
1.3.6.1.2.1.68.1.6 |
vrrpTrapAuthErrorType |
INTEGER { invalidAuthType (1), authTypeMismatch (2), authFailure (3) } |
Accessible-for-notify |
This object indicates potential types of configuration conflicts,
which are used by vrrpAuthFailure trap. The value of this object can
be:
|
This object is implemented as defined in the corresponding MIB file. |
vrrpRouterChecksumErrors
OID |
Object Name |
Syntax |
Max Access |
Description |
Implemented Specifications |
|---|---|---|---|---|---|
1.3.6.1.2.1.68.2.1 |
vrrpRouterChecksumErrors |
INTEGER (0..4294967295) |
Read-only |
This object indicates the total number of the VRRP packets received with an invalid VRRP checksum value. |
This object is implemented as defined in the corresponding MIB files. |
vrrpRouterVersionErrors
OID |
Object Name |
Syntax |
Max Access |
Description |
Implemented Specifications |
|---|---|---|---|---|---|
1.3.6.1.2.1.68.2.2 |
vrrpRouterVersionErrors |
INTEGER (0..4294967295) |
Read-only |
This object indicates the total number of VRRP packets received with an unknown or unsupported version number. |
This object is implemented as defined in the corresponding MIB files. |
vrrpRouterVrIdErrors
OID |
Object Name |
Syntax |
Max Access |
Description |
Implemented Specifications |
|---|---|---|---|---|---|
1.3.6.1.2.1.68.2.3 |
vrrpRouterVrIdErrors |
INTEGER (0..4294967295) |
Read-only |
This object indicates the total number of the VRRP packets received with an invalid VRID for this virtual router. |
This object is implemented as defined in the corresponding MIB files. |
Description of MIB Tables
vrrpOperTable
This table is for VRRP operation on devices. It lists a series of VRRP operation entries. From this table, you can view the current VRRP configuration on the device. In addition, you can create instances of virtual routers and modify the configuration.
The index of this table is ifIndex.vrrpOperVrId.
OID |
Object Name |
Syntax |
Max Access |
Description |
Implemented Specifications |
|---|---|---|---|---|---|
1.3.6.1.2.1.68.1.3.1.1 |
vrrpOperVrId |
Integer32 (1..255) |
Not-accessible |
This object contains the Virtual Router Identifier (VRID). |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.68.1.3.1.2 |
vrrpOperVirtualMacAddr |
OCTET STRING (SIZE (6)) |
Read-only |
The virtual MAC address of the virtual router. Although this object can be derived from the 'vrrpOperVrId' object, it is defined so that it is easily obtainable by a management application and can be included in VRRP-related SNMP traps. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.68.1.3.1.3 |
vrrpOperState |
INTEGER{initialize(1),backup(2),master(3)} |
Read-only |
The current state of the virtual router. This object has four defined values:
Setting the "vrrpOperAdminState" object (below) initiates transitions in the value of this object. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.68.1.3.1.4 |
vrrpOperAdminState |
INTEGER {up(1),down(2)} |
Read-create |
This object can enable/disable the virtual router function. The values are as follows:
By default, the value is 2. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.68.1.3.1.5 |
vrrpOperPriority |
Integer32 (0..255) |
Read-create |
This object specifies the priority to be used for the virtual router master election process. Higher values imply higher priority. A priority of "0", although not settable, is sent by the master router to indicate that this router has ceased to participate in VRRP and a backup virtual router should transition to become a new master. A priority of 255 is used for the device that owns the associated IP address(es). By default, the value is 100. |
The value that can be set manually ranges from 1 to 254. |
1.3.6.1.2.1.68.1.3.1.6 |
vrrpOperIpAddrCount |
Integer32 (0..255) |
Read-only |
The value of this object identifies the number of IP addresses that are associated with this virtual router. This number is equal to the number of rows in the vrrpAssoIpAddrTable that correspond to a given IF index/VRID pair. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.68.1.3.1.7 |
vrrpOperMasterIpAddr |
OCTET STRING (SIZE (4)) |
Read-only |
This object indicates the master router's real (primary) IP address. This is the IP address listed as the source in VRRP advertisement last received by this virtual router. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.68.1.3.1.8 |
vrrpOperPrimaryIpAddr |
OCTET STRING (SIZE (4)) |
Read-create |
In the case where there is more than one IP address for a given "ifIndex", this object is used to specify the IP address that will become the "vrrpOperMasterIpAddr", should the virtual router transition from backup to master. If this object is set to 0.0.0.0, the IP address which is numerically lowest will be selected. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.68.1.3.1.9 |
vrrpOperAuthType |
INTEGER {noAuthentication(1),simpleTextPassword(2),ipAuthenticationHeader(3)} |
Read-create |
The value of this object identifies authentication type used for VRRP protocol exchanges between virtual routers. This value of this object is the same for a given ifIndex. By default, the value is 1. |
The values that can be set manually are as follows:
|
1.3.6.1.2.1.68.1.3.1.10 |
vrrpOperAuthKey |
OCTET STRING (SIZE (0..16)) |
Read-create |
This object indicates the authentication key. This object is set according to the value of the "vrrpOperAuthType" object ("simpleTextPassword" or "ipAuthenticationHeader"). If the length of the value is less than 16 octets, the agent will left adjust and zero fill to 16 octets. |
The value is a string of 1 to 8 characters. |
1.3.6.1.2.1.68.1.3.1.11 |
vrrpOperAdvertisementInterval |
Integer32 (1...255) |
Read-create |
The value of this object identifies the time interval, in seconds, between sending advertisement messages. Only the master router sends VRRP advertisements. The default value is 1. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.68.1.3.1.12 |
vrrpOperPreemptMode |
INTEGER{true(1),false(2)} |
Read-create |
The value of this object controls whether a higher priority virtual router will preempt a lower priority master. The values are as follows:
By default, the value is true. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.68.1.3.1.13 |
vrrpOperVirtualRouterUpTime |
TimeTicks |
Read-only |
This is the value of the "sysUpTime" object when this virtual router's status (that is, the "vrrpOperState") transitioned out of "initialized". |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.68.1.3.1.14 |
vrrpOperProtocol |
INTEGER {ip (1),bridge (2),decnet (3),other (4)} |
Read-create |
The value of this object identifies the particular protocol being controlled by this virtual router. The values are as follows:
By default, the value is 1. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.68.1.3.1.15 |
vrrpOperRowStatus |
INTEGER{active(1),notInService(2),notReady(3),createAndGo(4),createAndWait(5),destroy(6)} |
Read-create |
The object indicates the status of the row. |
This object is implemented as defined in the corresponding MIB files. |
Creation Restriction
You can create a row in createAndGo and createAndWait modes. After the successful creation, traverse the vrrpOperRowStatus and you can find the value of the created row is notReady.
The objects in this table take effect only after a virtual IP address is configured for a VRRP backup group. If no virtual IP address is configured, the generated configuration cannot be restored.
Modification Restriction
When vrrpOperRowStatus is active, only the value of vrrpOperAdminStateObject can be modified. The modification of vrrpOperAdminStateObject affects that of vrrpOperStateObject. If you want to modify the value of ObjectvrrpOperRowStatus from Active to another value, you need to set vrrpOperAdminStateObject to Down.
Deletion Restriction
The entries in this table can be deleted.
You can set the value of ObjectvrrpOperRowStatus and set the corresponding instance as destroy.
Access Restriction
None.
vrrpAssoIpAddrTable
This table is an IP address table related to virtual routers. The table displays information about the virtual IP address of a certain virtual router, with specified ifIndex and vrrpOperVrId. The number of rows in this table should be consistent with that of vrrpOperIpAddrCountObject in vrrpOperTable. For a created row in vrrpOperTable, to set the object to Active, at least one row in the active state is required in vrrpAssoIpAddrTable. When you set vrrpAssoIpAddrRowStatus to notInService, this virtual IP address becomes invalid.
The index of this table is ifIndex.vrrpOperVrId.vrrpAssoIpAddr.
OID |
Object Name |
Syntax |
Max Access |
Description |
Implemented Specifications |
|---|---|---|---|---|---|
1.3.6.1.2.1.68.1.4.1.1 |
vrrpAssoIpAddr |
OCTET STRING (SIZE (4)) |
Not-accessible |
This object indicates the assigned IP addresses that a virtual router is responsible for backing up. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.68.1.4.1.2 |
vrrpAssoIpAddrRowStatus |
INTEGER{active(1),notInService(2),notReady(3),createAndGo(4),createAndWait(5),destroy(6)} |
read-create |
The object indicates the status of the row. |
This object is implemented as defined in the corresponding MIB files. |
Creation Restriction
You can create entries in this table. Before configure vrrpAssoIpAddrRowStatus, you should create a VRRP first and set vrrpOperAdminState to down.
Modification Restriction
The entries in this table cannot be modified.
Deletion Restriction
Before delete the entries, you should set vrrpOperAdminState to down and set vrrpOperRowStatus to notInService.
Access Restriction
None.
vrrpRouterStatsTable
This is a statistics table for virtual routers. This table lists statistics of the virtual routers, including the times that the status changes into the Master and the number of the received broadcast packets.
The indexes of this table are as follows:
ifIndex
vrrpOperVrId
OID |
Object Name |
Syntax |
Max Access |
Description |
Implemented Specifications |
|---|---|---|---|---|---|
1.3.6.1.2.1.68.2.4.1.1 |
vrrpStatsBecomeMaster |
INTEGER (0..4294967295) |
Read-only |
This object indicates the total number of times that this virtual router's state has transitioned to MASTER. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.68.2.4.1.2 |
vrrpStatsAdvertiseRcvd |
INTEGER (0..4294967295) |
Read-only |
This object indicates the total number of VRRP advertisements received by this virtual router. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.68.2.4.1.3 |
vrrpStatsAdvertiseIntervalErrors |
INTEGER (0..4294967295) |
Read-only |
This object indicates the total number of VRRP advertisement packets received for which the advertisement interval is different than the one configured for the local virtual router. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.68.2.4.1.4 |
vrrpStatsAuthFailures |
INTEGER (0..4294967295) |
Read-only |
This object indicates the total number of VRRP packets received that do not pass the authentication check. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.68.2.4.1.5 |
vrrpStatsIpTtlErrors |
INTEGER (0..4294967295) |
Read-only |
This object indicates the total number of VRRP packets received by the virtual router with IP TTL (Time-To-Live) not equal to 255. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.68.2.4.1.6 |
vrrpStatsPriorityZeroPktsRcvd |
INTEGER (0..4294967295) |
Read-only |
This object indicates the total number of VRRP packets received by the virtual router with a priority of '0'. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.68.2.4.1.7 |
vrrpStatsPriorityZeroPktsSent |
INTEGER (0..4294967295) |
Read-only |
This object indicates the total number of VRRP packets sent by the virtual router with a priority of '0'. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.68.2.4.1.8 |
vrrpStatsInvalidTypePktsRcvd |
INTEGER (0..4294967295) |
Read-only |
This object indicates the number of VRRP packets received by the virtual router with an invalid value in the 'type' field. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.68.2.4.1.9 |
vrrpStatsAddressListErrors |
INTEGER (0..4294967295) |
Read-only |
This object indicates the total number of packets received for which the address list does not match the locally configured list for the virtual router. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.68.2.4.1.10 |
vrrpStatsInvalidAuthType |
INTEGER (0..4294967295) |
Read-only |
This object indicates the total number of packets received with an unknown authentication type. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.68.2.4.1.11 |
vrrpStatsAuthTypeMismatch |
INTEGER (0..4294967295) |
Read-only |
This object indicates the total number of packets received with 'Auth Type' not equal to the locally configured authentication method ('vrrpOperAuthType'). |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.68.2.4.1.12 |
vrrpStatsPacketLengthErrors |
INTEGER (0..4294967295) |
Read-only |
This object indicates the total number of packets received with a packet length less than the length of the VRRP header. |
This object is implemented as defined in the corresponding MIB files. |
Creation Restriction
No entry can be created in this table.
Modification Restriction
The entries in this table cannot be modified.
Deletion Restriction
The entries in this table cannot be deleted.
Access Restriction
None.
Description of Alarm Objects
vrrpTrapNewMaster
OID |
Object Name |
Bound Variable |
Description |
Implemented Specifications |
|---|---|---|---|---|
1.3.6.1.2.1.68.0.1 |
VrrpTrapNewMaster |
vrrpOperMasterIpAddr |
The newMaster trap indicates that the sending agent has transitioned to 'Master' state. |
This object is implemented as defined in the corresponding MIB files. |
vrrpTrapAuthFailure
OID |
Object Name |
Bound Variable |
Description |
Implemented Specifications |
|---|---|---|---|---|
1.3.6.1.2.1.68.0.2 |
vrrpTrapAuthFailure |
|
A vrrpAuthFailure trap signifies that a packet has been received from a device whose authentication key or authentication type conflicts with this device's authentication key or authentication type. Implementation of this trap is optional. |
This object is implemented as defined in the corresponding MIB files. |