[Docs] [txt|pdf] [Tracker] [WG] [Email] [Diff1] [Diff2] [Nits]

Versions: 00 01 02 03 04 05 06 07 08 09 10 11 12 13 14 RFC 5428

   INTERNET-DRAFT                                      Wim De Ketelaere
                                                               tComLabs
   draft-ietf-ipcdn-pktc-eventmess-08.txt              Eugene Nechamkin
                                                         Broadcom Corp.
                                                  Sumanth Channabasappa
                                                           CableLabs(R)
   Expires: March 2007                                   September 2006


                            Management Event MIB
                     for PacketCable/IPCablecom MTAs

Status of this Memo

   By submitting this Internet-Draft, each author represents that any
   applicable patent or other IPR claims of which he or she is aware
   have been or will be disclosed, and any of which he or she becomes
   aware will be disclosed, in accordance with Section 6 of BCP 79.

   Internet-Drafts are working documents of the Internet Engineering
   Task Force (IETF), its areas, and its working groups.  Note that
   other groups may also distribute working documents as Internet-
   Drafts.

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

   The list of current Internet-Drafts can be accessed at
        http://www.ietf.org/ietf/1id-abstracts.html

   The list of Internet-Draft Shadow Directories can be accessed at
        http://www.ietf.org/shadow.html

Abstract

   This memo defines a portion of the Management Information Base (MIB)
   for use with network management protocols in the Internet community.
   In particular, it provides a common data and format representation
   for events generated by PacketCable and IPCablecom compliant
   Multimedia Terminal Adapter devices.










De Ketelaere/Nechamkin/Channabasappa Expires - August 2006    [Page 1]

PacketCable/IPCablecom Event management MTA MIB          February 2006


Table of Contents

  1. The Internet-Standard Management Framework.....................2
  2. Introduction...................................................2
  3. Terminology....................................................3
      3.1 PacketCable...............................................3
      3.2 IPCableCom................................................3
      3.3 MTA.......................................................4
      3.4 Endpoint..................................................4
      3.5 MSO.......................................................4
      3.6 UDP.......................................................4
  4. Overview.......................................................4
      4.1 Structure of the MIB......................................5
         4.1.1 pktcDevEventControl..................................5
         4.1.2 pktcDevEventThrottle.................................5
         4.1.3 pktcDevEventStatus...................................6
         4.1.4 pktcDevEventDescr....................................6
         4.1.5 pktcDevEventLog......................................6
         4.1.6 pktcDevEvNotifications...............................6
  5. Relationship to Other MIB Modules..............................6
      5.1 MIB modules required for IMPORTS..........................6
  6. Definitions....................................................6
  7. Acknowledgments...............................................25
  8. Normative References..........................................26
  9. Informative References........................................27
  10. IANA Considerations..........................................27
  11. Security Considerations......................................27
  Authors' Addresses...............................................29
  Full Copyright Statement.........................................30
  Disclaimer of validity:..........................................30


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

2.
  Introduction



De Ketelaere/Nechamkin/Channabasappa Expires - August 2006    [Page 2]

PacketCable/IPCablecom Event management MTA MIB          February 2006


   A multimedia terminal adapter (MTA) is used to deliver broadband
   Internet, data, and/or voice access jointly with telephony service to
   a subscriber's or customer's premises using a cable network
   infrastructure. A MTA is normally installed at the customer's or
   subscriber's premises, and it is coupled to a multiple system
   operator (MSO) using a hybrid fiber coax (HFC) access network.

   A MTA is provisioned by the MSO for broadband Internet, data, and/or
   voice service. For more information on MTA provisioning refer to
   [PKT-SP-PROV] and [RFCXYZ]. MTA devices include one or more endpoints
   (e.g., telephone ports) which receive call signaling information to
   establish ring cadence, and codecs used for providing telephony
   service.

   For more information on call signaling refer to [PKT-SP-MGCP] and
   [RFC3435].

   For more information on codecs refer to [PKT-SP-CODEC].

   Given the complexity of such systems it is important that a suitable
   event management mechanism be defined to allow for effective
   management. This MIB module provides objects suitable for generation
   and management of events on the MTA.

3.
  Terminology

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

   The terms "MIB module" and "information module" are used
   interchangeably in this memo.  As used here, both terms refer to any
   of the three types of information modules defined in Section 3 of RFC
   2578 [RFC2578]. Some of the terms used in this memo are defined
   below.  Some additional terms are also defined in the PacketCable(TM)
   Management Event Mechanism Specification [PKT-SP-MEM1.5] and the
   PacketCable MTA Device Provisioning Specification [PKT-SP-PROV].

3.1
   PacketCable
   PacketCable is a CableLabs-led initiative that is aimed at developing
   interoperable interface specifications for delivering advanced, real-
   time multimedia services over two-way cable plants.

3.2
   IPCableCom
   IPCableCom is an ITU Telecommunication Standardization Sector (ITU-T)
   project that includes architecture and a series of recommendations
   that enable the delivery of real time services over the cable
   television networks using cable modems.



De Ketelaere/Nechamkin/Channabasappa Expires - August 2006    [Page 3]
PacketCable/IPCablecom Event management MTA MIB          February 2006


3.3
   MTA

   A Multimedia Terminal Adapter (MTA) is a PacketCable or IPCablecom
   compliant device providing telephony services over a cable or hybrid
   system used to deliver video signals to a community. It contains an
   interface to endpoints, a network interface, CODECs, and all
   signaling and encapsulation functions required for Voice over IP
   transport, call signaling, and Quality of Service signaling. A MTA
   can be an embedded or a standalone device. An Embedded MTA (E-MTA) is
   a MTA device containing an embedded Data Over Cable Service Interface
   Specifications (DOCSIS) Cable Modem. A Standalone MTA (S-MTA) is a
   MTA device separated from the DOCSIS Cable Modem by non-DOCSIS MAC
   interface (e.g., Ethernet, USB).

3.4
   Endpoint
   An endpoint or MTA endpoint is a standard RJ-11 telephony physical
   port located on the MTA and used for attaching the telephone device
   to the MTA.


3.5
    MSO
   Multi-System Operator. A cable company that operates many head-end
   locations in several cities.


3.6
   UDP
   User Datagram Protocol. A connectionless protocol built upon Internet
   Protocol (IP), as per RFC 768 [RFC768].


4.
  Overview
   This MIB module provides a set of objects required for generation and
   management of events on PacketCable, European Telecommunications
   Standards Institute (ETSI), and International Telecommunication Union
   Telecommunication Standardization Sector (ITU-T) IPCablecom compliant
   Multimedia Terminal Adapter (MTA) devices. The EVENT MIB module is
   intended to supersede various EVENT MIB modules from which it is
   partly derived:
     - the PacketCable 1.5 Management Event MIB Specification
       [PKT-SP-EVEMIB1.5],
     - the ITU-T IPCablecom management event mechanism MIB requirements
       [ITU-T-J176]

   Several normative and informative references are used to help define
   Management Event MIB objects.  As a convention, wherever the
   requirements are equivalent at the time of the writing, the
   PacketCable reference is used. However, MTA implementations MUST
   refer to the corresponding specifications to ensure compliance.




