rfc2238.txt

著名的RFC文档,其中有一些文档是已经翻译成中文的的.

Network Working Group                                B. Clouston, Editor
Request for Comments: 2238                                 Cisco Systems
Category: Standards Track                               B. Moore, Editor
                                                         IBM Corporation
                                                           November 1997


                     Definitions of Managed Objects
                          for HPR using SMIv2


Status of this Memo

   This document specifies an Internet standards track protocol for the
   Internet community, and requests discussion and suggestions for
   improvements.  Please refer to the current edition of the "Internet
   Official Protocol Standards" (STD 1) for the standardization state
   and status of this protocol.  Distribution of this memo is unlimited.

Copyright Notice

   Copyright (C) The Internet Society (1997).  All Rights Reserved.

Table of Contents

   1.     Status of this Memo  .....................................  1
   2.     Introduction  ............................................  1
   3.     The SNMP Network Management Framework  ...................  2
   4.     Overview  ................................................  2
   4.1      HPR MIB structure ......................................  3
   5.     Definitions  .............................................  5
   6.     Acknowledgments  ........................................  33
   7.     References  .............................................  33
   8.     Security Considerations  ................................  33
   9.     Authors' Addresses  .....................................  34
   10.    Full Copyright Statement ................................  35

2.  Introduction

   This memo defines a portion of the Management Information Base (MIB)
   for use with network management protocols in the Internet community.
   In particular, it defines objects for monitoring and controlling
   network devices with HPR (High Performance Routing) capabilities.
   This memo identifies managed objects for the HPR protocol.







Clouston & Moore            Standards Track                     [Page 1]

RFC 2238         Definitions of Managed Objects for HPR    November 1997


3.  The SNMP Network Management Framework

   The SNMP Network Management Framework consists of several components.
   For the purpose of this specification, the applicable components of
   the Framework are the SMI and related documents [1, 2, 3], which
   define the mechanisms used for describing and naming objects for the
   purpose of management.

   The Framework permits new objects to be defined for the purpose of
   experimentation and evaluation.

4.  Overview

   This document identifies objects for monitoring the configuration and
   active characteristics of devices with HPR capabilities.  HPR is an
   enhancement to the Advanced Peer-to-Peer Network (APPN) architecture
   that provides fast data routing and improved session reliability.
   APPN is one of the protocols that can use the HPR transport
   mechanism.  See the SNANAU APPN MIB [4] for management of APPN and
   APPN use of the HPR transport.

   The HPR terms and overall architecture [5] are available at
   http://www.networking.ibm.com/app/aiwdoc/aiwsrc.htm.

   Automatic Network Routing (ANR) is a fast low-level routing
   technique.  Each node assigns a unique (within that node) ANR label
   for each out-bound link as it is activated.  The label size is
   defined by the ANR node, and nodes only need to know how to interpret
   their own labels.  The ANR string is a group of ANR labels encoded in
   a header in front of the message being sent.  At each hop the node
   strips off its own ANR label and forwards the message onto the link
   with that label.  The last label in the string is the Network
   Connection Endpoint (NCE), which identifies the component within the
   destination node that is to receive the message.

   Rapid Transport Protocol (RTP) is an end-to-end full duplex transport
   connection (pipe).  It provides for high-speed transport of data
   using ANR.  RTP is connection-oriented, and delivers data in correct
   order reliably.  Error recovery is done efficiently with selective
   retransmission of data.  An RTP path can be switched without
   disrupting the sessions using it.  An RTP path switch may be done
   automatically if a link in the path fails and another RTP path is
   available, or on demand to attempt to restore the optimal path.

   RTP performs flow/congestion control with the Adaptive Rate-Based
   (ARB) algorithm, described in [5]. ARB is done only at the endpoints
   of the RTP pipe, so intermediate hops are not involved.




Clouston & Moore            Standards Track                     [Page 2]

