[Docs] [txt|pdf|xml|html] [Tracker] [Email] [Nits]

Versions: 00

Network Working Group                                     J. Dionne, Ed.
Internet-Draft                                               M. Blanchet
Intended status: Standards Track                                Viagenie
Expires: January 4, 2012                                    July 3, 2011


                 CGN Management Information Base (MIB)
                    draft-jpdionne-behave-cgn-mib-00

Abstract

   This memo describes the "Carrier Grade NAT" (CGN) Management
   Information Base (MIB).  It is a complement to the NAT-MIB to cope
   with additional requirements for NAT deployed in large scale
   networks.

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 January 4, 2012.

Copyright Notice

   Copyright (c) 2011 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
   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.




Dionne & Blanchet        Expires January 4, 2012                [Page 1]


Internet-Draft    CGN Management Information Base (MIB)        July 2011


Table of Contents

   1.  Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . 3
   2.  The Internet-Standard Management Framework  . . . . . . . . . . 3
   3.  Structure of the MIB Module . . . . . . . . . . . . . . . . . . 3
     3.1.  Textual Conventions . . . . . . . . . . . . . . . . . . . . 3
     3.2.  The Configuration Subtree . . . . . . . . . . . . . . . . . 3
     3.3.  The State Subtree . . . . . . . . . . . . . . . . . . . . . 3
     3.4.  The Notifications Subtree . . . . . . . . . . . . . . . . . 4
     3.5.  The Table Structures  . . . . . . . . . . . . . . . . . . . 4
   4.  Relationship to Other MIB Modules . . . . . . . . . . . . . . . 4
     4.1.  Relationship to the RFC4008 MIB . . . . . . . . . . . . . . 4
     4.2.  MIB modules required for IMPORTS  . . . . . . . . . . . . . 4
   5.  Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . 4
   6.  Security Considerations . . . . . . . . . . . . . . . . . . . . 8
   7.  IANA Considerations . . . . . . . . . . . . . . . . . . . . . . 8
   8.  Contributors  . . . . . . . . . . . . . . . . . . . . . . . . . 8
   9.  References  . . . . . . . . . . . . . . . . . . . . . . . . . . 8
     9.1.  Normative References  . . . . . . . . . . . . . . . . . . . 8
     9.2.  Informative References  . . . . . . . . . . . . . . . . . . 9































Dionne & Blanchet        Expires January 4, 2012                [Page 2]


Internet-Draft    CGN Management Information Base (MIB)        July 2011


1.  Introduction

   This memo defines a MIB module to cover additionnal requirements of
   the Carrier Grade NAT (CGN) [I-D.ietf-behave-lsn-requirements].  It
   is a complement to the NAT-MIB [RFC4008].  Monitoring of CGN devices
   is essential to ensure that resources are fairly distributed amongs
   users.  The memo is divided in three parts: configuration, state
   monitoring and notifications.

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].

3.  Structure of the MIB Module

3.1.  Textual Conventions

   1.  CgnProtocolType represents the protocol numbers from the IANA
       registry.  It is used to describe to limits for UDP, TCP, ICMP,
       etc.

3.2.  The Configuration Subtree

   According to REQ-2 and REQ-3 of [I-D.ietf-behave-lsn-requirements], a
   CGN should limit port allocation.

3.3.  The State Subtree

   natAddrMapTable is extended to provide live statistics on the number
   of external port and IP addresses in usage (cgnAddrPoolUsage)

   [RFC4008] allows one to access session information for all the CGN.
   However, in practice, sessions and bindings tables for a CGN are too
   large to walk.  Entries should be indexed differently on a per
   subscriber basis (See CgnSubscrTable below).





Dionne & Blanchet        Expires January 4, 2012                [Page 3]


Internet-Draft    CGN Management Information Base (MIB)        July 2011


   [To be determined]
      - Link with natSessionID of RFC4008 natSessionTable
      - Table of port usage per IP addresses.

3.4.  The Notifications Subtree

   The CGN-MIB defines three types of notifications, similar to events
   defined in [I-D.sivakumar-behave-nat-logging].  It includes: address
   exhaustion (cgnAddrPoolExhaustion), port exhaustion
   (cgnPortExhaustion) and user quota exceeded (cgnQuotaExceeded).

3.5.  The Table Structures

   TBD

4.  Relationship to Other MIB Modules

4.1.  Relationship to the RFC4008 MIB

   TBD

4.2.  MIB modules required for IMPORTS

   The following MIB module IMPORTS objects from NAT-MIB [RFC4008],
   SNMP-FRAMEWORK-MIB [RFC3411], INET-ADDRESS-MIB [RFC4001].