De Ketelaere/Nechamkin/Channabasappa Expires - August 2006    [Page 4]

PacketCable/IPCablecom Event management MTA MIB          February 2006



4.1
   Structure of the MIB

   This MIB is structured into six subtrees:

   - Management information that controls the event reporting
     (pktcDevEventControl).


   - Management information that configures the event throttling control
     (pktcDevEventThrottle).

   - Management information reflecting the status of the event
     transmission (pktcDevEventStatus).

   - Management information that specifies the possible events that can
     be generated by the MTA (pktcDevEventDescr).

   - Management information related to the events generated by the MTA
     (pktcDevEventLog).

   - Management information that defines the trap and inform messages
     (pktcDevEvNotifications).


4.1.1 pktcDevEventControl

   The objects in this group contain information related to the
   destination Syslog Server and actions related to the event tables.

   pkctDevEvControl - this object defines the actions related to the
   event tables.

   pkctDevEvSyslogAddressType - this object defines the address type of
   the Syslog Server.

   pktcDevEvSyslogAddress - this object specifies the address of the
   Syslog server.

   pkctDevEvSyslogUdpPort - this object specifies the UDP-port to which
   the Syslog messages need to be send.


4.1.2 pktcDevEventThrottle
   The objects in this group control the throttling of the reported
   events.





De Ketelaere/Nechamkin/Channabasappa Expires - August 2006    [Page 5]

PacketCable/IPCablecom Event management MTA MIB          February 2006


4.1.3 pktcDevEventStatus
   The objects in this group relate to the status of the event
   transmissions.

4.1.4 pktcDevEventDescr
   The objects in this group contain the description of the possible
   events that can be generated.

4.1.5 pktcDevEventLog
   The objects in this group contain the management information related
   to the events that can be generated by the MTA.

4.1.6 pktcDevEvNotifications
   The objects in this group define the structure for the SNMP trap and
   SNMP Inform notifications.

5.
  Relationship to Other MIB Modules
   Some management objects defined in other MIB modules are applicable
   to an entity implementing this MIB.  In particular, it is assumed
   that an entity implementing the PKTC-IETF-EVENT-MIB module will also
   implement the 'interfaces' group of the IF-MIB [RFC2863].

5.1
   MIB modules required for IMPORTS
   The PKTC-IETF-EVENT-MIB MIB module IMPORTS objects from SNMPv2-SMI
   [RFC2578], SNMPv2-TC [RFC2579], SNMP-FRAMEWORK-MIB [RFC3411], SNMPv2-
   CONF [RFC2580], IF-MIB [RFC2863] and the INET-ADDRESS-MIB [RFC4001].
6.
  Definitions

   PKTC-IETF-EVENT-MIB DEFINITIONS ::= BEGIN

   IMPORTS
       MODULE-IDENTITY,
       OBJECT-TYPE,
       Unsigned32,
       NOTIFICATION-TYPE,
       mib-2                            FROM SNMPv2-SMI
       TEXTUAL-CONVENTION,
       TruthValue,
       DateAndTime                      FROM SNMPv2-TC
       SnmpAdminString                  FROM SNMP-FRAMEWORK-MIB
       OBJECT-GROUP,
       MODULE-COMPLIANCE,
       NOTIFICATION-GROUP               FROM SNMPv2-CONF
       ifPhysAddress                    FROM IF-MIB
       InetAddressType,
       InetAddress,
       InetPortNumber                   FROM INET-ADDRESS-MIB ;

   pktcIetfEventMib MODULE-IDENTITY


De Ketelaere/Nechamkin/Channabasappa Expires - August 2006    [Page 6]

PacketCable/IPCablecom Event management MTA MIB          February 2006


       LAST-UPDATED "200609150000Z" -- September 15, 2006
       ORGANIZATION "IETF IP over Cable Data Network Working Group"
       CONTACT-INFO
               "Sumanth Channabasappa
                Cable Television Laboratories, Inc.
                858 Coal Creek Circle,
                Louisville, CO 80027, USA
                +1 303-661-3307
                Sumanth@cablelabs.com

                Wim De Ketelaere
                tComLabs
                Gildestraat 8
                9000 Gent, Belgium
                +32 9 269 22 90
                deketelaere@tComLabs.com

                Eugene Nechamkin
                Broadcom Corporation
                200 - 13711 International Place
                Richmond, BC, V6V 2Z8, Canada
                +1 604 233 8500
                enechamkin@broadcom.com

       IETF IPCDN Working Group
            General Discussion: ipcdn@ietf.org
            Subscribe: http://www.ietf.org/mailman/listinfo/ipcdn
            Archive: ftp://ftp.ietf.org/ietf-mail-archive/ipcdn
            Co-Chair: Jean-Francois Mule, jf.mule@cablelabs.com
            Co-Chair: Richard Woundy, Richard_Woundy@cable.comcast.com"

       DESCRIPTION
           " This MIB module supplies the basic management objects
            for the reporting events generated by the Multimedia
            Terminal Adapter devices compliant with the PacketCable
            and IPCablecom requirements.


              Copyright (C) The Internet Society (2006). This version of
              this MIB module is part of RFC nnnn; see the RFC itself
              for full legal notices."
   -- RFC Ed: replace nnnn with actual RFC number and remove this note.

       REVISION                "200609150000Z" -- September 15, 2006

       DESCRIPTION
          "Initial version, published as RFC yyyy."
   -- RFC Ed: replace yyyy with actual RFC number and remove this note



De Ketelaere/Nechamkin/Channabasappa Expires - August 2006    [Page 7]