RFC 2238         Definitions of Managed Objects for HPR    November 1997


   ARB regulates the flow of data over an RTP connection by adaptively
   changing the sender's rate based on feedback on the receiver's rate.
   It is designed to prevent congestion rather than react to it.

   In this document, we describe HPR managed objects.

   Highlights of the management functions supported by the HPR MIB
   module include the following:

   o    Identifying network connection endpoints (NCEs).

   o    Identifying how incoming packets are routed based on ANR labels.

   o    Monitoring the RTP connections between nodes.

   o    Ability to trigger an RTP path switch.  The MIB only supports a
        path switch with no specified path.  Some implementations may
        have a product-specific option to specify a new path.  The
        hprOperatorPathSwitchSupport object identifies this support.

   o    Historical information about RTP path switch attempts.

   This MIB module does not support:

   o    Configuration of HPR nodes.

   o    Protocol-specific uses of HPR (such as APPN).

   o    Traps.  The APPN MIB contains a trap for Alert conditions that
        may affect HPR resources.  The value for the affectedObject
        object contained in the alertTrap is determined by the
        implementation.  It may contain a VariablePointer from the HPR
        MIB.  The APPN/HPR Alerts are defined in [6].

4.1.  HPR MIB Structure

   Although HPR is an extension to APPN, the HPR MIB relies very little
   upon the APPN MIB.  The appnNodeCounterDisconTime object in the APPN
   MIB is used to detect discontinuities in HPR MIB counters.  The
   hprNodeCpName object in this MIB has the same value as the
   appnNodeCpName object in the APPN MIB.

   The HPR MIB module contains the following collections of objects:

   o    hprGlobal - general HPR objects.

   o    hprAnrRouting - objects related to the ANR routing table.




Clouston & Moore            Standards Track                     [Page 3]

RFC 2238         Definitions of Managed Objects for HPR    November 1997


   o    hprTransportUser - objects related to users of the HPR
        transport.

   o    hprRtp - objects related to the HPR Transport Tower.

   These are described below in more detail.

4.1.1.  hprGlobal group

   The hprGlobal group consists of general objects such as the APPN CP
   (control point) name of the HPR node and the level of support for
   operator-requested path switches.

4.1.2.  hprAnrRouting group

   The hprAnrRouting group consists objects to monitor and control the
   counting of ANR packets received and the following table:

   The hprAnrRoutingTable correlates incoming ANR labels to the outbound
   transmission group (TG) or local NCE to which incoming packet will be
   forwarded.  An entry defines the label type as identifying a local
   NCE or a TG, identifies the NCE or TG, and counts the number of
   packets received with the entry's ANR label.

4.1.3.  hprTransportUser group

   The hprTransportUser group consists of the following table:

   The hprNceTable identifies network connection endpoints and their
   function types.  The function type can be any combination of a CP,
   logical unit (LU), boundary function, and route setup.

4.1.4.  hprRtp group

   The hprRtp group consists of the following objects and tables:

   1) hprRtpGlobe

   These objects contain information about the number of RTP connection
   setups, and control of RTP counters.

   2) hprRtpTable

   This table contains one entry for each RTP connection.  The
   information includes local and remote NCE IDs and TCIDs (transport
   connection identifiers), timers, send rates, and statistics.  A path
   switch can be triggered by the hprRptPathSwitchTrigger object if the
   agent node supports it; however, a new path cannot be specified.



Clouston & Moore            Standards Track                     [Page 4]

RFC 2238         Definitions of Managed Objects for HPR    November 1997


   3) hprRtpStatusTable

   This table contains statistics and historical information for RTP
   path switches attempts, including old and new ANR strings and Route
   Selection Control Vectors (RSCVs), why the path switch was initiated,
   and the result (successful or reason for failure).

5.  Definitions

