This MIB module defines objects describing selective VRF download. The selective VRF download feature makes a best effort to download only those prefixes and labels to a physical entity required to forward traffic through the physical entity. The feature accomplishes this by characterizing roles for physical entities baed on their configuration.
Following terminology is introduced with selective VRF download feature:
Core Facing A physical entity which has only core
facing interfaces (interfaces that connect to other Provider/Provider Edge devices).
Customer Facing A line physical entity which has one or
more customer facing interfaces (interfaces that connect to Customer Edge devices in different VRFs).
Local prefix A prefix that is received from a
Customer edge device connected to the router in a configured VRF context.
Remote prefix A prefix received from another Provider
Edge device and is imported to a configured VRF.
See the following references for futher information:
RFC 3813 - Multiprotocol Label Switching (MPLS) Label Switching Router (LSR) Management Information base (MIB), C. Srinivasan, A. Vishwanathan, and T. Nadeau, June 2004
RFC 4382 - MPLS/BGP Layer 3 Virtual Private Network (VPN) Management Information Base, T. Nadeau & van Der Linde, February 2006
Acronyms: VRF Virtual Routing and Forwarding VPN Virtual Private Network
P Provider Core Device
PE Provider Edge Device
CE Customer Edge Device
AFI Address Family Identifier CEF Cisco Express Forwarding
TruthValue1 = true2 = falseRepresents a boolean value. · Integer32
This object specifies the desired state of selective VRF download feature. When a managed system initializes, it starts with csvdAdminEnable in the true(1) state. As a result of either explicit management action or per configuration information retained by the managed system, csvdAdminEnable is then changed to false(2) state (or remains in the true(1) state.
csvdOperEnable
1.3.6.1.4.1.9.9.775.1.2
TruthValue1 = true2 = falseRepresents a boolean value. · Integer32
This object indicates the current operational state of selective VRF download feature. If csvdAdminEnable is changed then csvdOperEnable should change to the same value after the external action is triggered. As an external action implementations may require router reload or switchover of the route-processor for the change to take effect.
csvdEntityRoleChangeNotificationEnable
1.3.6.1.4.1.9.9.775.1.3
TruthValue1 = true2 = falseRepresents a boolean value. · Integer32
This object specifies whether the system generates the csvdEntityRoleChangeNotification.
csvdCounterDiscontinuityTime
1.3.6.1.4.1.9.9.775.1.4
TimeStampThe value of the sysUpTime object at which a specific occurrence happened. The specific occurrence must be
defined in the description of any object defined using this type.
If sysUpTime is reset to zero as a result of a re- initialization of the network management (sub)system, then the values of all TimeStamp objects are also reset. However, after approximately 497 days without a re- initialization, the sysUpTime object will reach 2^^32-1 and then increment around to zero; in this case, existing values of TimeStamp objects do not change. This can lead to ambiguities in the value of TimeStamp objects. · TimeTicks
This object indicates the value of sysUpTime on the most recent occasion at which selective VRF download counters suffered a discontinuity. The relevant counters are the instances of any Counter32 objects contained in csvdStateTable. If no such discontinuities have occurred since the last re-initialization of the local management subsystem, then this object contains a zero value.
csvdRoleHistorySize
1.3.6.1.4.1.9.9.775.1.6.1
Unsigned32 (1..100)
This object specifies the maximum number of rows the csvdRoleHistoryTable can contain at any given time. If the role changes and the csvdRoleHistoryTable already contains a number of rows equal to the value of this object, then it destroys the oldest row before creating a new one.
csvdRoleHistoryLastIndex
1.3.6.1.4.1.9.9.775.1.6.2
Unsigned32 (0..65535)
This object indicates the value of csvdRoleHistoryIndex corresponding to the last row created in the csvdRoleHistoryTable.
Table details
csvdStateTable
1.3.6.1.4.1.9.9.775.1.5
Index: entPhysicalIndex · csvdStateAFI
This table lists the state relating to the selective VRF download feature for each physical entity capable of forwarding packets. This table has an expansion dependent relationship on the entPhysicalTable, containing zero or more rows each row in the entPhysicalEntity. If the physical entity is capable of forwarding packets, it contains a row for each address family it supports.
PhysicalIndexAn arbitrary value that uniquely identifies the physical entity. The value should be a small positive integer. Index values for different physical entities are not necessarily contiguous. (1..2147483647) · Integer32 · hint d
The index for this entry.
csvdStateAFI
1.3.6.1.4.1.9.9.775.1.5.1.1
AddressFamilyNumbers0 = other1 = ipV42 = ipV63 = nsap4 = hdlc5 = bbn18226 = all8027 = e1638 = e1649 = f6910 = x12111 = ipx12 = appleTalk13 = decnetIV14 = banyanVines15 = e164withNsap16 = dns17 = distinguishedName18 = asNumber19 = xtpOverIpv420 = xtpOverIpv621 = xtpNativeModeXTP22 = fibreChannelWWPN23 = fibreChannelWWNN24 = gwid25 = afi26 = mplsTpSectionEndpointIdentifier27 = mplsTpLspEndpointIdentifier28 = mplsTpPseudowireEndpointIdentifier16384 = eigrpCommonServiceFamily16385 = eigrpIpv4ServiceFamily16386 = eigrpIpv6ServiceFamily16387 = lispCanonicalAddressFormat16388 = bgpLs16389 = fortyeightBitMac16390 = sixtyfourBitMac16391 = oui16392 = mac2416393 = mac4016394 = ipv66416395 = rBridgePortID16396 = trillNickname16397 = universallyUniqueIdentifier65535 = reservedThe definition of this textual convention with the addition of newly assigned values is published periodically by the IANA, in either the Assigned Numbers RFC, or some derivative of it specific to Internet Network Management number assignments. (The latest arrangements can be obtained by contacting the IANA.)
The enumerations are described as:
other(0), -- none of the following
ipV4(1), -- IP Version 4
ipV6(2), -- IP Version 6
nsap(3), -- NSAP
hdlc(4), -- (8-bit multidrop)
bbn1822(5),
all802(6), -- (includes all 802 media
-- plus Ethernet 'canonical format')
e163(7),
e164(8), -- (SMDS, Frame Relay, ATM)
f69(9), -- (Telex)
x121(10), -- (X.25, Frame Relay)
ipx(11), -- IPX (Internet Protocol Exchange)
appleTalk(12), -- Apple Talk
decnetIV(13), -- DEC Net Phase IV
banyanVines(14), -- Banyan Vines
e164withNsap(15), -- (E.164 with NSAP format subaddress)
dns(16), -- (Domain Name System)
distinguishedName(17), -- (Distinguished Name, per X.500) asNumber(18), -- (16-bit quantity, per the AS number space)
xtpOverIpv4(19), -- XTP over IP version 4
xtpOverIpv6(20), -- XTP over IP version 6
xtpNativeModeXTP(21), -- XTP native mode XTP
fibreChannelWWPN(22), -- Fibre Channel World-Wide Port Name
fibreChannelWWNN(23), -- Fibre Channel World-Wide Node Name
gwid(24), -- Gateway Identifier
afi(25), -- AFI for L2VPN information
mplsTpSectionEndpointIdentifier(26), -- MPLS-TP Section Endpoint Identifier
mplsTpLspEndpointIdentifier(27), -- MPLS-TP LSP Endpoint Identifier
mplsTpPseudowireEndpointIdentifier(28), -- MPLS-TP Pseudowire Endpoint Identifier
eigrpCommonServiceFamily(16384), -- EIGRP Common Service Family
eigrpIpv4ServiceFamily(16385), -- EIGRP IPv4 Service Family
eigrpIpv6ServiceFamily(16386), -- EIGRP IPv6 Service Family
lispCanonicalAddressFormat(16387), -- LISP Canonical Address Format (LCAF)
bgpLs(16388), -- BGP-LS
fortyeightBitMacBitMac(16389), -- 48-bit MAC
sixtyfourBitMac(16390), -- 64-bit MAC
oui(16391), -- OUI
mac24(16392), -- MAC/24
mac40(16393), -- MAC/40
ipv664(16394), -- IPv6/64
rBridgePortID(16395), -- RBridge Port ID
trillNickname(16396), -- TRILL Nickname
universallyUniqueIdentifier(16397), -- Universally Unique Identifier (UUID)
reserved(65535)
Requests for new values should be made to IANA via email (iana&iana.org). · Integer32
This object indicates the AFI for which the row pertains.
csvdStateEntityRole
1.3.6.1.4.1.9.9.775.1.5.1.2
SVDEntityRole1 = invalid2 = standard3 = core4 = customer5 = noInterest6 = vpnOnlyCustomerThis textual convention denotes the role of a physical entity with respect to selective VRF download feature.
'invalid': The role of the physical entity is unknown, unconfigured, or the selective VRF download feature has yet to calculate it.
'standard': The role of the physical entity has interfaces configured in the default table and other VRF tables. The selective VRF download feature downloads all VRFs and prefixes to the physical entity.
'core': The role of the physical entity only has interfaces configured in the default table. The selective VRF download feature downloads all VRFs and local customer prefixes to the physical entity.
'customer': The role of the physical entity only has interfaces configured in VRF tables other than the default. The selective VRF download feature downloads all prefixes for locally provisioned VRFs.
'noInterest': The role of the physical entity does not have interfaces configured in any VRF tables. The selective VRF download feature does not download any prefixes to the physical entity.
'vpnOnlyCustomer': The role of the physical entity is for VPN-only customers (i.e., customers that do not need access to global routes). The selective VRF download feature downloads provisioned VRFs to the physical entity, and it filters all BGP routes from the default table. · Integer32
This object specifies the selective VRF download role of the physical entity. It can be updated based on interface to VRF association change or ip-address assignment to an interface belonging to the physical entity. For example:- - if no interfaces on a physical entity have IPv4 address configured, then it would be in Customer Facing Role for IPv4 address family. - if no interfaces on a physical entity have IPv6 address configured, then it would be in Not Interested Role for IPv6 address family. - now if the user adds an IPv4 address to an interface in default VRF, then the physical entity would turn Core-Facing for IPv4 AFI. - if the user would have added this interface in a named VRF, then the physical entity would have remained in Customer-Facing for IPv4 AFI. - if there are interfaces configured in both default VRF and named VRFs then the physical entity would turn in to Standard Role.
csvdStateEntityRoleLastChange
1.3.6.1.4.1.9.9.775.1.5.1.3
TimeStampThe value of the sysUpTime object at which a specific occurrence happened. The specific occurrence must be
defined in the description of any object defined using this type.
If sysUpTime is reset to zero as a result of a re- initialization of the network management (sub)system, then the values of all TimeStamp objects are also reset. However, after approximately 497 days without a re- initialization, the sysUpTime object will reach 2^^32-1 and then increment around to zero; in this case, existing values of TimeStamp objects do not change. This can lead to ambiguities in the value of TimeStamp objects. · TimeTicks
This object indicates the value of sysUpTime the last time the corresponding instance of csvdStateEntityRole changed.
csvdStateEntityRoleTransitions
1.3.6.1.4.1.9.9.775.1.5.1.4
Counter32
This object indicates the number of times the corresponding instance of csvdStateEntityRole has changed. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of the corresponding instance of csvdCounterDiscontinuityTime.
This table lists the role change history per address family (ipv4 and ipv6) for each physical entity capable of forwarding packets. This table has an expansion dependant relationship on csvdStateTable, containing zero or more rows for each row in csvdStateTable.
PhysicalIndexAn arbitrary value that uniquely identifies the physical entity. The value should be a small positive integer. Index values for different physical entities are not necessarily contiguous. (1..2147483647) · Integer32 · hint d
The index for this entry.
csvdRoleHistoryIndex
1.3.6.1.4.1.9.9.775.1.6.3.1.1
Unsigned32 (0..65535)
This object indicates an arbitrary integer-value uniquely identifying the entry.
csvdRoleHistoryRole
1.3.6.1.4.1.9.9.775.1.6.3.1.2
SVDEntityRole1 = invalid2 = standard3 = core4 = customer5 = noInterest6 = vpnOnlyCustomerThis textual convention denotes the role of a physical entity with respect to selective VRF download feature.
'invalid': The role of the physical entity is unknown, unconfigured, or the selective VRF download feature has yet to calculate it.
'standard': The role of the physical entity has interfaces configured in the default table and other VRF tables. The selective VRF download feature downloads all VRFs and prefixes to the physical entity.
'core': The role of the physical entity only has interfaces configured in the default table. The selective VRF download feature downloads all VRFs and local customer prefixes to the physical entity.
'customer': The role of the physical entity only has interfaces configured in VRF tables other than the default. The selective VRF download feature downloads all prefixes for locally provisioned VRFs.
'noInterest': The role of the physical entity does not have interfaces configured in any VRF tables. The selective VRF download feature does not download any prefixes to the physical entity.
'vpnOnlyCustomer': The role of the physical entity is for VPN-only customers (i.e., customers that do not need access to global routes). The selective VRF download feature downloads provisioned VRFs to the physical entity, and it filters all BGP routes from the default table. · Integer32
This object indicates the selective VRF download role for a given history index.
csvdRoleHistoryRoleChangeTime
1.3.6.1.4.1.9.9.775.1.6.3.1.3
TimeStampThe value of the sysUpTime object at which a specific occurrence happened. The specific occurrence must be
defined in the description of any object defined using this type.
If sysUpTime is reset to zero as a result of a re- initialization of the network management (sub)system, then the values of all TimeStamp objects are also reset. However, after approximately 497 days without a re- initialization, the sysUpTime object will reach 2^^32-1 and then increment around to zero; in this case, existing values of TimeStamp objects do not change. This can lead to ambiguities in the value of TimeStamp objects. · TimeTicks
This object indicates the value of sysUpTime when entry was created.
This table lists VRF tables selectively downloaded to each physical entity capable of forwarding packets. This table has an expansion dependent relationship on the csvdStateTable, containing zero or more rows for each address family supported by each physical entity capable of forwarding packets.
PhysicalIndexAn arbitrary value that uniquely identifies the physical entity. The value should be a small positive integer. Index values for different physical entities are not necessarily contiguous. (1..2147483647) · Integer32 · hint d
The index for this entry.
csvdVrfName
1.3.6.1.4.1.9.9.775.1.7.1.1
MplsL3VpnNameAn identifier that is assigned to each MPLS/BGP VPN and is used to uniquely identify it. This is assigned by the system operator or NMS and SHOULD be unique throughout the MPLS domain. If this is the case, then this identifier can then be used at any LSR within a specific MPLS domain to identify this MPLS/BGP VPN. It may also be possible to preserve the uniqueness of this identifier across MPLS domain boundaries, in which case this identifier can then be used to uniquely identify MPLS/BGP VPNs on a more global basis. This object MAY be set to the VPN ID as defined in RFC 2685.Reference: RFC 2685 Fox B., et al, 'Virtual Private Networks Identifier', September 1999. SIZE (0..31) · OCTET STRING
Reference: T. Nadeau and H. van der Linde, 'MPLS/BGP Layer 3 Virtual Private Network (VPN) Management Information Base', RFC-4382, February 2006.
This object indicates the name of the VRF.
csvdPrefixCount
1.3.6.1.4.1.9.9.775.1.7.1.2
Gauge32
This object indicates the total number of prefixes downloaded from the VRF table. The value of this object may not equal to the sum of the values of the corresponding instance of csvdLocalPrefixCount and csvdRemotePrefixCount, as the VRF table may have special internal prefixes to support the CEF implementation.
csvdLocalPrefixCount
1.3.6.1.4.1.9.9.775.1.7.1.3
Gauge32
This object indicates the number of local prefixes downloaded from the VRF table.
csvdRemotePrefixCount
1.3.6.1.4.1.9.9.775.1.7.1.4
Gauge32
This object indicates the number of remote prefixes downloaded from the VRF table.
csvdTableConvergedFlag
1.3.6.1.4.1.9.9.775.1.7.1.5
TruthValue1 = true2 = falseRepresents a boolean value. · Integer32
This object indicates whether the VRF table has converged. Once all the prefixes for the VRF table have been updated and downloaded, convergence is complete. The flag is set to false when the VRF is created initially or selectively downloaded to the physical entity. Once the initial download of all the prefixes for the VRF to the physical entity completes, the flag is set to true.
Trap details
csvdEntityRoleChangeNotification
1.3.6.1.4.1.9.9.775.0.1
This notification is sent when the role of the physical entity for a given address family changes. csvdStateEntityRole indicates the role the entity is transitioning to.
csvdStateEntityRole
1.3.6.1.4.1.9.9.775.1.5.1.2
SVDEntityRole1 = invalid2 = standard3 = core4 = customer5 = noInterest6 = vpnOnlyCustomerThis textual convention denotes the role of a physical entity with respect to selective VRF download feature.
'invalid': The role of the physical entity is unknown, unconfigured, or the selective VRF download feature has yet to calculate it.
'standard': The role of the physical entity has interfaces configured in the default table and other VRF tables. The selective VRF download feature downloads all VRFs and prefixes to the physical entity.
'core': The role of the physical entity only has interfaces configured in the default table. The selective VRF download feature downloads all VRFs and local customer prefixes to the physical entity.
'customer': The role of the physical entity only has interfaces configured in VRF tables other than the default. The selective VRF download feature downloads all prefixes for locally provisioned VRFs.
'noInterest': The role of the physical entity does not have interfaces configured in any VRF tables. The selective VRF download feature does not download any prefixes to the physical entity.
'vpnOnlyCustomer': The role of the physical entity is for VPN-only customers (i.e., customers that do not need access to global routes). The selective VRF download feature downloads provisioned VRFs to the physical entity, and it filters all BGP routes from the default table. · Integer32
This object specifies the selective VRF download role of the physical entity. It can be updated based on interface to VRF association change or ip-address assignment to an interface belonging to the physical entity. For example:- - if no interfaces on a physical entity have IPv4 address configured, then it would be in Customer Facing Role for IPv4 address family. - if no interfaces on a physical entity have IPv6 address configured, then it would be in Not Interested Role for IPv6 address family. - now if the user adds an IPv4 address to an interface in default VRF, then the physical entity would turn Core-Facing for IPv4 AFI. - if the user would have added this interface in a named VRF, then the physical entity would have remained in Customer-Facing for IPv4 AFI. - if there are interfaces configured in both default VRF and named VRFs then the physical entity would turn in to Standard Role.