PacketCable/IPCablecom Event management MTA MIB          February 2006


   ::=  { mib-2 XXX }
   -- RFC Ed: replace XXX with IANA-assigned number and remove this
   -- note
   --
   -- Textual Conventions
   --

   PktcDevSeverityLevel ::= TEXTUAL-CONVENTION
       STATUS       current
       DESCRIPTION
           "This textual convention represents the severity
           levels for the various events reported by the MTA.
           The levels are as described below:
               emergency(0) - A condition that makes the system
                              unusable.
               alert(1)     - A service-affecting condition for which
                              immediate action must be taken.
               critical(2)  - A service-affecting critical condition.
               error(3)     - An error condition.
               warning(4)   - A warning condition.
               notice(5)    - A normal but significant condition.
               info(6)      - An informational message.
               debug(7)     - A debug message."
       SYNTAX      BITS {
                   emergency(0),
                   alert(1),
                   critical(2),
                   error(3),
                   warning(4),
                   notice(5),
                   info(6),
                   debug(7)
                   }

   --
   --
   pktcDevEvNotifications OBJECT IDENTIFIER ::= { pktcIetfEventMib 0 }
   pktcDevEvMibObjects    OBJECT IDENTIFIER ::= { pktcIetfEventMib 1 }
   pktcDevEvConformance   OBJECT IDENTIFIER ::= { pktcIetfEventMib 2 }
      --
      --
   pktcDevEventControl   OBJECT IDENTIFIER ::= { pktcDevEvMibObjects 1 }
   pktcDevEventThrottle  OBJECT IDENTIFIER ::= { pktcDevEvMibObjects 2 }
   pktcDevEventStatus    OBJECT IDENTIFIER ::= { pktcDevEvMibObjects 3 }
   pktcDevEventDescr     OBJECT IDENTIFIER ::= { pktcDevEvMibObjects 4 }
   pktcDevEventLog       OBJECT IDENTIFIER ::= { pktcDevEvMibObjects 5 }


      ---


De Ketelaere/Nechamkin/Channabasappa Expires - August 2006    [Page 8]

PacketCable/IPCablecom Event management MTA MIB          February 2006


      ---   Event Reporting control objects
      ---
   pktcDevEvControl  OBJECT-TYPE
       SYNTAX  BITS {
                   resetEventLogTable(0),
                   resetEventDescrTable(1)
                   }
       MAX-ACCESS  read-write
       STATUS      current
       DESCRIPTION
               "This MIB object defines the actions related to the event
               log configuration.

               The MTA MUST take the appropriate action whenever
               a bit is set to a value of '1'.

               Setting the resetEventLogTable(0) bit to
               a value of '1'
               - deletes all entries in pktcDevEventLogTable,
               - resets the value of pktcDevEvLogIndex to '0'

               Setting resetEventDescrTable(1) to a value of '1'
               - resets the pktcDevEventDescrTable to the
               factory default values.

               Setting a control bit to a value of '0' MUST not
               result in any action.

               Reading this MIB object MUST always return '00'.
               MTA MUST perform the same actions regardless of
               persistentance (i.e. storage in non-volatile memory)."
       ::= { pktcDevEventControl 1 }

   pktcDevEvSyslogAddressType  OBJECT-TYPE
       SYNTAX      InetAddressType
       MAX-ACCESS  read-write
       STATUS      current
       DESCRIPTION
               "This MIB Object defines the Internet address type of the
               Syslog server.
               MTAs implementing this MIB module MUST support an
               InetAddressType of ipv4(1).
               MTAs MAY optionally support other address types. "
       REFERENCE
               "PacketCable MTA Device Provisioning Specification,
               [PKT-SP-PROV]."
       DEFVAL { ipv4 }

       ::= { pktcDevEventControl 2 }


De Ketelaere/Nechamkin/Channabasappa Expires - August 2006    [Page 9]

PacketCable/IPCablecom Event management MTA MIB          February 2006



   pktcDevEvSyslogAddress  OBJECT-TYPE
       SYNTAX      InetAddress
       MAX-ACCESS  read-write
       STATUS      current
       DESCRIPTION
               "This MIB Object contains the IP address of the
               Syslog server. If this is set to either 0.0.0.0 or
               255.255.255.255 the device MUST inhibit syslog
               transmission.
               The use of FQDNs is syntactically allowed, but
               discouraged since a failure to resolve them in a
               timely manner may leave the device without access to
               the Syslog daemon during critical network events.
               The type of address this object represents is defined
               by the MIB Object pktDevEvSyslogAddressType."
       REFERENCE
               "PacketCable MTA Device Provisioning Specification,
               [PKT-SP-PROV];
               PacketCable Management Event Mechanism Specification,
               [PKT-SP-MEM1.5];
               RFC 3164, The BSD syslog Protocol, [RFC3164]."
       ::= { pktcDevEventControl 3 }

   pktcDevEvSyslogUdpPort  OBJECT-TYPE
       SYNTAX      InetPortNumber
       MAX-ACCESS  read-write
       STATUS      current
       DESCRIPTION
               "This MIB Object contains the UDP Port Number of the
                Syslog Server. The MTA must send the
                Syslog messages to this port on the Syslog Server."
       REFERENCE
               "RFC 3164, The BSD syslog Protocol, [RFC3164]."
       DEFVAL { 514 }
       ::= { pktcDevEventControl 4 }


   pktcDevEventClassReportTable OBJECT-TYPE
       SYNTAX      SEQUENCE OF PktcDevEventClassReportEntry
       MAX-ACCESS  not-accessible
       STATUS      current
       DESCRIPTION
               "This MIB table contains all the event classes
                and the reporting status information."
       ::= { pktcDevEventControl 5 }

   pktcDevEventClassReportEntry OBJECT-TYPE
       SYNTAX      PktcDevEventClassReportEntry


De Ketelaere/Nechamkin/Channabasappa Expires - August 2006   [Page 10]

PacketCable/IPCablecom Event management MTA MIB          February 2006


       MAX-ACCESS  not-accessible
       STATUS      current
       DESCRIPTION
               "An entry in this table MUST be created for each
                event class defined by a vendor for the events
                described as part of 'pktcDevEventDescrTable'.
                If an MTA vendor does not define event classes,
                then MTA MUST create one entry for the event class
   'generic'."
       INDEX { pktcDevEventClass }
       ::= { pktcDevEventClassReportTable 1 }

   PktcDevEventClassReportEntry::= SEQUENCE {
       pktcDevEventClass                SnmpAdminString,
       pktcDevEventReportStatus         TruthValue,
       pktcDevEventClassSeverityLevel   PktcDevSeverityLevel
       }


   pktcDevEventClass OBJECT-TYPE
       SYNTAX      SnmpAdminString (SIZE (1..100))
       MAX-ACCESS  not-accessible
       STATUS      current
       DESCRIPTION
           "This MIB Object contains the identifier
            of an event class supported by the device.
            Vendors MAY define different event classes
            (e.g. DHCP, SNMP, DEBUG) to group together
            related events.
            It is to be noted that the absence of vendor
            defined event classes still calls for an event
            class termed 'generic' ( refer
            'pktcDevEventClassReportEntry')"
       ::= { pktcDevEventClassReportEntry 1 }

   pktcDevEventReportStatus OBJECT-TYPE
       SYNTAX      TruthValue
       MAX-ACCESS  read-write
       STATUS      current
       DESCRIPTION
           "This MIB Object indicates if events belonging
            to a particular event class are to be enabled
            or disabled for reporting.

            Setting this object to a value of 'true' enables
            reporting as per the MIB Object
            'pktcDevEventDescrReporting'.

            Setting this object to a value of 'false' disables


