Ethernet-Based xDSL Multi-Pair Bonding (G.Bond/Ethernet) MIB
RFC 6767
| Document | Type | RFC - Proposed Standard (February 2013) Errata | |
|---|---|---|---|
| Authors | Edward Beili , Moti Morgenstern | ||
| Last updated | 2020-01-21 | ||
| RFC stream | Internet Engineering Task Force (IETF) | ||
| Formats | |||
| Additional resources | Mailing list discussion | ||
| IESG | Responsible AD | Benoît Claise | |
| Send notices to | (None) |
RFC 6767
quot;A read-only object indicating whether or not this history
bucket contains valid data. A valid bucket is reported as
true(1) and an invalid bucket as false(2).
If this history bucket is invalid, the BTU MUST NOT produce
notifications based upon the value of the counters in this
bucket.
Note that an implementation may decide not to store invalid
history buckets in its database. In such a case, this object
is not required, as only valid history buckets are available
while invalid history buckets are simply not in the database.
This object partially maps to the TR-159 attribute
aGroupPerf1DayIntervalValid."
REFERENCE
"[TR-159], Section 5.5.1.63"
::= { g9982PortPm1DayEntry 11 }
-------------------------------
-- BCE group
-------------------------------
g9982BceConfTable OBJECT-TYPE
SYNTAX SEQUENCE OF G9982BceConfEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Table for configuration of G.Bond/Eth-specific aspects for the
Bonding Channel Entity (BCE) ports (modems/channels).
Entries in this table MUST be maintained in a persistent
manner."
::= { g9982Bce 1 }
Beili & Morgenstern Standards Track [Page 40]
RFC 6767 G.Bond/Ethernet MIB February 2013
g9982BceConfEntry OBJECT-TYPE
SYNTAX G9982BceConfEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry in the G.Bond/Eth BCE Configuration table.
Each entry represents G.998.2-specific aspects of a BCE port
indexed by the ifIndex. Note that a G.Bond/Eth BCE port can be
stacked below a single GBS port, also indexed by the ifIndex."
INDEX { ifIndex }
::= { g9982BceConfTable 1 }
G9982BceConfEntry ::=
SEQUENCE {
g9982BceConfEligibleGroupID PhysAddress,
g9982BceConfPeerEligibleGroupID PhysAddress
}
g9982BceConfEligibleGroupID OBJECT-TYPE
SYNTAX PhysAddress (SIZE(0|6))
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"BACP Eligible Group ID of a G.Bond/ETH BCE port.
A universally unique 6-octet-long identifier, used by the
OPTIONAL BACP, to determine bonding eligibility. When two BCEs
have the same g9982BceConfEligibleGroupID on a system, they
are eligible to be aggregated on that system. Typically, all
BCEs on a BTU-R device would be assigned the same
g9982BceConfEligibleGroupID, to assert that all of the BCEs
should be in the same bonded group. BCEs with different
g9982BceConfEligibleGroupID values MUST NOT be connected to
the same GBS.
BCEs with the same g9982BceConfEligibleGroupID MAY be
connected to different GBS ports.
This object MUST be instantiated during BACP initialization,
when every BCE belongs to its own GBS. Attempts to change this
object MUST be rejected (with the error inconsistentValue), if
the BCE is aggregated with other BCEs, i.e., more than one BCE
is connected to the same GBS, or if the BCE in question is not
eligible to be bonded with other BCEs having the same value
(e.g., the bonding is limited to a single line card and BCEs are
located on different line cards, or BCEs are the channels of
the same line).
Beili & Morgenstern Standards Track [Page 41]
RFC 6767 G.Bond/Ethernet MIB February 2013
Note that bonding eligibility is reflected in the
ifCapStackTable and its inverse, the ifInvCapStackTable;
as such, any modification of g9982BceConfEligibleGroupID MUST
be reflected in these tables.
A zero-length octet string SHALL be returned on an attempt to
read this object on systems not supporting BACP (the value of
g9982PortCapBacpSupported for the connected GBS is false).
This object maps to the TR-159 attribute
aChannelEligibleGroupID."
REFERENCE
"[TR-159], Section 5.5.7.3"
::= { g9982BceConfEntry 1 }
g9982BceConfPeerEligibleGroupID OBJECT-TYPE
SYNTAX PhysAddress (SIZE(0|6))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"BACP Eligible Group ID of a peer G.Bond/ETH BCE port, most
recently received by the local BCE via a Local info TLV BACPDU
message from the peer BCE.
A universally unique 6-octet-long identifier, used by the
OPTIONAL BACP, to determine bonding eligibility.
BCEs with different g9982BceConfPeerEligibleGroupID values
MUST NOT be connected to the same GBS.
BCEs with the same g9982BceConfPeerEligibleGroupID MAY be
connected to different GBS ports.
A zero-length octet string SHALL be returned on an attempt to
read this object on systems not supporting BACP (the value of
g9982PortCapBacpSupported for the connected GBS is false)
or when no BACPDUs have been received from the peer BCE.
This object maps to the G.998.2-Amd2 attribute
Remote Group ID."
REFERENCE
"[G.998.2-Amd2], Appendix C.3.1.6"
::= { g9982BceConfEntry 2 }
g9982BceStatTable OBJECT-TYPE
SYNTAX SEQUENCE OF G9982BceStatEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table provides common status information of G.Bond/Eth
BCE ports.
Beili & Morgenstern Standards Track [Page 42]
RFC 6767 G.Bond/Ethernet MIB February 2013
This table contains live data from the equipment. As such,
it is NOT persistent."
::= { g9982Bce 2 }
g9982BceStatEntry OBJECT-TYPE
SYNTAX G9982BceStatEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry in the G.Bond/Eth BCE Status table.
Each entry represents common aspects of a G.Bond/Eth BCE port
indexed by the ifIndex. Note that a BCE port can be stacked
below a single GBS port, also indexed by the ifIndex,
possibly together with other BCE ports."
INDEX { ifIndex }
::= { g9982BceStatTable 1 }
G9982BceStatEntry ::=
SEQUENCE {
g9982BceStatTcInCodingErrors Counter32,
g9982BceStatTcInCrcErrors Counter32
}
g9982BceStatTcInCodingErrors OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"A number of PTM-TC encapsulation errors. This counter is
incremented for each encapsulation error detected by the
PTM-TC receive function.
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 ifCounterDiscontinuityTime, as
defined in the IF-MIB.
This object maps to the TR-159 attribute
aChannelPtmTcRxCodingViolations."
REFERENCE
"[TR-159], Section 5.5.7.8"
::= { g9982BceStatEntry 1 }
g9982BceStatTcInCrcErrors OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
Beili & Morgenstern Standards Track [Page 43]
RFC 6767 G.Bond/Ethernet MIB February 2013
DESCRIPTION
"A number of PTM-TC CRC errors. This counter is incremented
for each CRC error detected by the PTM-TC receive function.
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 ifCounterDiscontinuityTime, as
defined in the IF-MIB.
This object maps to the TR-159 attribute
aChannelPtmTcRxCrcErrors."
REFERENCE
"[TR-159], Section 5.5.7.9"
::= { g9982BceStatEntry 2 }
-------------------------------
-- Conformance Statements
-------------------------------
g9982Groups OBJECT IDENTIFIER
::= { g9982Conformance 1 }
g9982Compliances OBJECT IDENTIFIER
::= { g9982Conformance 2 }
-- Object groups
g9982BasicGroup OBJECT-GROUP
OBJECTS {
g9982PortCapTcTypesSupported,
g9982PortCapBacpSupported,
g9982PortConfTcAdminType,
g9982PortStatTcOperType,
g9982PortStatRxErrors,
g9982PortStatRxSmallFragments,
g9982PortStatRxLargeFragments,
g9982PortStatRxBadFragments,
g9982PortStatRxLostFragments,
g9982PortStatRxLostStarts,
g9982PortStatRxLostEnds,
g9982PortStatRxOverflows,
g9982BceStatTcInCodingErrors,
g9982BceStatTcInCrcErrors
}
STATUS current
Beili & Morgenstern Standards Track [Page 44]
RFC 6767 G.Bond/Ethernet MIB February 2013
DESCRIPTION
"A collection of objects representing management information
for G.Bond/Eth GBS ports."
::= { g9982Groups 1 }
g9982BacpGroup OBJECT-GROUP
OBJECTS {
g9982PortConfAdminCp,
g9982PortStatOperCp,
g9982BceConfEligibleGroupID,
g9982BceConfPeerEligibleGroupID
}
STATUS current
DESCRIPTION
"A collection of objects representing management information
for the OPTIONAL frame-based Bonding Aggregation Control
Protocol (BACP) used by G.Bond/Eth GBS ports instead of the
mandatory G.hs-based discovery and aggregation protocol."
::= { g9982Groups 2 }
g9982BceGroup OBJECT-GROUP
OBJECTS {
g9982BceStatTcInCodingErrors,
g9982BceStatTcInCrcErrors
}
STATUS current
DESCRIPTION
"A collection of objects representing OPTIONAL management
information for G.Bond/Eth BCE ports."
::= { g9982Groups 3 }
g9982PerfCurrGroup OBJECT-GROUP
OBJECTS {
g9982PortPm15MinValidIntervals,
g9982PortPm15MinInvalidIntervals,
g9982PortPmCur15MinTimeElapsed,
g9982PortPmCur15MinRxErrors,
g9982PortPmCur15MinRxSmallFragments,
g9982PortPmCur15MinRxLargeFragments,
g9982PortPmCur15MinRxBadFragments,
g9982PortPmCur15MinRxLostFragments,
g9982PortPmCur15MinRxLostStarts,
g9982PortPmCur15MinRxLostEnds,
g9982PortPmCur15MinRxOverflows,
g9982PortPm1DayValidIntervals,
g9982PortPm1DayInvalidIntervals,
g9982PortPmCur1DayTimeElapsed,
Beili & Morgenstern Standards Track [Page 45]
RFC 6767 G.Bond/Ethernet MIB February 2013
g9982PortPmCur1DayRxErrors,
g9982PortPmCur1DayRxSmallFragments,
g9982PortPmCur1DayRxLargeFragments,
g9982PortPmCur1DayRxBadFragments,
g9982PortPmCur1DayRxLostFragments,
g9982PortPmCur1DayRxLostStarts,
g9982PortPmCur1DayRxLostEnds,
g9982PortPmCur1DayRxOverflows
}
STATUS current
DESCRIPTION
"A collection of objects supporting OPTIONAL current Performance
Monitoring information for G.Bond/Eth ports."
::= { g9982Groups 4 }
g9982Perf15MinGroup OBJECT-GROUP
OBJECTS {
g9982PortPm15MinIntervalMoniTime,
g9982PortPm15MinIntervalRxErrors,
g9982PortPm15MinIntervalRxSmallFragments,
g9982PortPm15MinIntervalRxLargeFragments,
g9982PortPm15MinIntervalRxBadFragments,
g9982PortPm15MinIntervalRxLostFragments,
g9982PortPm15MinIntervalRxLostStarts,
g9982PortPm15MinIntervalRxLostEnds,
g9982PortPm15MinIntervalRxOverflows,
g9982PortPm15MinIntervalValid
}
STATUS current
DESCRIPTION
"A collection of objects supporting OPTIONAL historical
Performance Monitoring information for G.Bond/Eth ports, during
previous 15-minute intervals."
::= { g9982Groups 5 }
g9982Perf1DayGroup OBJECT-GROUP
OBJECTS {
g9982PortPm1DayIntervalMoniTime,
g9982PortPm1DayIntervalRxErrors,
g9982PortPm1DayIntervalRxSmallFragments,
g9982PortPm1DayIntervalRxLargeFragments,
g9982PortPm1DayIntervalRxBadFragments,
g9982PortPm1DayIntervalRxLostFragments,
g9982PortPm1DayIntervalRxLostStarts,
g9982PortPm1DayIntervalRxLostEnds,
g9982PortPm1DayIntervalRxOverflows,
g9982PortPm1DayIntervalValid
}
Beili & Morgenstern Standards Track [Page 46]
RFC 6767 G.Bond/Ethernet MIB February 2013
STATUS current
DESCRIPTION
"A collection of objects supporting OPTIONAL historical
Performance Monitoring information for G.Bond/Eth ports, during
previous 1-day intervals."
::= { g9982Groups 6 }
-------------------------------
-- Compliance Statements
-------------------------------
g9982Compliance MODULE-COMPLIANCE
STATUS current
DESCRIPTION
"The compliance statement for G.Bond Ethernet interfaces.
Compliance with the following external compliance statements
is REQUIRED:
MIB Module Compliance Statement
---------- --------------------
IF-MIB ifCompliance3
GBOND-MIB gBondCompliance"
MODULE -- this module
MANDATORY-GROUPS {
g9982BasicGroup
}
GROUP g9982BceGroup
DESCRIPTION
"Support for this group is OPTIONAL."
GROUP g9982BacpGroup
DESCRIPTION
"Support for this group is OPTIONAL and only required for
implementations supporting BACP."
GROUP g9982PerfCurrGroup
DESCRIPTION
"Support for this group is only required for implementations
supporting Performance Monitoring."
GROUP g9982Perf15MinGroup
DESCRIPTION
"Support for this group is only required for implementations
supporting 15-minute historical Performance Monitoring."
Beili & Morgenstern Standards Track [Page 47]
RFC 6767 G.Bond/Ethernet MIB February 2013
GROUP g9982Perf1DayGroup
DESCRIPTION
"Support for this group is only required for implementations
supporting 1-day historical Performance Monitoring."
OBJECT g9982PortCapTcTypesSupported
SYNTAX BITS {
tc6465(0),
tcHDLC(1)
}
DESCRIPTION
"Support for all TC types is not required. However, at least
one value SHALL be supported."
OBJECT g9982PortCapBacpSupported
SYNTAX TruthValue
DESCRIPTION
"Support for BACP is OPTIONAL; therefore, a value of false(2)
SHALL be supported."
OBJECT g9982PortConfTcAdminType
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required (needed only for GBS
supporting more than a single TC encapsulation type, i.e.,
tc6465 and tcHDLC)."
OBJECT g9982PortConfAdminCp
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required (needed only for GBS
supporting BACP in addition to mandatory G.hs-based bonding
discovery and aggregation protocol)."
::= { g9982Compliances 1 }
END
Beili & Morgenstern Standards Track [Page 48]
RFC 6767 G.Bond/Ethernet MIB February 2013
7. Security Considerations
There are a number of managed objects defined in this MIB module with
a MAX-ACCESS clause of read-write and/or read-create. Such objects
may be considered sensitive or vulnerable in some network
environments. The support for SET operations in a non-secure
environment without proper protection can have a negative effect on
network operations. These are the tables and objects and their
sensitivity/vulnerability:
o Changing of g9982PortConfTable configuration parameters (e.g.,
g9982PortConfTcAdminType) may lead to a complete service
interruption in cases where the specified PTM-TC encapsulation
type is not supported by the remote end.
o Changing of g9982BceConfTable configuration parameters (e.g.,
g9982BceConfEligibleGroupID) may lead to preventing a non-bonded
BCE from being bonded in any bonding group, or false advertisement
of bonding eligibility (e.g., between BCEs residing on different
line cards in an application that does not support cross-card
bonding).
Some of the readable objects in this MIB module (i.e., objects with a
MAX-ACCESS other than not-accessible) may be considered sensitive or
vulnerable in some network environments since, collectively, they
provide information about the performance of network interfaces and
can reveal some aspects of their configuration.
It is thus important to control even GET and/or NOTIFY access to
these objects and possibly to even encrypt the values of these
objects when sending them over the network via SNMP. These are the
tables and objects and their sensitivity/vulnerability:
o g9982PortStatTable - objects in this table (e.g.,
g9982PortStatTcOperType) provide status information for the G.Bond
port, which may aid in deciphering of the G.Bond/ETH
transmissions.
SNMP versions prior to SNMPv3 did not include adequate security.
Even if the network itself is secure (for example by using IPsec),
there is no control as to who on the secure network is allowed to
access and GET/SET (read/change/create/delete) the objects in this
MIB module.
Implementations SHOULD provide the security features described by the
SNMPv3 framework (see [RFC3410]), and implementations claiming
compliance to the SNMPv3 standard MUST include full support for
authentication and privacy via the User-based Security Model (USM)
Beili & Morgenstern Standards Track [Page 49]
RFC 6767 G.Bond/Ethernet MIB February 2013
[RFC3414] with the AES cipher algorithm [RFC3826]. Implementations
MAY also provide support for the Transport Security Model (TSM)
[RFC5591] in combination with a secure transport such as SSH
[RFC5592] or TLS/DTLS [RFC6353].
Further, deployment of SNMP versions prior to SNMPv3 is NOT
RECOMMENDED. Instead, it is RECOMMENDED to deploy SNMPv3 and to
enable cryptographic security. It is then a customer/operator
responsibility to ensure that the SNMP entity giving access to an
instance of this MIB module is properly configured to give access to
the objects only to those principals (users) that have legitimate
rights to indeed GET or SET (change/create/delete) them.
8. IANA Considerations
IANA has assigned 264 as the object identifier for the g9982MIB
MODULE-IDENTITY in the MIB-2 transmission sub-tree
<http://www.iana.org/>.
9. Acknowledgments
This document was produced by the [ADSLMIB] working group.
Special thanks to Dan Romascanu for his meticulous review of this
text.
10. References
10.1. Normative References
[802.3] IEEE, "IEEE Standard for Information technology -
Telecommunications and information exchange between
systems - Local and metropolitan area networks - Specific
requirements - Part 3: Carrier Sense Multiple Access with
Collision Detection (CSMA/CD) Access Method and Physical
Layer Specifications", IEEE Std 802.3-2005, December 2005.
[G.998.2] ITU-T, "Ethernet-based multi-pair bonding", ITU-T
Recommendation G.998.2, January 2005,
<http://www.itu.int/rec/T-REC-G.998.2/en>.
[G.998.2-Amd2]
ITU-T, "Ethernet-based multi-pair bonding Amendment 2",
ITU-T Recommendation G.998.2/Amd.2, December 2007,
<http://www.itu.int/rec/T-REC-G.998.2-200712-I!Amd2/en>.
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, March 1997.
Beili & Morgenstern Standards Track [Page 50]
RFC 6767 G.Bond/Ethernet MIB February 2013
[RFC2578] McCloghrie, K., Ed., Perkins, D., Ed., and J.
Schoenwaelder, Ed., "Structure of Management Information
Version 2 (SMIv2)", STD 58, RFC 2578, April 1999.
[RFC2579] McCloghrie, K., Ed., Perkins, D., Ed., and J.
Schoenwaelder, Ed., "Textual Conventions for SMIv2",
STD 58, RFC 2579, April 1999.
[RFC2580] McCloghrie, K., Perkins, D., and J. Schoenwaelder,
"Conformance Statements for SMIv2", STD 58, RFC 2580,
April 1999.
[RFC2863] McCloghrie, K. and F. Kastenholz, "The Interfaces Group
MIB", RFC 2863, June 2000.
[RFC3414] Blumenthal, U. and B. Wijnen, "User-based Security Model
(USM) for version 3 of the Simple Network Management
Protocol (SNMPv3)", STD 62, RFC 3414, December 2002.
[RFC3705] Ray, B. and R. Abbi, "High Capacity Textual Conventions
for MIB Modules Using Performance History Based on 15
Minute Intervals", RFC 3705, February 2004.
[RFC3826] Blumenthal, U., Maino, F., and K. McCloghrie, "The
Advanced Encryption Standard (AES) Cipher Algorithm in the
SNMP User-based Security Model", RFC 3826, June 2004.
[RFC5591] Harrington, D. and W. Hardaker, "Transport Security Model
for the Simple Network Management Protocol (SNMP)",
RFC 5591, June 2009.
[RFC5592] Harrington, D., Salowey, J., and W. Hardaker, "Secure
Shell Transport Model for the Simple Network Management
Protocol (SNMP)", RFC 5592, June 2009.
[RFC6353] Hardaker, W., "Transport Layer Security (TLS) Transport
Model for the Simple Network Management Protocol (SNMP)",
RFC 6353, July 2011.
[RFC6765] Beili, E. and M. Morgenstern, "xDSL Multi-Pair Bonding
(G.Bond) MIB", RFC 6765, February 2013.
[TR-159] Beili, E. and M. Morgenstern, "Management Framework for
xDSL Bonding", Broadband Forum Technical Report TR-159,
December 2008, <http://www.broadband-forum.org/technical/
download/TR-159.pdf>.
Beili & Morgenstern Standards Track [Page 51]
RFC 6767 G.Bond/Ethernet MIB February 2013
10.2. Informative References
[ADSLMIB] IETF, "ADSL MIB (adslmib) Charter",
<http://datatracker.ietf.org/wg/adslmib/charter/>.
[G.991.2] ITU-T, "Single-pair high-speed digital subscriber line
(SHDSL) transceivers", ITU-T Recommendation G.991.2,
December 2003, <http://www.itu.int/rec/T-REC-G.991.2/en>.
[G.993.1] ITU-T, "Very high speed digital subscriber line
transceivers (VDSL)", ITU-T Recommendation G.993.1,
June 2004, <http://www.itu.int/rec/T-REC-G.993.1/en>.
[G.994.1] ITU-T, "Handshake procedures for digital subscriber line
(DSL) transceivers", ITU-T Recommendation G.994.1,
February 2007, <http://www.itu.int/rec/T-REC-G.994.1/en>.
[IEEE802.3.1]
IEEE, "IEEE P802.3.1 Revision to IEEE Std 802.3.1-2011
(IEEE 802.3.1a) Ethernet MIBs Task Force", January 2012,
<http://grouper.ieee.org/groups/802/3/1/>.
[RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart,
"Introduction and Applicability Statements for Internet-
Standard Management Framework", RFC 3410, December 2002.
[RFC3593] Tesink, K., "Textual Conventions for MIB Modules Using
Performance History Based on 15 Minute Intervals",
RFC 3593, September 2003.
[RFC3635] Flick, J., "Definitions of Managed Objects for the
Ethernet-like Interface Types", RFC 3635, September 2003.
[RFC3728] Ray, B. and R. Abbi, "Definitions of Managed Objects for
Very High Speed Digital Subscriber Lines (VDSL)",
RFC 3728, February 2004.
[RFC4181] Heard, C., "Guidelines for Authors and Reviewers of MIB
Documents", BCP 111, RFC 4181, September 2005.
[RFC4319] Sikes, C., Ray, B., and R. Abbi, "Definitions of Managed
Objects for High Bit-Rate DSL - 2nd generation (HDSL2) and
Single-Pair High-Speed Digital Subscriber Line (SHDSL)
Lines", RFC 4319, December 2005.
Beili & Morgenstern Standards Track [Page 52]
RFC 6767 G.Bond/Ethernet MIB February 2013
[RFC4836] Beili, E., "Definitions of Managed Objects for
IEEE 802.3 Medium Attachment Units (MAUs)", RFC 4836,
April 2007.
[RFC5066] Beili, E., "Ethernet in the First Mile Copper (EFMCu)
Interfaces MIB", RFC 5066, November 2007.
Authors' Addresses
Edward Beili
Actelis Networks
25 Bazel St.
Petach-Tikva 49103
Israel
Phone: +972-3-924-3491
EMail: edward.beili@actelis.com
Moti Morgenstern
ECI Telecom
30 Hasivim St.
Petach-Tikva 4951169
Israel
Phone: +972-3-926-6258
EMail: moti.morgenstern@ecitele.com
Beili & Morgenstern Standards Track [Page 53]