5.  Definitions

 CGN-MIB DEFINITIONS ::= BEGIN
 IMPORTS
      MODULE-IDENTITY,
      OBJECT-TYPE,
      Gauge32,
      Counter64,
      mib-2,
      NOTIFICATION-TYPE
              FROM SNMPv2-SMI
      TEXTUAL-CONVENTION,
      StorageType,
      RowStatus
              FROM SNMPv2-TC
      MODULE-COMPLIANCE,
      NOTIFICATION-GROUP,
      OBJECT-GROUP
              FROM SNMPv2-CONF
      natMIB,
      NatAddrMapId
              FROM NAT-MIB



Dionne & Blanchet        Expires January 4, 2012                [Page 4]


Internet-Draft    CGN Management Information Base (MIB)        July 2011


      SnmpAdminString
              FROM SNMP-FRAMEWORK-MIB
      InetAddressType,
      InetAddress,
      InetPortNumber
              FROM INET-ADDRESS-MIB;

 cgnMIB MODULE-IDENTITY
      LAST-UPDATED "201107030000Z"
      ORGANIZATION "Viagenie Inc."
      CONTACT-INFO
               "Jean-Philippe Dionne
                Viagenie Inc.
                2875 Boul Laurier, Suite D2-630
                Quebec, Quebec, Canada, G1V 2M2
                Phone: +1-418-656-9254
                Email: jean-philippe.dionne@viagenie.ca"
      DESCRIPTION
              "This MIB module defines an extension of the NAT-MIB
              (RFC4008) for Carrier Grade NAT (CGN)"
      REVISION     "201107030000Z"  -- July 3rd 2011
      DESCRIPTION
              "This MIB module defines an extension of the NAT-MIB
              (RFC4008) for Carrier Grade NAT (CGN)"

      ::= { mib-2 123 }

 cgnMIBObjects OBJECT IDENTIFIER ::= { cgnMIB 1 }

 CgnProtocolType ::= TEXTUAL-CONVENTION
        STATUS       current
        DESCRIPTION
                "Protocol numbers
                 (http://www.iana.org/assignments/protocol-numbers/)"
        SYNTAX   INTEGER

 --
 -- This table extends the natAddrMapTable table.
 --

 cgnSubscrQuotaTable OBJECT-TYPE
     SYNTAX      SEQUENCE OF CgnSubscrQuotaEntry
     MAX-ACCESS  not-accessible
     STATUS      current
     DESCRIPTION
             "This tables represents per subscriber quota."
     ::= { cgnMIBObjects 1 }




Dionne & Blanchet        Expires January 4, 2012                [Page 5]


Internet-Draft    CGN Management Information Base (MIB)        July 2011


 cgnSubscrQuotaEntry OBJECT-TYPE
     SYNTAX      CgnSubscrQuotaEntry
     MAX-ACCESS  not-accessible
     STATUS      current
     DESCRIPTION
             "This entry represents per subscriber quota indexed by
              natAddrMapIndex from natAddrMapTable and protocol number."
     INDEX { cgnUserQuotaMapIndex, cgnUserQuotaProtocol }
     ::= { cgnSubscrQuotaTable 1 }

 CgnSubcrQuotaEntry ::=
     SEQUENCE {
             cgnUserQuotaMapIndex NatAddrMapId,
             cgnUserQuotaProtocol CgnProtocolType,
             cgnUserQuotaPortLimit INTEGER,
             cgnUserQuotaAddrLimit INTEGER,
             cgnUserQuotaPortAllocRate INTEGER
     }

 -- [TBD] define entries elements

 cgnAddrPoolTable OBJECT-TYPE
      SYNTAX      SEQUENCE OF CgnAddrPoolEntry
      MAX-ACCESS  not-accessible
      STATUS      current
      DESCRIPTION
              "This table represents the external address pool usage."
      ::= { cgnMIBObjects 2 }

 cgnAddrPoolEntry OBJECT-TYPE
      SYNTAX      CgnAddrPoolEntry
      MAX-ACCESS  not-accessible
      STATUS      current
      DESCRIPTION
              "This entry represents the external address pool usage
               indexed by natAddrMapIndex from natAddrMapTable and
               protocol number."
      INDEX { cgnAddrPoolMapIndex }

      ::= { cgnAddrPoolTable 1 }

 CgnAddrPoolEntry ::=
      SEQUENCE {
          cgnAddrPoolMapIndex    NatAddrMapId,
          cgnAddrPoolUsage       Gauge32,
          cgnAddrPoolExceeded    Counter64,
          cgnPortPoolExceeded    Counter64
      }



Dionne & Blanchet        Expires January 4, 2012                [Page 6]


Internet-Draft    CGN Management Information Base (MIB)        July 2011


 -- [TBD] define entries elements

 -- CgnSubscrTable

 cgnSubscrTable    OBJECT-TYPE
      SYNTAX      SEQUENCE OF CgnSubscrEntry
      MAX-ACCESS  not-accessible
      STATUS      current
      DESCRIPTION
              "This table represents per subscriber information."
      ::= { cgnMIBObjects 3 }

 cgnSubscrEntry    OBJECT-TYPE
      SYNTAX      CgnSubscrEntry
      MAX-ACCESS  not-accessible
      STATUS      current
      DESCRIPTION
              "This entry represents per subscriber information."
      INDEX { cgnSubscrMapIndex,
              cgnSubscrInetAddrType,
              cgnSubscrInetAddr
            }

      ::= { cgnSubscrTable 1 }

 CgnSubscrEntry ::=
      SEQUENCE {
          cgnSubscrMapIndex          NatAddrMapId,
          cgnSubscrInetAddrType      InetAddrType,
          cgnSubscrInetAddr          InetAddr,
          cgnSubscrEntryAddrUsage    INTEGER,
          cgnSubscrEntryPortUsage    INTEGER,
          cgnSubscrPortQuotaExceeded Counter64,
          cgnSubscrAddrQuotaExceeded Counter64
      }

 --
 -- Notifications
 --

 cgnMIBNotifications OBJECT IDENTIFIER ::= { cgnMIB 0 }

 cgnAddrPoolExhaustion NOTIFICATION-TYPE
     OBJECTS { natAddrMapIndex }
     STATUS  current
     DESCRIPTION
             ""
     ::= { cgnMIBNotifications 1 }



Dionne & Blanchet        Expires January 4, 2012                [Page 7]


Internet-Draft    CGN Management Information Base (MIB)        July 2011


 cgnPortExhaustion NOTIFICATION-TYPE
     OBJECTS { natAddrMapIndex, cgnProtocolType,
               inetAddressType, inetAddress }
     STATUS  current
     DESCRIPTION
             ""
     ::= { cgnMIBNotifications 2 }

 cgnUserQuotaExceeded NOTIFICATION-TYPE
     OBJECTS { natAddrMapIndex, inetAddressType, inetAddress }
     STATUS  current
     DESCRIPTION
             ""
     ::= { cgnMIBNotifications 3 }



6.  Security Considerations

   No additional security consideration than RFC 4008.

7.  IANA Considerations

   TBD

8.  Contributors

9.  References

9.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



Dionne & Blanchet        Expires January 4, 2012                [Page 8]


Internet-Draft    CGN Management Information Base (MIB)        July 2011


                                       J. Schoenwaelder, "Conformance
                                       Statements for SMIv2", STD 58,
                                       RFC 2580, April 1999.

   [RFC4008]                           Rohit, R., Srisuresh, P.,
                                       Raghunarayan, R., Pai, N., and C.
                                       Wang, "Definitions of Managed
                                       Objects for Network Address
                                       Translators (NAT)", RFC 4008,
                                       March 2005.

9.2.  Informative References

   [RFC2223]                           Postel, J. and J. Reynolds,
                                       "Instructions to RFC Authors",
                                       RFC 2223, October 1997.

   [RFC3410]                           Case, J., Mundy, R., Partain, D.,
                                       and B. Stewart, "Introduction and
                                       Applicability Statements for
                                       Internet-Standard Management
                                       Framework", RFC 3410,
                                       December 2002.

   [RFC2629]                           Rose, M., "Writing I-Ds and RFCs
                                       using XML", RFC 2629, June 1999.

   [RFC4181]                           Heard, C., "Guidelines for
                                       Authors and Reviewers of MIB
                                       Documents", BCP 111, RFC 4181,
                                       September 2005.

   [I-D.ietf-behave-lsn-requirements]  Perreault, S., Yamagata, I.,
                                       Miyakawa, S., Nakagawa, A., and
                                       H. Ashida, "Common requirements
                                       for IP address sharing schemes",
                                       draft-ietf-behave-lsn-
                                       requirements-01 (work in
                                       progress), March 2011.

   [I-D.sivakumar-behave-nat-logging]  Sivakumar, S., "Logging of NAT
                                       Events", draft-sivakumar-behave-
                                       nat-logging-01 (work in
                                       progress), May 2011.







Dionne & Blanchet        Expires January 4, 2012                [Page 9]


Internet-Draft    CGN Management Information Base (MIB)        July 2011


Authors' Addresses

   Jean-Philippe Dionne (editor)
   Viagenie
   2875 boul. Laurier, suite D2-630
   Quebec
   Canada

   Phone: +1-418-656-9254
   EMail: jean-philippe.dionne@viagenie.ca


   Marc Blanchet
   Viagenie
   2875 boul. Laurier, suite D2-630
   Quebec, QC  G1V 2M2
   Canada

   EMail: Marc.Blanchet@viagenie.ca
   URI:   http://viagenie.ca































Dionne & Blanchet        Expires January 4, 2012               [Page 10]


Html markup produced by rfcmarkup 1.129c, available from https://tools.ietf.org/tools/rfcmarkup/