De Ketelaere/Nechamkin/Channabasappa Expires - August 2006   [Page 11]

PacketCable/IPCablecom Event management MTA MIB          February 2006


            any reporting, irrespective of the value of the
            MIB Object 'pktcDevEventDescrReporting'.

            The default value of this MIB Object is vendor
            specific. However, the vendor SHOULD enable all
            event categories defined by PacketCable or
            IPCableCom, by default."
       ::= { pktcDevEventClassReportEntry 2 }

   pktcDevEventClassSeverityLevel OBJECT-TYPE
       SYNTAX      PktcDevSeverityLevel
       MAX-ACCESS  read-write
       STATUS      current
       DESCRIPTION
               "This MIB Object defines the reporting levels
                of events for the corresponding event class,
                that need to be included for reporting.

                This MIB Object has no effect on the event
                generation unless the MIB Object
                'pktcDevEventReportStatus' is set to a value
                of 'true', for the corresponding event class.

                Setting a bit to a value of '1' implies that
                events corresponding to that level MUST be
                reported as defined by the corresponding
                value of 'pktcDevEventDescrReporting'.

                Setting a bit to a value of '0' implies that
                events corresponding to that level MUST NOT be
                reported, irrespective of the corresponding
                value of 'pktcDevEventDescrReporting'.

                It is recommended that the bits corresponding
                to emergency(0), alert(1), critical(2) and error(3)
                always be set to a value of '1'. "
       REFERENCE
               "RFC 3164, The BSD syslog Protocol, [RFC3164]."
       ::= { pktcDevEventClassReportEntry 3 }
   --
   --   Event throttling control
   --

   pktcDevEvThrottleAdminStatus  OBJECT-TYPE
       SYNTAX      INTEGER {
                   unconstrained(1),
                   maintainBelowThreshold(2),
                   stopAtThreshold(3),
                   inhibited(4)


De Ketelaere/Nechamkin/Channabasappa Expires - August 2006   [Page 12]

PacketCable/IPCablecom Event management MTA MIB          February 2006


                   }
       MAX-ACCESS  read-write
       STATUS      current
       DESCRIPTION

               "This MIB Object controls the throttling of of the
               transmitted messages upon generation of an event
               (SNMP/Syslog).

               A value of unconstrained(1) causes event messages
               to be transmitted without regard to the threshold
               settings.

               A value of maintainBelowThreshold(2) causes event
               messages to be suppressed if the number of transmissions
               would otherwise exceed the threshold.
               A value of stopAtThreshold(3) causes event message
               transmission to cease at the threshold, and not
               resume until directed to do so.

               A value of inhibited(4) causes all event message
               Transmission to be suppressed.

               An event causing both an SNMP and a Syslog message
               is still treated as a single event.

               Writing to this object resets the thresholding state.

               Refer to MIB Objects pktcDevEvThrottleThreshold and
               pktcDevEvThrottleInterval for information on throttling."
       DEFVAL { unconstrained }
       ::= { pktcDevEventThrottle 1 }


   pktcDevEvThrottleThreshold  OBJECT-TYPE
       SYNTAX      Unsigned32
       MAX-ACCESS  read-write
       STATUS      current
       DESCRIPTION
               "This MIB Object contains the number of events per
               pktcDevEvThrottleInterval to be transmitted before
               throttling.

               An event causing both an SNMP and a Syslog message is
               still treated as a single event."
       DEFVAL { 2 }
       ::= { pktcDevEventThrottle 2 }

   pktcDevEvThrottleInterval  OBJECT-TYPE


De Ketelaere/Nechamkin/Channabasappa Expires - August 2006   [Page 13]

PacketCable/IPCablecom Event management MTA MIB          February 2006


       SYNTAX      Unsigned32
       UNITS       "seconds"
       MAX-ACCESS  read-write
       STATUS      current
       DESCRIPTION

               "This MIB Object contains the interval over which
                the throttle threshold applies."
       DEFVAL { 1 }
       ::= { pktcDevEventThrottle 3 }


   ---
   -- Status Reporting
   ---

   pktcDevEvTransmissionStatus OBJECT-TYPE
       SYNTAX      BITS {
                   syslogThrottled(0),
                   snmpThrottled(1),
                   validSyslogServerAbsent(2),
                   validSnmpManagerAbsent(3),
                   syslogTransmitError(4),
                   snmpTransmitError(5)
                   }
       MAX-ACCESS  read-only
       STATUS      current
       DESCRIPTION
               "This MIB Object reflects the status of the event
                transmission.

               If a bit corresponding to a state is set to a value
               of:
                   '1', it indicates that the state is true
                   '0', it indicates that the state is false

               'Event throttling' is based on thresholds and the current
               setting of pktcDevEvThrottleAdminStatus.

               'Server/Manager' indicators must be based on the
               availability of valid Syslog server/SNMP managers.

               'Transmit Errors' must only be used in cases where the
               MTA can identify unavailable servers."


       ::= { pktcDevEventStatus 1 }




De Ketelaere/Nechamkin/Channabasappa Expires - August 2006   [Page 14]

PacketCable/IPCablecom Event management MTA MIB          February 2006


   ---
   -- Event Descriptions
   ---

   pktcDevEventDescrTable OBJECT-TYPE
       SYNTAX      SEQUENCE OF PktcDevEventDescrEntry
       MAX-ACCESS  not-accessible
       STATUS      current
       DESCRIPTION
               "This MIB table contains all possible events
               that can be generated by the device. This includes
               both PacketCable/IPCableCom defined and
               vendor-specific events."
       ::= { pktcDevEventDescr 1 }

   pktcDevEventDescrEntry OBJECT-TYPE
       SYNTAX      PktcDevEventDescrEntry
       MAX-ACCESS  not-accessible
       STATUS      current
       DESCRIPTION
               "An entry in this table is created for each
               event the MTA implementing this MIB is
               capable of reporting."
       INDEX { pktcDevEventDescrId, pktcDevEventDescrEnterprise }
       ::= { pktcDevEventDescrTable 1 }

   PktcDevEventDescrEntry::= SEQUENCE {
       pktcDevEventDescrId              Unsigned32,
       pktcDevEventDescrEnterprise      Unsigned32,
       pktcDevEventDescrFacility        INTEGER,
       pktcDevEventDescrSeverityLevel   PktcDevSeverityLevel,
       pktcDevEventDescrReporting       BITS,
       pktcDevEventDescrText            SnmpAdminString,
       pktcDevEventDescrClass           SnmpAdminString
       }

   pktcDevEventDescrId OBJECT-TYPE
       SYNTAX      Unsigned32(1..4294967295)
       MAX-ACCESS  not-accessible
       STATUS      current
       DESCRIPTION
               "This MIB Object contains the event identifier for the
               specific event to which the priority and display
               strings belong.
               The event identifier can either be PacketCable/IPCableCom
               defined or vendor-specific."
       REFERENCE
               "PacketCable Management Event Mechanism Specification,
               [PKT-SP-MEM1.5];


