Definitions of Managed Objects for 6rd
draft-cai-softwire-6rd-mib-02
The information below is for an old version of the document.
| Document | Type |
This is an older version of an Internet-Draft whose latest revision state is "Expired".
|
|
|---|---|---|---|
| Authors | Lei Cai , Jacni Qin , Shishio Tsuchiya , Cui Wang , Wei Meng | ||
| Last updated | 2012-08-02 | ||
| RFC stream | (None) | ||
| Formats | |||
| Stream | Stream state | (No stream defined) | |
| Consensus boilerplate | Unknown | ||
| RFC Editor Note | (None) | ||
| IESG | IESG state | I-D Exists | |
| Telechat date | (None) | ||
| Responsible AD | (None) | ||
| Send notices to | (None) |
draft-cai-softwire-6rd-mib-02
Softwire WG L. Cai
Internet-Draft ZTE Corporation
Intended status: Standards Track J. Qin
Expires: February 3, 2013 Cisco
S. Tsuchiya
Cisco Systems
C. Wang
W. Meng
ZTE Corporation
August 2, 2012
Definitions of Managed Objects for 6rd
draft-cai-softwire-6rd-mib-02
Abstract
This document defines a portion of the Management Information Base
(MIB) for use with network management protocols. In particular, it
defines objects for managing 6rd devices.
Status of this Memo
This Internet-Draft is submitted in full conformance with the
provisions of BCP 78 and BCP 79.
Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF). Note that other groups may also distribute
working documents as Internet-Drafts. The list of current Internet-
Drafts is at http://datatracker.ietf.org/drafts/current/.
Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress."
This Internet-Draft will expire on February 3, 2013.
Copyright Notice
Copyright (c) 2012 IETF Trust and the persons identified as the
document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents
(http://trustee.ietf.org/license-info) in effect on the date of
publication of this document. Please review these documents
carefully, as they describe your rights and restrictions with respect
Cai, et al. Expires February 3, 2013 [Page 1]
Internet-Draft Definitions of Managed Objects for 6rd August 2012
to this document. Code Components extracted from this document must
include Simplified BSD License text as described in Section 4.e of
the Trust Legal Provisions and are provided without warranty as
described in the Simplified BSD License.
Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3
2. The Internet-Standard Management Framework . . . . . . . . . . 4
3. Conventions . . . . . . . . . . . . . . . . . . . . . . . . . 5
4. Structure of the MIB Module . . . . . . . . . . . . . . . . . 6
4.1. sixRdTable . . . . . . . . . . . . . . . . . . . . . . . . 6
4.2. sixRdBrIpv4AddressTable . . . . . . . . . . . . . . . . . 6
4.3. sixRdBrNameTable . . . . . . . . . . . . . . . . . . . . . 6
5. Relationship to Other MIB Modules . . . . . . . . . . . . . . 7
5.1. Relationship to the SNMPv2-MIB . . . . . . . . . . . . . . 7
5.2. Relationship to the IP Tunnel MIB . . . . . . . . . . . . 7
5.3. MIB modules required for IMPORTS . . . . . . . . . . . . . 8
6. Definitions . . . . . . . . . . . . . . . . . . . . . . . . . 9
7. Security Considerations . . . . . . . . . . . . . . . . . . . 13
8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 14
9. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 15
10. References . . . . . . . . . . . . . . . . . . . . . . . . . . 16
10.1. Normative References . . . . . . . . . . . . . . . . . . . 16
10.2. Informative References . . . . . . . . . . . . . . . . . . 17
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 18
Cai, et al. Expires February 3, 2013 [Page 2]
Internet-Draft Definitions of Managed Objects for 6rd August 2012
1. Introduction
This draft describes the Management Information Base (MIB) module for
6rd (IPv6 Rapid Deployment, [RFC5969]), which specifies an automatic
tunneling mechanism to deploy IPv6 to sites via a operator's IPv4
network.
Cai, et al. Expires February 3, 2013 [Page 3]
Internet-Draft Definitions of Managed Objects for 6rd August 2012
2. The Internet-Standard Management Framework
For a detailed overview of the documents that describe the current
Internet-Standard Management Framework, please refer to section 7 of
RFC 3410 [RFC3410].
Managed objects are accessed via a virtual information store, termed
the Management Information Base or MIB. MIB objects are generally
accessed through the Simple Network Management Protocol (SNMP).
Objects in the MIB are defined using the mechanisms defined in the
Structure of Management Information (SMI). This memo specifies a MIB
module that is compliant to the SMIv2, which is described in STD 58,
RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and STD 58, RFC 2580
[RFC2580].
Cai, et al. Expires February 3, 2013 [Page 4]
Internet-Draft Definitions of Managed Objects for 6rd August 2012
3. Conventions
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in RFC 2119 [RFC2119].
Cai, et al. Expires February 3, 2013 [Page 5]
Internet-Draft Definitions of Managed Objects for 6rd August 2012
4. Structure of the MIB Module
The MIB Module specified herein provides one way to manage the 6rd
devices through SNMP.
4.1. sixRdTable
This table contains the configuration information for 6rd.
4.2. sixRdBrIpv4AddressTable
This table contains the BR IPv4 Address for configurations on given
6rd CE device.
4.3. sixRdBrNameTable
This table contains the BR Domain Name for configurations on given
6rd CE device. 6rd CE device can use the BR Domain Name to get the BR
IPv4 address from DNS.
Cai, et al. Expires February 3, 2013 [Page 6]
Internet-Draft Definitions of Managed Objects for 6rd August 2012
5. Relationship to Other MIB Modules
5.1. Relationship to the SNMPv2-MIB
The 'system' group in the SNMPv2-MIB [RFC3418] is defined as being
mandatory for all systems, and the objects apply to the entity as a
whole. The 'system' group provides identification of the management
entity and certain other system-wide data. The SAMPLE-MIB does not
duplicate those objects.
5.2. Relationship to the IP Tunnel MIB
The IP Tunnel MIB [RFC4087] contains objects common to all IP
tunnels, including 6rd. Additionally, tunnel encapsulation specific
MIB (like what is defined in this document) extend the IP tunnel MIB
to further describe encapsulation specific information, for example
(in case of 6rd): 6rd prefix, 6rd Prefix Length, IPv4Mask Length and
BR IPv4 Address.
The implementation of the IP Tunnel MIB is required for 6rd. The
tunnelIfEncapsMethod in the tunnelIfEntry should be set to
sixRd("xx"), and an entry in the 6rd MIB module will exist for every
tunnelIfEntry with this tunnelIfEncapsMethod. The
tunnelIfRemoteAddress must be set to 0.0.0.0.
[Ed.Note:]This is similar to the situation of L2TP MIB [RFC3371]
case, since the IANA is requested to assign a value for sixRdMIB
under the "transmission" subtree. Also, a new IANAtunnelType (rather
than IANAifType) value is needed and should be recorded in the
IANAifType-MIB registry, refer to Section 8.
[Ed.Note:]There is another approach that a "tunnelIfXTable" can be
defined to extend the tunnelIfTable in [RFC4087], containing
additional objects for a particular tunnel (like 6rd). This is more
extendible to Tunnel MIB. By this means only additional objects
required will be defined and new IANAtunnelType will be assigned
accordingly, as a result of the advent of new IP tunneling protocal
which needs encapsulation specific information.
For example,
tunnelIfXTable OBJECT-TYPE
SYNTAX SEQUENCE OF TunnelIfXEntry
MAX-ACCESS read-write
STATUS current
DESCRIPTION
 "This table contains additional objects for the tunnel
interface table."
Cai, et al. Expires February 3, 2013 [Page 7]
Internet-Draft Definitions of Managed Objects for 6rd August 2012
::= { tunnel xx }
tunnelIfXEntry OBJECT-TYPE
SYNTAX TunnelIfXEntry
MAX-ACCESS read-write
STATUS current
DESCRIPTION
""An entry containing additional information applicable to a
particular tunnel interface."
INDEX { ifIndex }
::= { tunnelIfXTable 1 }
TunnelIfXEntry ::= SEQUENCE {
xxx xxx, -- encapsulation specific
xxx xxx -- encapsulation specific
}
5.3. MIB modules required for IMPORTS
This MIB module IMPORTs objects from [RFC4087], [RFC2580], [RFC2578],
[RFC2863], [RFC3411].
Cai, et al. Expires February 3, 2013 [Page 8]
Internet-Draft Definitions of Managed Objects for 6rd August 2012
6. Definitions
SIXRD-MIB DEFINITIONS ::= BEGIN
IMPORTS
OBJECT-TYPE, transmission, Integer32
FROM SNMPv2-SMI
ifIndex
FROM IF-MIB
InetAddressIPv4, InetAddressPrefixLength, InetAddressIPv6
FROM INET-ADDRESS-MIB
sixRdMIB MODULE-IDENTITY
LAST-UPDATED "201202030000Z" -- February 3, 2012
ORGANIZATION "IETF Softwire Working Group"
CONTACT-INFO
"Lei Cai
ZTE
No. 68 Zijinhua Rd.
Nanjing 210012
China
EMail: cai.lei3@zte.com.cn
Jacni Qin
Cisco
Shanghai
China
EMail: jacni@jacni.com
Shishio Tsuchiya
Cisco Systems
Shinjuku Mitsui Building, 2-1-1, Nishi-Shinjuku
Tokyo, 163-0409
Japan
Email: shtsuchi@cisco.com"
DESCRIPTION
"The MIB module defines managed objects for 6rd."
:: = { transmission XX } ---xx to be replaced
sixRdDevice OBJECT-TYPE
SYNTAX Integer32 (0..1)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
Cai, et al. Expires February 3, 2013 [Page 9]
Internet-Draft Definitions of Managed Objects for 6rd August 2012
"A value of 1 indicates the device is a 6rd BR, or 0
indicates the device is a 6rd CE."
::= { sixRdMIB 1 }
sixRdTable OBJECT-TYPE
SYNTAX SEQUENCE OF SixRdEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The table contains the configuration information of 6rd on
a particular tunnel."
::= { sixRdMIB 2 }
sixRdEntry OBJECT-TYPE
SYNTAX SixRdEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry containing the configuration information of 6rd
on a particular tunnel."
INDEX {ifIndex}
::= { sixRdTable 1 }
SixRdEntry ::= SEQUENCE {
sixRdPrefix InetAddressIPv6
sixRdPrefixLen InetAddressPrefixLength
sixRdIpv4MaskLen Integer32
}
sixRdPrefix OBJECT-TYPE {
SYNTAX InetAddressIPv6
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The 6rd prefix of this 6rd domain."
::= { sixRdEntry 1 }
sixRdPrefixLen OBJECT-TYPE {
SYNTAX InetAddressPrefixLength
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The length of 6rd prefix."
::= { sixRdEntry 2 }
sixRdIpv4MaskLen OBJECT-TYPE {
SYNTAX Integer32 (0..32)
Cai, et al. Expires February 3, 2013 [Page 10]
Internet-Draft Definitions of Managed Objects for 6rd August 2012
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The number of high-order bits that are identical across
all CE IPv4 addresses within this 6rd domain."
::= { sixRdEntry 3 }
sixRdBrIpv4AddressTable OBJECT-TYPE {
SYNTAX SEQUENCE OF SixRdBrIpv4AddressEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The table contains the BR IPv4 Address of given 6rd domain
if the value of 6rdDevice is 0 (i.e., 6rd CE), or should be omitted
if the value of 6rdDevice is 1 (i.e., 6rd BR)."
::= { sixRdMIB 3 }
sixRdBrIpv4AddressEntry OBJECT-TYPE {
SYNTAX SixRdBrIpv4AddressEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry containing the BR IPv4 Address of given 6rd
domain."
INDEX {ifIndex, sixRdBrIpv4Address }
::= { sixRdBrIpv4AddressTable 1 }
sixRdBrIpv4AddressEntry ::= SEQUENCE {
sixRdBrIpv4Address InetAddressIPv4
}
sixRdBrIpv4Address OBJECT-TYPE
SYNTAX InetAddressIPv4
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The BR IPv4 Address of this 6rd domain."
::= { sixRdBrIpv4AddressEntry 1 }
sixRdBrNameTable OBJECT-TYPE
SYNTAX SEQUENCE OF SixRdBrNameEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The table contains the BR Domain Name of given 6rd domain
if the value of 6rdDevice is 0 (i.e.,6rd CE), or should be omitted if
the value of 6rdDevice is 1 (i.e., 6rd BR)."
::= { sixRdMIB 4 }
Cai, et al. Expires February 3, 2013 [Page 11]
Internet-Draft Definitions of Managed Objects for 6rd August 2012
sixRdBrNameEntry OBJECT-TYPE
SYNTAX SixRdBrNameEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry containing the BR Domain Name of given 6rd
domain."
INDEX {ifIndex, sixRdBrName }
::= { sixRdBrNameTable 1 }
SixRdBrNameEntry ::= SEQUENCE {
sixRdBrName OCTET STRING
}
sixRdBrName OBJECT-TYPE
SYNTAX OCTET STRING
STATUS current
DESCRIPTION
"The BR Domain Name of this 6rd domain."
::= { sixRdBrNameEntry 1 }
END
Cai, et al. Expires February 3, 2013 [Page 12]
Internet-Draft Definitions of Managed Objects for 6rd August 2012
7. Security Considerations
This document does not introduce any new security concern in addition
to what is discussed in Section 6 of [RFC4087].
Cai, et al. Expires February 3, 2013 [Page 13]
Internet-Draft Definitions of Managed Objects for 6rd August 2012
8. IANA Considerations
The MIB module in this document uses the following IANA-assigned
OBJECT IDENTIFIER values recorded in the SMI Numbers registry, and
the following IANA-assigned tunnelType values recorded in the
IANAifType-MIB registry:
Descriptor OBJECT IDENTIFIER value
---------- -----------------------
sixRdMIB { transmission XXX }
IANAtunnelType ::= TEXTUAL-CONVENTION
SYNTAX INTEGER {
sixRd ("XX") -- 6rd encapsulation
}
Cai, et al. Expires February 3, 2013 [Page 14]
Internet-Draft Definitions of Managed Objects for 6rd August 2012
9. Acknowledgements
TBD.
Cai, et al. Expires February 3, 2013 [Page 15]
Internet-Draft Definitions of Managed Objects for 6rd August 2012
10. References
10.1. Normative References
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, March 1997.
[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.
[RFC3371] Caves, E., Calhoun, P., and R. Wheeler, "Layer Two
Tunneling Protocol "L2TP" Management Information Base",
RFC 3371, August 2002.
[RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart,
"Introduction and Applicability Statements for Internet-
Standard Management Framework", RFC 3410, December 2002.
[RFC3411] Harrington, D., Presuhn, R., and B. Wijnen, "An
Architecture for Describing Simple Network Management
Protocol (SNMP) Management Frameworks", STD 62, RFC 3411,
December 2002.
[RFC3418] Presuhn, R., "Management Information Base (MIB) for the
Simple Network Management Protocol (SNMP)", STD 62,
RFC 3418, December 2002.
[RFC4087] Thaler, D., "IP Tunnel MIB", RFC 4087, June 2005.
[RFC5969] Townsley, W. and O. Troan, "IPv6 Rapid Deployment on IPv4
Infrastructures (6rd) -- Protocol Specification",
RFC 5969, August 2010.
Cai, et al. Expires February 3, 2013 [Page 16]
Internet-Draft Definitions of Managed Objects for 6rd August 2012
10.2. Informative References
[RFC4181] Heard, C., "Guidelines for Authors and Reviewers of MIB
Documents", BCP 111, RFC 4181, September 2005.
Cai, et al. Expires February 3, 2013 [Page 17]
Internet-Draft Definitions of Managed Objects for 6rd August 2012
Authors' Addresses
Cai Lei
ZTE Corporation
No. 68 Zijinhua Rd.
Nanjing 210012
China
Email: cai.lei3@zte.com.cn
Jacni Qin
Cisco
Shanghai
P.R.China
Email: jacni@jacni.com
Shishio Tsuchiya
Cisco Systems
Shinjuku Mitsui Building, 2-1-1, Nishi-Shinjuku
Tokyo 163-0409
Japan
Email: shtsuchi@cisco.com
Cui Wang
ZTE Corporation
No.50 Software Avenue, Yuhuatai District
Nanjing
China
Email: wang.cui1@zte.com.cn
Wei Meng
ZTE Corporation
No.50 Software Avenue, Yuhuatai District
Nanjing
China
Email: meng.wei2@zte.com.cn
Cai, et al. Expires February 3, 2013 [Page 18]