HPR-MIB DEFINITIONS ::= BEGIN

  IMPORTS
        DisplayString, DateAndTime, TimeStamp, TEXTUAL-CONVENTION
                FROM SNMPv2-TC

        Counter32, Gauge32, Unsigned32, TimeTicks,
        OBJECT-TYPE, MODULE-IDENTITY
                FROM SNMPv2-SMI

        MODULE-COMPLIANCE, OBJECT-GROUP
                FROM SNMPv2-CONF

        snanauMIB
                FROM SNA-NAU-MIB

        SnaControlPointName
                FROM APPN-MIB;

hprMIB MODULE-IDENTITY
        LAST-UPDATED  "970514000000Z"
        ORGANIZATION  "AIW APPN / HPR MIB SIG"
        CONTACT-INFO

                "

                        Bob Clouston
                        Cisco Systems
                        7025 Kit Creek Road
                        P.O. Box 14987
                        Research Triangle Park, NC 27709, USA
                        Tel:    [phone]
                        E-mail: [e-mail]

                        Bob Moore
                        IBM Corporation
                        800 Park Offices Drive
                        RHJA/664
                        P.O. Box 12195



Clouston & Moore            Standards Track                     [Page 5]

RFC 2238         Definitions of Managed Objects for HPR    November 1997


                        Research Triangle Park, NC 27709, USA
                        Tel:    [phone]
                        E-mail: [e-mail]
                "
      DESCRIPTION
                "This is the MIB module for objects used to
                 manage network devices with HPR capabilities."
::= { snanauMIB 6 }
-- snanauMIB ::= { mib-2 34 }

-- *********************************************************************
-- Textual Conventions
-- *********************************************************************
-- SnaControlPointName is imported from the APPN MIB

HprNceTypes ::= TEXTUAL-CONVENTION
      STATUS current
      DESCRIPTION
          "A bit string identifying the set of functions provided by a
          network connection endpoint (NCE).  The following values are
          defined:

                bit 0:  control point
                bit 1:  logical unit
                bit 2:  boundary function
                bit 3:  route setup
          "

      SYNTAX BITS { controlPoint(0),
                    logicalUnit(1),
                    boundaryFunction(2),
                    routeSetup(3) }

HprRtpCounter ::= TEXTUAL-CONVENTION
      STATUS current
      DESCRIPTION
          "An object providing statistics for an RTP connection.  A
          Management Station can detect discontinuities in this counter
          by monitoring the correspondingly indexed
          hprRtpCounterDisconTime object."

      SYNTAX Counter32

-- *********************************************************************
  hprObjects         OBJECT IDENTIFIER ::= { hprMIB 1 }
-- *********************************************************************

-- *********************************************************************



Clouston & Moore            Standards Track                     [Page 6]

RFC 2238         Definitions of Managed Objects for HPR    November 1997


hprGlobal            OBJECT IDENTIFIER ::= { hprObjects 1 }
-- *********************************************************************
-- The hprGlobal group applies to both intermediate and end nodes.
-- *********************************************************************

hprNodeCpName OBJECT-TYPE
      SYNTAX SnaControlPointName
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
          "Administratively assigned network name for the APPN node
          where this HPR implementation resides.  If this object has
          the same value as the appnNodeCpName object in the APPN MIB,
          then the two objects are referring to the same APPN node."

      ::= { hprGlobal 1 }

hprOperatorPathSwitchSupport  OBJECT-TYPE
      SYNTAX INTEGER {
                      notSupported(1),
                      switchTriggerSupported(2),
                      switchToPathSupported(3)
                     }
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
          "This object indicates an implementation's level of support
          for an operator-requested path switch.

            notSupported(1)           - the agent does not support
                                        operator-requested path switches
            switchTriggerSupported(2) - the agent supports a 'switch
                                        path now' command from an
                                        operator, but not a command to
                                        switch to a specified path
            switchToPathSupported(3)  - the agent supports both a
                                        'switch path now' command and a
                                        command to switch to a specified
                                        path.  Note that the latter
                                        command is not available via
                                        this MIB; a system that supports
                                        it must do so via other means,
                                        such as a local operator
                                        interface."

      ::= { hprGlobal 2 }

-- *********************************************************************