De Ketelaere/Nechamkin/Channabasappa Expires - August 2006   [Page 15]

PacketCable/IPCablecom Event management MTA MIB          February 2006


               PacketCable MTA Device Provisioning Specification,
               [PKT-SP-PROV]."
       ::= { pktcDevEventDescrEntry 1 }

   pktcDevEventDescrEnterprise OBJECT-TYPE
       SYNTAX      Unsigned32
       MAX-ACCESS  not-accessible
       STATUS      current
       DESCRIPTION
               "This MIB Object provides the IANA enterprise number of
               the Organization defining the event. Thus, all
               PacketCable or IPCableCom defined events will contain the
               PacketCable or IPCableCom IANA enterprise number and for
               vendor-specific events it will contain the IANA
               enterprise number of the defining organization."
       ::= { pktcDevEventDescrEntry 2 }


   pktcDevEventDescrFacility OBJECT-TYPE
       SYNTAX      INTEGER {
                   kernel(0),
                   user(1),
                   mail(2),
                   daemon(3),
                   auth(4),
                   syslog(5),
                   lpr(6),
                   news(7),
                   uucp(8),
                   cron(9),
                   authPriv(10),
                   ftp(11),
                   ntp(12),
                   security(13),
                   console(14),
                   clockDaemon(15),
                   local0(16),
                   local1(17),
                   local2(18),
                   local3(19),
                   local4(20),
                   local5(21),
                   local6(22),
                   local7(23)
                   }
       MAX-ACCESS  read-only
       STATUS      current
       DESCRIPTION
               "This MIB Object contains the facility


De Ketelaere/Nechamkin/Channabasappa Expires - August 2006   [Page 16]

PacketCable/IPCablecom Event management MTA MIB          February 2006


               for the event.
               For PacketCable/IPCableCom events this MUST
               be set to local0(16)."
       REFERENCE
               "RFC 3164, The BSD syslog Protocol, [RFC3164]."
       ::= { pktcDevEventDescrEntry 3 }

   pktcDevEventDescrSeverityLevel OBJECT-TYPE
       SYNTAX      PktcDevSeverityLevel
       MAX-ACCESS  read-write
       STATUS      current
       DESCRIPTION
               "This MIB Object contains the severity level that
               is applicable to the corresponding event."
       REFERENCE
               "RFC 3164, The BSD syslog Protocol, [RFC3164]."
       ::= { pktcDevEventDescrEntry 4 }

   pktcDevEventDescrReporting OBJECT-TYPE
       SYNTAX      BITS {
                   local(0),
                   syslog(1),
                   snmpTrap(2),
                   snmpInform(3)
                   }
       MAX-ACCESS  read-write
       STATUS      current
       DESCRIPTION
               "This MIB Object defines the action to be taken on
               occurrence of this event. Bit local(0) refers to local
               logging of events, bit sylog(1) refers to the
               transmission of events using Syslog, bit snmpTrap(2)
               refers to the transmission of events using SNMP Trap
               and bit snmpInform(3)refers to the transmission of events
               using SNMP INFORMs.

               Setting a bit to a value of '1' indicates that the
               corresponding action will be taken upon occurrence of
               this event, provided the required parameters are present.
               (e.g.: Syslog Server for Syslog messages, SNMP targets
               for SNMP traps and SNMP INFORMs etc). If none of the bits
               are set then no action is taken upon occurrence of the
               event.

               The default value of this MIB OBject is dependent on the
               value of the MIB Object 'pktcDevEventDescrSeverityLevel',
               for the corresponding event.




De Ketelaere/Nechamkin/Channabasappa Expires - August 2006   [Page 17]

PacketCable/IPCablecom Event management MTA MIB          February 2006


               For the following values of
   'pktcDevEventDescrSeverityLevel':
                  emergency(0), alert(1), critical(2) and error(3),
               the MTA MUST set the bits for local(0), syslog(1)
               and snmpInform(3) to a value of '1' and the
               rest to a value of '0'.

               For all the remaining values of
   'pktcDevEventDescrSeverityLevel',
               the MTA MUST set the bits for local(0) and syslog(1)
               to a value of '1' and the rest to a value of '0'."
       ::= { pktcDevEventDescrEntry 5 }

   pktcDevEventDescrText OBJECT-TYPE
       SYNTAX      SnmpAdminString(SIZE (0..127))
       MAX-ACCESS  read-write
       STATUS      current
       DESCRIPTION
               "This MIB Object provides a
               human-readable description of the
               event."
       ::= { pktcDevEventDescrEntry 6 }

   pktcDevEventDescrClass OBJECT-TYPE
       SYNTAX      SnmpAdminString(SIZE (1..100))
       MAX-ACCESS  read-only
       STATUS      current
       DESCRIPTION
               "This MIB Object represents an event class
                associated with the corresponding event.

                Vendors MAY choose to define different event
                classes (e.g. DHCP, SNMP, DEBUG) to
                group together related events. Vendors SHOULD
                use standard protocol acronyms for well known
                protocols. However, separating packetcable
                defined from vendor-specific events for the
                same protocol is recommended (e.g DHCP and
                V-DHCP for the DHCP protocol).

                If vendors choose not to define event classes,
                then the value of this MIB Object MUST be set
                to 'generic'."

       ::= { pktcDevEventDescrEntry 7 }

   ---
   -- Events generated
   ---


De Ketelaere/Nechamkin/Channabasappa Expires - August 2006   [Page 18]

PacketCable/IPCablecom Event management MTA MIB          February 2006


   pktcDevEventLogTable OBJECT-TYPE
       SYNTAX      SEQUENCE OF PktcDevEventLogEntry
       MAX-ACCESS  not-accessible
       STATUS      current
       DESCRIPTION
               "This MIB table contains a log of the events
               generated by the MTA.
               A description of all the events that can be
               generated by the device can be obtained from the
               MIB table 'pktcDevEventDescrTable'.
               The contents of this table MAY persist in non-volatile
               memory."
       ::= { pktcDevEventLog 1 }

   pktcDevEventLogEntry OBJECT-TYPE
       SYNTAX      PktcDevEventLogEntry
       MAX-ACCESS  not-accessible
       STATUS      current
       DESCRIPTION
               "Each entry in this table describes an event that
               has occurred, indexed in the chronological order of
               generation. The details of the event are borrowed
               from the parameters associated with the corresponding
               event entry in 'pktcDevEventDescrTable', at the
               time of the event generation.
               While all entries created as such can be cleared using
               the MIB Object pktcDevEvControl, the Event entries
               themselves cannot be individually deleted."

       INDEX { pktcDevEvLogIndex }
       ::= { pktcDevEventLogTable 1 }

   PktcDevEventLogEntry ::= SEQUENCE {
       pktcDevEvLogIndex             Unsigned32,
       pktcDevEvLogTime              DateAndTime,
       pktcDevEvLogEnterprise        Unsigned32,
       pktcDevEvLogId                Unsigned32,
       pktcDevEvLogText              SnmpAdminString,
       pktcDevEvLogEndpointName      SnmpAdminString,
       pktcDevEvLogType              BITS,
       pktcDevEvLogTargetInfo        SnmpAdminString,
       pktcDevEvLogCorrelationId     Unsigned32,
       pktcDevEvLogAdditionalInfo    SnmpAdminString
       }

   pktcDevEvLogIndex OBJECT-TYPE
       SYNTAX      Unsigned32(1..2147483648)
       MAX-ACCESS  not-accessible
       STATUS      current


De Ketelaere/Nechamkin/Channabasappa Expires - August 2006   [Page 19]

PacketCable/IPCablecom Event management MTA MIB          February 2006


       DESCRIPTION
               "This MIB Object provides relative ordering of the
               objects in the event log.
                This object will always increase except when
               (a) the log is reset via pktcDevEvControl,
               (b) the device reboots and does not implement
                   non-volatile storage for this log,
               (c) it reaches the value 2^31.
               The next entry for all the above cases is 1.
               This also serves as an indicator of event sequence."
       ::= { pktcDevEventLogEntry 1 }


   pktcDevEvLogTime OBJECT-TYPE
       SYNTAX       DateAndTime
       MAX-ACCESS   read-only
       STATUS       current
       DESCRIPTION
               "This MIB Object provides a human-readable description
               of the time at which the event occurred. The actual time
               used SHOULD be defined by the architecture using this
               MIB definition. If unspecified, this MUST be the local
               time."
       REFERENCE
               "RFC 3164, The BSD syslog Protocol, [RFC3164]."
       ::= { pktcDevEventLogEntry 2 }


   pktcDevEvLogEnterprise OBJECT-TYPE
       SYNTAX      Unsigned32(1.. 2147483648)
       MAX-ACCESS  read-only
       STATUS      current
       DESCRIPTION
               "This MIB Object provides the IANA enterprise number of
               the Organization defining the event. Thus, all
               PacketCable or IPCableCom defined events will contain
               the CableLabs or IPCableCom IANA enterprise number and
               for vendor-specific events it will contain the IANA
               enterprise number of the defining organization."

       ::= { pktcDevEventLogEntry 3 }

   pktcDevEvLogId OBJECT-TYPE
       SYNTAX      Unsigned32
       MAX-ACCESS  read-only
       STATUS      current
       DESCRIPTION
               "This MIB Object contains the event identifier for the
               specific event to which the priority and


De Ketelaere/Nechamkin/Channabasappa Expires - August 2006   [Page 20]

PacketCable/IPCablecom Event management MTA MIB          February 2006


               display strings belong.
               The event identifier can either be PacketCable defined
               or vendor-specific."
       ::= { pktcDevEventLogEntry 4 }

   pktcDevEvLogText OBJECT-TYPE
       SYNTAX      SnmpAdminString
       MAX-ACCESS  read-only
       STATUS      current
       DESCRIPTION
               "This MIB Object contains the contents of
               pktcDevEventDescrText, corresponding to the event, at
               the moment of generation."
       ::= { pktcDevEventLogEntry 5 }


   pktcDevEvLogEndpointName OBJECT-TYPE
       SYNTAX      SnmpAdminString
       MAX-ACCESS  read-only
       STATUS      current
       DESCRIPTION
               "This MIB Object provides the endpoint identifier
                followed by the PacketCable MTA's Fully Qualified
                Domain Name (FQDN) and the IP Address (IP)
                of the PacketCable MTA device.

                This will be denoted as follows:
                aaln/n:<FQDN>/<IP>, where 'n' is the Endpoint number.
                 or
                <FQDN>/<IP> if it is not specific to an endpoint."
       ::= { pktcDevEventLogEntry 6 }

   pktcDevEvLogType OBJECT-TYPE
       SYNTAX      BITS {
                   local(0),
                   syslog (1),
                   trap (2),
                   inform (3)
                   }
       MAX-ACCESS  read-only
       STATUS      current
       DESCRIPTION
               "This MIB Object contains the kind of actions taken by
                the MTA when the event under consideration occurred.

                A bit with a value of 1 indicates the corresponding
                action was taken. Setting it to a value of 0 indicates
                that the corresponding action was not taken.



De Ketelaere/Nechamkin/Channabasappa Expires - August 2006   [Page 21]

PacketCable/IPCablecom Event management MTA MIB          February 2006


                An event may trigger one or more actions (e.g.: Syslog
                and SNMP) or may remain as a local event since
                transmissions could be disabled or inhibited as defined
                by the Throttle MIB Objects."

       ::= { pktcDevEventLogEntry 7 }

   pktcDevEvLogTargetInfo OBJECT-TYPE
       SYNTAX      SnmpAdminString
       MAX-ACCESS  read-only
       STATUS      current
       DESCRIPTION
               "This MIB Object contains a comma separated list of the
               actions taken for external notifications, along with the
               target IP address for the generated events. Locally
               stored events must not be recorded in this MIB Object.

               The syntax is as:
               <action-1/IP:port>,<action-2/IP:port>,<action-3/IP:port>

               Where <action-n/IP> is to be denoted as follows:
                 For Syslog events:
                         syslog/<IP address of the Syslog Server:port>
                 For SNMP traps:
                         snmpTrap/<IP address of the SNMP Server:port>
                 For SNMP INFORMS:
                         snmpInform/<IP address of the SNMP Server:port>

                If there are multiple targets for the same type (SNMP
                Traps sent to multiple IP addresses) or if there are
                multiple messages sent to the same IP (Syslog and SNMP
                sent to the same IP address) they need to be reported
                individually."
       ::= { pktcDevEventLogEntry 8 }

   pktcDevEvLogCorrelationId OBJECT-TYPE
       SYNTAX      Unsigned32
       MAX-ACCESS  read-only
       STATUS      current
       DESCRIPTION
               "This MIB Object contains the correlation ID
               generated by the MTA during the initiation of the
               last provisioning flow, within or following which
               the event occurred.

               Although a Correlation-ID, once generated after MTA
               reset, does not change until next MTA reset, the
               value of this object will differ for the events
               preserved across MTA resets in case of a persistent


De Ketelaere/Nechamkin/Channabasappa Expires - August 2006   [Page 22]

PacketCable/IPCablecom Event management MTA MIB          February 2006


               pktcDevEventLogTable.

               For more information on the generation of correlation
               ids, refer to the corresponding PacketCable/IPCableCom
               Device Provisioning specifications."
       REFERENCE
               "PacketCable MTA Device Provisioning Specification,
               [PKT-SP-PROV]."
       ::= { pktcDevEventLogEntry 9 }

   pktcDevEvLogAdditionalInfo OBJECT-TYPE
       SYNTAX      SnmpAdminString
       MAX-ACCESS  read-only
       STATUS      current
       DESCRIPTION
               "This MIB Object contains additional, useful
               information in relation to the corresponding event that a
               MTA might wish to report (for example: parameterized
               data or debugging information). The format is
               vendor-specific.
                If MTA cannot provide any additional
               information for the particular event generated, it MUST
               populate this MIB Object with a string of zero-length."
       ::= { pktcDevEventLogEntry 10 }

   ---
   -- Notifications
   ---

   pktcDevEvNotificationIndex  OBJECT IDENTIFIER ::=
                                              { pktcDevEvNotifications 0
   }

   pktcDevEvInform NOTIFICATION-TYPE
       OBJECTS { pktcDevEvLogTime,
       pktcDevEvLogEnterprise,pktcDevEvLogId,
       pktcDevEvLogEndpointName,pktcDevEvLogCorrelationId,ifPhysAddress}
       STATUS      current
       DESCRIPTION
               "This Notification MIB Objects contains the Inform
                contents for event reporting.

                It contains the event log time, the enterprise
                number of the organization defining the event, the
                event identifier, the endpoint identifier, the
                correlation id and the MTA MAC address (obtained in the
                MTA ifTable in the ifPhysAddress object that corresponds
                to the ifIndex 1) and a correlation ID."
       ::= { pktcDevEvNotificationIndex 1 }


De Ketelaere/Nechamkin/Channabasappa Expires - August 2006   [Page 23]

PacketCable/IPCablecom Event management MTA MIB          February 2006



   pktcDevEvTrap NOTIFICATION-TYPE
       OBJECTS { pktcDevEvLogTime,
       pktcDevEvLogEnterprise,pktcDevEvLogId,
       pktcDevEvLogEndpointName,pktcDevEvLogCorrelationId,ifPhysAddress}
       STATUS      current
       DESCRIPTION
               "This Notification MIB Objects contains the Trap contents
                for event reporting.

                It contains the event log time, the enterprise
                number of the organization defining the event, the
                event identifier, the endpoint identifier, the
                correlation id and the MTA MAC address (obtained in the
                MTA ifTable in the ifPhysAddress object that corresponds
                to the ifIndex 1) and a correlation ID."
       ::= { pktcDevEvNotificationIndex 2 }

   ---
   -- Conformance/Compliance
   ---

   pktcEventCompliances  OBJECT IDENTIFIER ::=
                                         { pktcDevEvConformance  1 }
   pktcEventGroups       OBJECT IDENTIFIER ::=
                                         { pktcDevEvConformance  2 }


   pktcEventBasicCompliance MODULE-COMPLIANCE
       STATUS      current
       DESCRIPTION
               "The compliance statement for devices that implement
               Event reporting feature."
       MODULE   --pktcEventMib


   MANDATORY-GROUPS {
                    pktcEventGroup,
                    pktcEventNotificationGroup
                    }
      -- units of conformance
       ::= { pktcEventCompliances 3 }

   pktcEventGroup OBJECT-GROUP
       OBJECTS {
               pktcDevEvControl,
               pktcDevEvSyslogAddressType,
               pktcDevEvSyslogAddress,
               pktcDevEvSyslogUdpPort,


De Ketelaere/Nechamkin/Channabasappa Expires - August 2006   [Page 24]

PacketCable/IPCablecom Event management MTA MIB          February 2006


               pktcDevEvThrottleAdminStatus,
               pktcDevEvThrottleThreshold,
               pktcDevEvThrottleInterval,
               pktcDevEvTransmissionStatus,
               pktcDevEventDescrFacility,
               pktcDevEventDescrSeverityLevel,
               pktcDevEventDescrReporting,
               pktcDevEventDescrText,
               pktcDevEvLogTime,
               pktcDevEvLogEnterprise,
               pktcDevEvLogId,
               pktcDevEvLogText,
               pktcDevEvLogEndpointName,
               pktcDevEvLogType,
               pktcDevEvLogTargetInfo,
               pktcDevEvLogCorrelationId,
               pktcDevEvLogAdditionalInfo,
               pktcDevEventDescrClass,
               pktcDevEventReportStatus,
               pktcDevEventClassSeverityLevel
               }

       STATUS      current
       DESCRIPTION
               "Group of MIB objects for PacketCable Management Event
               MIB."
       ::= { pktcEventGroups 1 }


   pktcEventNotificationGroup NOTIFICATION-GROUP
       NOTIFICATIONS { pktcDevEvInform, pktcDevEvTrap }
       STATUS      current
       DESCRIPTION
               "Group of MIB objects for notifications related to
               change in status of the MTA Device."
       ::= { pktcEventGroups 2 }
   END

7.
  Acknowledgments

   The current editors would like to thank the members of the IETF
   IPCDN working group and the CableLabs PacketCable Provisioning focus
   team for their contributions, comments and suggestions.

   The current editors wish to express their gratitude to the following
   individuals (in alphabetical order): David Harrington, Greg
   Nakanishi, Jean-Francois Mule, John Berg, Kevin Marez, Paul Duffy,
   Peter Bates, Randy Presuhn, Rich Woundy, Rick Vetter, Roy Spitzer,
   and Satish Kumar.


De Ketelaere/Nechamkin/Channabasappa Expires - August 2006   [Page 25]

PacketCable/IPCablecom Event management MTA MIB          February 2006






8.
  Normative References
   [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
      Requirement Levels", BCP 14, RFC 2119, March 1997.

   [PKT-SP-PROV] Packetcable MTA Device Provisioning Specification
      PKT-SP-PROV-I11-050812.

   [RFCXYZ]  Nechamkin, E., and Mule J., "Multimedia Terminal Adapter
      (MTA) Management Information Base for PacketCable and IPCablecom
      compliant devices", RFCXYZ, <Date>.

      Editor's Note (to be removed prior to publication): This is the
      reference to 'draft-ietf-ipcdn-pktc-mtamib' which is expected to
      accepted at the same time as this draft. When the draft is
      accepted, the RFC Editor is requested to replace XYZ (and in the
      reference earlier) with the assigned value and to remove this
      note.

   [ITU-T-J176] IPCablecom management event mechanism MIB, J.176, ITU-T,
       August 2002.

   [PKT-SP-EVEMIB1.5] PacketCable(TM) Management Event MIB
       Specification, PKT-SP-EVEMIB1.5-I02-050812, August, 2005.

   [PKT-SP-MEM1.5] PacketCable(TM) Management Event Mechanism
       Specification, PKT-SP-MEM1.5-I02-050812, August, 2005.

   [RFC768] J. Postel, "User Datagram Protocol", STD0006, RFC 768,
       August, 1980.

   [RFC2578] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J.,
       Rose, M. and S. Waldbusser, "Structure of Management
       Information Version 2 (SMIv2)", STD 58, RFC 2578, April
       1999.

   [RFC2579] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J.,
       Rose, M. and S. Waldbusser, "Textual Conventions for
       SMIv2", STD 58, RFC 2579, April 1999.

   [RFC2580] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J.,
       Rose, M. and S. Waldbusser, "Conformance Statements for
       SMIv2", STD 58, RFC 2580, April 1999.


   [RFC3164] C. Lonvick, "The BSD syslog Protocol", RFC 3164, August


De Ketelaere/Nechamkin/Channabasappa Expires - August 2006   [Page 26]

PacketCable/IPCablecom Event management MTA MIB          February 2006


       2001.

   [RFC2863] McCloghrie, K. and F. Kastenholz, "The Interfaces Group
   MIB", RFC 2863, June 2000.

   [RFC3411] Harrington, D., Presuhn, R. and B. Wijnen, "An Architecture
   for Describing Simple Network Management Protocol (SNMP) Management
   Frameworks", RFC 3411, December 2002.

   [RFC4001] Daniele, M., Haberman, B., Routhier, S., Schoenwaelder, J.,
   "Textual Conventions for Internet Network Addresses", RFC 4001,
   February 2005.

9.
  Informative References

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

   [PKT-SP-MGCP] Packetcable Network-Based Call Signaling Protocol
      Specification PKT-SP-EC-MGCP-I11-050812.

   [RFC3435] Andreasen, F., and B. Foster, "Media Gateway Control
      Protocol (MGCP)", RFC 3435, January 2003.

   [PKT-SP-CODEC] Packetcable Audio/Video Codecs Specification
      PKT-SP-CODEC-I06-050812.




10.
   IANA Considerations

      The MIB module in this document uses the following IANA-assigned
      OBJECT IDENTIFIER values recorded in the SMI Numbers registry:

      Descriptor     OBJECT IDENTIFIER Value
      ----------     -----------------------
      pktcIetfEventMib     { mib-2 XXX }

      Editor's Note (to be removed prior to publication): the IANA is
      requested to assign a value for XXX under the mib-2 subtree and to
      record the assignment in the SMI Numbers registry. When the
      assignment has been made, the RFC Editor is asked to replace XXX
      (here and in the MIB module) with the assigned value and to remove
      this note.

11.
   Security Considerations



De Ketelaere/Nechamkin/Channabasappa Expires - August 2006   [Page 27]

PacketCable/IPCablecom Event management MTA MIB          February 2006


   There are a number of management objects defined in this MIB module
   with a MAX-ACCESS clause of read-write.  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. Security threats include events unreported on
   errors, redirection of events (deliberately or otherwise) or
   minimized reporting of errors. Such threats can mask certain
   misconfiguration attempts and denial of service attacks that can be
   recognized and thwarted via event reporting.

   MIB objects of significance include:
   - those that control the event generation, the target syslog address
   for events and the reporting status, i.e.:
       pktcDevEvControl
       pktcDevEvSyslogAddressType
       pktcDevEvSyslogAddress
       pktcDevEvSyslogUdpPort

       pktcDevEventReportStatus

   - those related to event classes, i.e.:
       pktcDevEventClassSeverityLevel

   - those related to throttling, i.e.:
       pktcDevEvThrottleAdminStatus
       pktcDevEvThrottleThreshold
       pktcDevEvThrottleInterval

   - those related to the event reporting capabilities of an MTA, i.e:
       pktcDevEventDescrSeverityLevel
       pktcDevEventDescrReporting
       pktcDevEventDescrText
       pktcDevEventDescrClass



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

   pktcDevEventLogTable: This table contains the log of generated event
   messages. Read access to this table might reveal some specific
   information that should be kept confidential.



De Ketelaere/Nechamkin/Channabasappa Expires - August 2006   [Page 28]

PacketCable/IPCablecom Event management MTA MIB          February 2006


   pktcDevEvTransmissionStatus: This MIB Object reveals the status of
   event transmission and MAY be sensitive in some environments.

   SNMP versions prior to SNMPv3 did not include adequate security.
   Even if the network itself is secure (for example by using IPsec),
   even then, 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.

   It is RECOMMENDED that implementers consider the security features
   as provided by the SNMPv3 framework (see [RFC3410], section 8),
   including full support for the SNMPv3 cryptographic mechanisms
(for authentication and privacy).

   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.


Authors' Addresses
   Sumanth Channabasappa
   Cable Television Laboratories, Inc.
   858 Coal Creek Circle,
   Louisville, CO 80027, USA
   +1 303-661-3307
   Sumanth@cablelabs.com

   Wim De Ketelaere
   tComLabs
   Gildestraat 8
   9000 Gent, Belgium
   +32 9 269 22 90
   deketelaere@tComLabs.com

   Eugene Nechamkin
   Broadcom Corporation
   200 - 13711 International Place
   Richmond, BC, V6V 2Z8, Canada
   +1 604 233 8500
   enechamkin@broadcom.com







De Ketelaere/Nechamkin/Channabasappa Expires - August 2006   [Page 29]

PacketCable/IPCablecom Event management MTA MIB          February 2006


Full Copyright Statement

   Copyright (C) The Internet Society (2006). This document is subject
   to the rights, licenses and restrictions contained in BCP 78, and
   except as set forth therein, the authors retain all their rights.

   This document and the information contained herein are provided on an
   "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS
   OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET
   ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED,
   INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE
   INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
   WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.


Disclaimer of validity:

   The IETF takes no position regarding the validity or scope of any
   Intellectual Property Rights or other rights that might be claimed
   to pertain to the implementation or use of the technology
   described in this document or the extent to which any license
   under such rights might or might not be available; nor does it
   represent that it has made any independent effort to identify any
   such rights.  Information on the procedures with respect to rights
   in RFC documents can be found in BCP 78 and BCP 79.

   Copies of IPR disclosures made to the IETF Secretariat and any
   assurances of licenses to be made available, or the result of an
   attempt made to obtain a general license or permission for the use
   of such proprietary rights by implementers or users of this
   specification can be obtained from the IETF on-line IPR repository
   at http://www.ietf.org/ipr.

   The IETF invites any interested party to bring to its attention
   any copyrights, patents or patent applications, or other
   proprietary rights that may cover technology that may be required
   to implement this standard.  Please address the information to the
   IETF at ietf-ipr@ietf.org.













De Ketelaere/Nechamkin/Channabasappa Expires - August 2006   [Page 30]


Html markup produced by rfcmarkup 1.108, available from http://tools.ietf.org/tools/rfcmarkup/