Blame mibs/ietf/SIP-SERVER-MIB

Packit 022b05
SIP-SERVER-MIB DEFINITIONS ::= BEGIN
Packit 022b05
Packit 022b05
IMPORTS
Packit 022b05
    MODULE-IDENTITY,
Packit 022b05
    OBJECT-TYPE,
Packit 022b05
    Counter32,
Packit 022b05
    Unsigned32,
Packit 022b05
    Gauge32,
Packit 022b05
    mib-2
Packit 022b05
          FROM SNMPv2-SMI             -- RFC 2578
Packit 022b05
Packit 022b05
    TruthValue,
Packit 022b05
    TimeStamp, DateAndTime
Packit 022b05
          FROM SNMPv2-TC              -- RFC 2579
Packit 022b05
Packit 022b05
    MODULE-COMPLIANCE,
Packit 022b05
    OBJECT-GROUP
Packit 022b05
          FROM SNMPv2-CONF            -- RFC 2580
Packit 022b05
Packit 022b05
    SnmpAdminString
Packit 022b05
          FROM SNMP-FRAMEWORK-MIB     -- RFC 3411
Packit 022b05
Packit 022b05
Packit 022b05
    applIndex
Packit 022b05
          FROM NETWORK-SERVICES-MIB   -- RFC 2788
Packit 022b05
Packit 022b05
    InetAddressType,
Packit 022b05
    InetAddress
Packit 022b05
          FROM INET-ADDRESS-MIB;      -- RFC 4001
Packit 022b05
Packit 022b05
sipServerMIB MODULE-IDENTITY
Packit 022b05
    LAST-UPDATED   "200704200000Z"
Packit 022b05
    ORGANIZATION   "IETF Session Initiation Protocol
Packit 022b05
                    Working Group"
Packit 022b05
    CONTACT-INFO
Packit 022b05
       "SIP WG email: sip@ietf.org
Packit 022b05
Packit 022b05
           Co-editor: Kevin Lingle
Packit 022b05
                      Cisco Systems, Inc.
Packit 022b05
              postal: 7025 Kit Creek Road
Packit 022b05
                      P.O. Box 14987
Packit 022b05
                      Research Triangle Park, NC 27709
Packit 022b05
                      USA
Packit 022b05
             email:   klingle@cisco.com
Packit 022b05
             phone:   +1 919 476 2029
Packit 022b05
Packit 022b05
           Co-editor: Joon Maeng
Packit 022b05
               email: jmaeng@austin.rr.com
Packit 022b05
Packit 022b05
           Co-editor: Jean-Francois Mule
Packit 022b05
                      CableLabs
Packit 022b05
              postal: 858 Coal Creek Circle
Packit 022b05
                      Louisville, CO 80027
Packit 022b05
                      USA
Packit 022b05
               email: jf.mule@cablelabs.com
Packit 022b05
               phone: +1 303 661 9100
Packit 022b05
Packit 022b05
           Co-editor: Dave Walker
Packit 022b05
               email: drwalker@rogers.com
Packit 022b05
          "
Packit 022b05
    DESCRIPTION
Packit 022b05
       "Session Initiation Protocol (SIP) Server MIB module.  SIP is an
Packit 022b05
        application-layer signaling protocol for creating, modifying,
Packit 022b05
        and terminating multimedia sessions with one or more
Packit 022b05
        participants.  These sessions include Internet multimedia
Packit 022b05
        conferences and Internet telephone calls.  SIP is defined in
Packit 022b05
        RFC 3261 (June 2002).
Packit 022b05
Packit 022b05
        This MIB is defined for the management of SIP Proxy, Redirect,
Packit 022b05
        and Registrar Servers.
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        A Proxy Server acts as both a client and a server.  It accepts
Packit 022b05
        requests from other clients, either responding to them or
Packit 022b05
        passing them on to other servers, possibly after modification.
Packit 022b05
Packit 022b05
        A Redirect Server accepts requests from clients and returns
Packit 022b05
        zero or more addresses to that client.  Unlike a User Agent
Packit 022b05
        Server, it does not accept calls.
Packit 022b05
Packit 022b05
        A Registrar is a server that accepts REGISTER requests.  A
Packit 022b05
        Registrar is typically co-located with a Proxy or Redirect
Packit 022b05
        Server.
Packit 022b05
Packit 022b05
        Copyright (C) The IETF Trust (2007).  This version of
Packit 022b05
        this MIB module is part of RFC 4780; see the RFC itself for
Packit 022b05
        full legal notices."
Packit 022b05
    REVISION        "200704200000Z"
Packit 022b05
    DESCRIPTION
Packit 022b05
       "Initial version of the IETF SIP-SERVER-MIB module.  This
Packit 022b05
       version published as part of RFC 4780."
Packit 022b05
  ::= { mib-2 151 }
Packit 022b05
Packit 022b05
-- Top-Level Components of this MIB.
Packit 022b05
Packit 022b05
sipServerMIBObjects     OBJECT IDENTIFIER ::= { sipServerMIB 1 }
Packit 022b05
sipServerMIBConformance OBJECT IDENTIFIER ::= { sipServerMIB 2 }
Packit 022b05
Packit 022b05
--
Packit 022b05
-- These groups contain objects common to all SIP servers.
Packit 022b05
--
Packit 022b05
sipServerCfg            OBJECT IDENTIFIER ::= { sipServerMIBObjects 1 }
Packit 022b05
Packit 022b05
--
Packit 022b05
-- Common Server Configuration Objects
Packit 022b05
--
Packit 022b05
sipServerCfgTable OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF SipServerCfgEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "This table contains configuration objects applicable to SIP
Packit 022b05
        Redirect and Proxy Servers."
Packit 022b05
    ::= { sipServerCfg 1 }
Packit 022b05
Packit 022b05
sipServerCfgEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      SipServerCfgEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
Packit 022b05
Packit 022b05
       "A row of common configuration.
Packit 022b05
Packit 022b05
        Each row represents those objects for a particular SIP server
Packit 022b05
        present in this system.  applIndex is used to uniquely identify
Packit 022b05
        these instances of SIP servers and correlate them through
Packit 022b05
        the common framework of the NETWORK-SERVICES-MIB (RFC 2788).
Packit 022b05
        The same value of applIndex used in the corresponding
Packit 022b05
        SIP-COMMON-MIB is used here."
Packit 022b05
    INDEX { applIndex }
Packit 022b05
    ::= { sipServerCfgTable 1 }
Packit 022b05
Packit 022b05
SipServerCfgEntry ::=
Packit 022b05
    SEQUENCE {
Packit 022b05
        sipServerCfgHostAddressType       InetAddressType,
Packit 022b05
        sipServerCfgHostAddress           InetAddress
Packit 022b05
    }
Packit 022b05
Packit 022b05
sipServerCfgHostAddressType OBJECT-TYPE
Packit 022b05
    SYNTAX      InetAddressType
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "The type of Internet address by which the SIP server is
Packit 022b05
        reachable."
Packit 022b05
    REFERENCE
Packit 022b05
       "RFC 3261, Section 19.1.1"
Packit 022b05
    ::= { sipServerCfgEntry 1 }
Packit 022b05
Packit 022b05
sipServerCfgHostAddress OBJECT-TYPE
Packit 022b05
    SYNTAX      InetAddress
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "This is the host portion of a SIP URI that is assigned to the
Packit 022b05
        SIP server.  It MAY contain a fully qualified domain name or
Packit 022b05
        an IP address.  The length of the value will depend on the type
Packit 022b05
        of address specified.  The type of address given by this object
Packit 022b05
        is controlled by sipServerCfgHostAddressType."
Packit 022b05
    REFERENCE
Packit 022b05
       "RFC 3261, Section 19.1.1"
Packit 022b05
    ::= { sipServerCfgEntry 2 }
Packit 022b05
Packit 022b05
--
Packit 022b05
-- This group contains MIB objects
Packit 022b05
-- related to SIP Proxy Servers.
Packit 022b05
--
Packit 022b05
sipServerProxyCfg      OBJECT IDENTIFIER ::= { sipServerMIBObjects 3 }
Packit 022b05
Packit 022b05
Packit 022b05
sipServerProxyStats    OBJECT IDENTIFIER ::= { sipServerMIBObjects 4 }
Packit 022b05
Packit 022b05
--
Packit 022b05
-- Proxy Server Configuration
Packit 022b05
--
Packit 022b05
sipServerProxyCfgTable OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF SipServerProxyCfgEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "This table contains configuration objects applicable to SIP
Packit 022b05
        Proxy Servers."
Packit 022b05
    ::= { sipServerProxyCfg 1 }
Packit 022b05
Packit 022b05
sipServerProxyCfgEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      SipServerProxyCfgEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "A row of common proxy configuration.
Packit 022b05
Packit 022b05
        Each row represents those objects for a particular SIP server
Packit 022b05
        present in this system.  applIndex is used to uniquely identify
Packit 022b05
        these instances of SIP servers and correlate them through the
Packit 022b05
        common framework of the NETWORK-SERVICES-MIB (RFC 2788).  The
Packit 022b05
        same value of applIndex used in the corresponding
Packit 022b05
        SIP-COMMON-MIB is used here."
Packit 022b05
    INDEX { applIndex }
Packit 022b05
    ::= { sipServerProxyCfgTable 1 }
Packit 022b05
Packit 022b05
SipServerProxyCfgEntry ::=
Packit 022b05
    SEQUENCE {
Packit 022b05
        sipServerCfgProxyStatefulness     INTEGER,
Packit 022b05
        sipServerCfgProxyRecursion        TruthValue,
Packit 022b05
        sipServerCfgProxyRecordRoute      TruthValue,
Packit 022b05
        sipServerCfgProxyAuthMethod       BITS,
Packit 022b05
        sipServerCfgProxyAuthDefaultRealm SnmpAdminString
Packit 022b05
    }
Packit 022b05
Packit 022b05
sipServerCfgProxyStatefulness OBJECT-TYPE
Packit 022b05
    SYNTAX      INTEGER {
Packit 022b05
                  stateless(1),
Packit 022b05
                  transactionStateful(2),
Packit 022b05
                  callStateful(3)
Packit 022b05
                }
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
       "This object reflects the default mode of operation for the
Packit 022b05
        Proxy Server entity.
Packit 022b05
Packit 022b05
        A stateless proxy is a logical entity that does not maintain
Packit 022b05
        the client or server transaction state machines when it
Packit 022b05
        processes requests.  A stateless proxy forwards every request it
Packit 022b05
        receives downstream and every response it receives upstream.  If
Packit 022b05
        the value of this object is stateless(1), the proxy defaults to
Packit 022b05
        stateless operations.
Packit 022b05
Packit 022b05
        A transaction stateful proxy, or simply a 'stateful proxy', is
Packit 022b05
        a logical entity that maintains the client and server
Packit 022b05
        transaction state machines during the processing of a request.
Packit 022b05
        A (transaction) stateful proxy is not the same as a call
Packit 022b05
        stateful proxy.  If the value of this object is
Packit 022b05
        transactionStateful(2), the proxy is stateful on a transaction
Packit 022b05
        basis.
Packit 022b05
Packit 022b05
        A call stateful proxy is a logical entity if it retains state
Packit 022b05
        for a dialog from the initiating INVITE to the terminating BYE
Packit 022b05
        request.  A call stateful proxy is always transaction stateful,
Packit 022b05
        but the converse is not necessarily true.  If the value of this
Packit 022b05
        object is callStateful(3), the proxy is call stateful."
Packit 022b05
Packit 022b05
    REFERENCE
Packit 022b05
        "RFC 3261, Section 16"
Packit 022b05
    ::= { sipServerProxyCfgEntry 1 }
Packit 022b05
Packit 022b05
sipServerCfgProxyRecursion OBJECT-TYPE
Packit 022b05
    SYNTAX      TruthValue
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "This object reflects whether or not the Proxy performs a
Packit 022b05
        recursive search on the Contacts provided in 3xx redirects.
Packit 022b05
Packit 022b05
        If the value of this object is 'true', a recursive search is
Packit 022b05
        performed.  If the value is 'false', no search is performed,
Packit 022b05
        and the 3xx response is sent upstream towards the source of
Packit 022b05
        the request."
Packit 022b05
    REFERENCE
Packit 022b05
       "RFC 3261 Sections 16.5 and 16.6"
Packit 022b05
    ::= { sipServerProxyCfgEntry 2 }
Packit 022b05
Packit 022b05
sipServerCfgProxyRecordRoute OBJECT-TYPE
Packit 022b05
    SYNTAX     TruthValue
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
Packit 022b05
Packit 022b05
    DESCRIPTION
Packit 022b05
       "This object reflects whether or not the proxy adds itself to
Packit 022b05
        the Record-Route header as a default action.  This header is
Packit 022b05
        used to list the proxies that insist on being in the signaling
Packit 022b05
        path for subsequent requests related to the call leg.
Packit 022b05
Packit 022b05
        If the value of this object is 'true', the proxy adds itself to
Packit 022b05
        the end of the Record-Route header, creating the header if
Packit 022b05
        required.  If the value is 'false', the proxy does not add
Packit 022b05
        itself to the Record-Route header."
Packit 022b05
    REFERENCE
Packit 022b05
       "RFC 3261, Section 20.30"
Packit 022b05
    ::= { sipServerProxyCfgEntry 3 }
Packit 022b05
Packit 022b05
--
Packit 022b05
-- Security
Packit 022b05
--
Packit 022b05
sipServerCfgProxyAuthMethod OBJECT-TYPE
Packit 022b05
    SYNTAX      BITS {
Packit 022b05
                  none(0),
Packit 022b05
                  tls(1),
Packit 022b05
                  digest(2)
Packit 022b05
                }
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "This object reflects the authentication methods that MAY be
Packit 022b05
        used to authenticate request originators.
Packit 022b05
Packit 022b05
        bit 0  no authentication is performed
Packit 022b05
        bit 1  TLS is used
Packit 022b05
        bit 2  HTTP Digest is used."
Packit 022b05
    REFERENCE
Packit 022b05
       "RFC 3261 Sections 22, 23, 26, 26.2.3"
Packit 022b05
    ::= { sipServerProxyCfgEntry 4 }
Packit 022b05
Packit 022b05
sipServerCfgProxyAuthDefaultRealm OBJECT-TYPE
Packit 022b05
    SYNTAX      SnmpAdminString
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "This object reflects the default realm value used in
Packit 022b05
        Proxy-Authenticate headers.  Note that this MAY need to be
Packit 022b05
        stored per user, in which case, this default value is ignored.
Packit 022b05
       "
Packit 022b05
    REFERENCE
Packit 022b05
       "RFC 3261, Section 22.1"
Packit 022b05
    ::= { sipServerProxyCfgEntry 5 }
Packit 022b05
Packit 022b05
Packit 022b05
--
Packit 022b05
-- Proxy Server Statistics
Packit 022b05
--
Packit 022b05
sipServerProxyStatsTable OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF SipServerProxyStatsEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "This table contains the statistics objects applicable to all
Packit 022b05
        SIP Proxy Servers in this system."
Packit 022b05
    ::= { sipServerProxyStats 1 }
Packit 022b05
Packit 022b05
sipServerProxyStatsEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      SipServerProxyStatsEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "A row of summary statistics.
Packit 022b05
Packit 022b05
        Each row represents those objects for a particular SIP server
Packit 022b05
        present in this system.  applIndex is used to uniquely identify
Packit 022b05
        these instances of SIP servers and correlate them through the
Packit 022b05
        common framework of the NETWORK-SERVICES-MIB (RFC 2788).  The
Packit 022b05
        same value of applIndex used in the corresponding
Packit 022b05
        SIP-COMMON-MIB is used here."
Packit 022b05
    INDEX { applIndex }
Packit 022b05
    ::= { sipServerProxyStatsTable 1 }
Packit 022b05
Packit 022b05
SipServerProxyStatsEntry ::=
Packit 022b05
    SEQUENCE {
Packit 022b05
        sipServerProxyStatProxyReqFailures Counter32,
Packit 022b05
        sipServerProxyStatsDisconTime      TimeStamp
Packit 022b05
    }
Packit 022b05
Packit 022b05
sipServerProxyStatProxyReqFailures OBJECT-TYPE
Packit 022b05
    SYNTAX      Counter32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "This object contains the number of occurrences of unsupported
Packit 022b05
        options being specified in received Proxy-Require headers.
Packit 022b05
        Such occurrences result in a 420 Bad Extension status code
Packit 022b05
        being returned.
Packit 022b05
Packit 022b05
        Discontinuities in the value of this counter can occur at
Packit 022b05
        re-initialization of the SIP entity or service.  A Management
Packit 022b05
        Station can detect discontinuities in this counter by
Packit 022b05
Packit 022b05
Packit 022b05
        monitoring the sipServerProxyStatsDisconTime object in the same
Packit 022b05
        row."
Packit 022b05
    ::= { sipServerProxyStatsEntry 1 }
Packit 022b05
Packit 022b05
sipServerProxyStatsDisconTime OBJECT-TYPE
Packit 022b05
 SYNTAX      TimeStamp
Packit 022b05
 MAX-ACCESS  read-only
Packit 022b05
 STATUS      current
Packit 022b05
 DESCRIPTION
Packit 022b05
    "The value of the sysUpTime object when the counters for the server
Packit 022b05
     statistics objects in this row last experienced a discontinuity."
Packit 022b05
 ::= { sipServerProxyStatsEntry 2 }
Packit 022b05
Packit 022b05
--
Packit 022b05
-- This group contains MIB objects related to SIP Registrars.
Packit 022b05
--
Packit 022b05
sipServerRegCfg         OBJECT IDENTIFIER ::= { sipServerMIBObjects 5 }
Packit 022b05
sipServerRegStats       OBJECT IDENTIFIER ::= { sipServerMIBObjects 6 }
Packit 022b05
Packit 022b05
--
Packit 022b05
-- Registrar Configuration
Packit 022b05
--
Packit 022b05
sipServerRegCfgTable OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF SipServerRegCfgEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "This table contains configuration objects applicable to SIP
Packit 022b05
        Registrars."
Packit 022b05
    ::= { sipServerRegCfg 1 }
Packit 022b05
Packit 022b05
sipServerRegCfgEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      SipServerRegCfgEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "A row of common Registrar configuration.
Packit 022b05
Packit 022b05
        Each row represents those objects for a particular SIP server
Packit 022b05
        present in this system.  applIndex is used to uniquely identify
Packit 022b05
        these instances of SIP servers and correlate them through the
Packit 022b05
        common framework of the NETWORK-SERVICES-MIB (RFC 2788).  The
Packit 022b05
        same value of applIndex used in the corresponding
Packit 022b05
        SIP-COMMON-MIB is used here."
Packit 022b05
    INDEX { applIndex }
Packit 022b05
    ::= { sipServerRegCfgTable 1 }
Packit 022b05
Packit 022b05
SipServerRegCfgEntry ::=
Packit 022b05
Packit 022b05
Packit 022b05
    SEQUENCE {
Packit 022b05
        sipServerRegMaxContactExpiryDuration  Unsigned32,
Packit 022b05
        sipServerRegMaxUsers                  Unsigned32,
Packit 022b05
        sipServerRegCurrentUsers              Gauge32,
Packit 022b05
        sipServerRegDfltRegActiveInterval     Unsigned32
Packit 022b05
    }
Packit 022b05
Packit 022b05
sipServerRegMaxContactExpiryDuration OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32 (0..4294967295)
Packit 022b05
    UNITS      "seconds"
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "This object reflects the maximum expiry that may be requested
Packit 022b05
        by a User Agent for a particular Contact.  User Agents can
Packit 022b05
        specify expiry using either an Expiry header in a REGISTER
Packit 022b05
        request, or using an Expires parameter in a Contact header in
Packit 022b05
        a REGISTER request.  If the value requested by the User Agent
Packit 022b05
        is greater than the value of this object, then the contact
Packit 022b05
        information is given the duration specified by this object, and
Packit 022b05
        that duration is indicated to the User Agent in the response."
Packit 022b05
    ::= { sipServerRegCfgEntry 1 }
Packit 022b05
Packit 022b05
sipServerRegMaxUsers OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32 (1..4294967295)
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "This object reflects the maximum number of users that the
Packit 022b05
        Registrar supports.  The current number of users is reflected
Packit 022b05
        by sipServerRegCurrentUsers."
Packit 022b05
    ::= { sipServerRegCfgEntry 2 }
Packit 022b05
Packit 022b05
sipServerRegCurrentUsers OBJECT-TYPE
Packit 022b05
    SYNTAX      Gauge32 (0..4294967295)
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "This object reflects the number of users currently registered
Packit 022b05
        with the Registrar."
Packit 022b05
    ::= { sipServerRegCfgEntry 3 }
Packit 022b05
Packit 022b05
sipServerRegDfltRegActiveInterval OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32 (1..4294967295)
Packit 022b05
    UNITS      "seconds"
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
Packit 022b05
Packit 022b05
       "This object reflects the default time interval the Registrar
Packit 022b05
        considers registrations to be active.  The value is used to
Packit 022b05
        compute the Expires header in the REGISTER response.  If a user
Packit 022b05
        agent requests a time interval shorter than specified by this
Packit 022b05
        object, the Registrar SHOULD honor that request.  If a Contact
Packit 022b05
        entry does not have an 'expires' parameter, the value of the
Packit 022b05
        Expires header field is used instead.  If a Contact entry has no
Packit 022b05
        'expires' parameter and no Expires header field is present,
Packit 022b05
        the value of this object is used as the default value."
Packit 022b05
    REFERENCE
Packit 022b05
       "RFC 3261, Section 10.2"
Packit 022b05
    ::= { sipServerRegCfgEntry 4 }
Packit 022b05
--
Packit 022b05
-- Per User Information
Packit 022b05
--
Packit 022b05
sipServerRegUserTable OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF SipServerRegUserEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "This table contains information on all users registered to each
Packit 022b05
        Registrar in this system."
Packit 022b05
    ::= { sipServerRegCfg 2 }
Packit 022b05
Packit 022b05
sipServerRegUserEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      SipServerRegUserEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "This entry contains information for a single user registered to
Packit 022b05
        this Registrar.
Packit 022b05
Packit 022b05
        Each row represents those objects for a particular SIP server
Packit 022b05
        present in this system.  applIndex is used to uniquely identify
Packit 022b05
        these instances of SIP servers and correlate them through the
Packit 022b05
        common framework of the NETWORK-SERVICES-MIB (RFC 2788).  The
Packit 022b05
        same value of applIndex used in the corresponding
Packit 022b05
        SIP-COMMON-MIB is used here."
Packit 022b05
    INDEX { applIndex, sipServerRegUserIndex }
Packit 022b05
    ::= { sipServerRegUserTable 1 }
Packit 022b05
Packit 022b05
SipServerRegUserEntry ::=
Packit 022b05
    SEQUENCE {
Packit 022b05
        sipServerRegUserIndex                  Unsigned32,
Packit 022b05
        sipServerRegUserUri                    SnmpAdminString,
Packit 022b05
        sipServerRegUserAuthenticationFailures Counter32,
Packit 022b05
        sipServerRegUserDisconTime             TimeStamp
Packit 022b05
    }
Packit 022b05
Packit 022b05
Packit 022b05
sipServerRegUserIndex OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32 (1..4294967295)
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "This object uniquely identifies a conceptual row in the table."
Packit 022b05
    ::= { sipServerRegUserEntry 1 }
Packit 022b05
Packit 022b05
sipServerRegUserUri OBJECT-TYPE
Packit 022b05
    SYNTAX      SnmpAdminString
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "This object contains the user's address-of-record.  It is the
Packit 022b05
        main form by which the Registrar knows the user.  The format is
Packit 022b05
        typically 'user@domain'.  It is contained in the To header for
Packit 022b05
        all REGISTER requests."
Packit 022b05
    ::= { sipServerRegUserEntry 2 }
Packit 022b05
Packit 022b05
sipServerRegUserAuthenticationFailures OBJECT-TYPE
Packit 022b05
    SYNTAX      Counter32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "This object contains a count of the number of times the user
Packit 022b05
        has failed authentication.
Packit 022b05
Packit 022b05
        Discontinuities in the value of this counter can occur due to
Packit 022b05
        successful user authentications and at re-initialization of
Packit 022b05
        the SIP entity or service.  A Management Station can detect
Packit 022b05
        discontinuities in this counter by monitoring the
Packit 022b05
        sipServerRegUserDisconTime object in the same row."
Packit 022b05
    ::= { sipServerRegUserEntry 3 }
Packit 022b05
Packit 022b05
sipServerRegUserDisconTime OBJECT-TYPE
Packit 022b05
    SYNTAX      TimeStamp
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "The value of the sysUpTime object when the counters for the
Packit 022b05
        user registration statistics objects in this row last
Packit 022b05
        experienced a discontinuity."
Packit 022b05
    ::= { sipServerRegUserEntry 4 }
Packit 022b05
--
Packit 022b05
-- Per Contact Information
Packit 022b05
--
Packit 022b05
sipServerRegContactTable OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF SipServerRegContactEntry
Packit 022b05
Packit 022b05
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "This table contains information on every location where a
Packit 022b05
        registered user (specified by sipServerRegUserIndex) wishes to
Packit 022b05
        be found (i.e., the user has provided contact information to
Packit 022b05
        each SIP Registrar in this system)."
Packit 022b05
    ::= { sipServerRegCfg 3 }
Packit 022b05
Packit 022b05
sipServerRegContactEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      SipServerRegContactEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "This entry contains information for a single Contact.  Multiple
Packit 022b05
        contacts may exist for a single user.
Packit 022b05
Packit 022b05
        Each row represents those objects for a particular SIP server
Packit 022b05
        present in this system.  applIndex is used to uniquely identify
Packit 022b05
        these instances of SIP servers and correlate them through the
Packit 022b05
        common framework of the NETWORK-SERVICES-MIB (RFC 2788).  The
Packit 022b05
        same value of applIndex used in the corresponding
Packit 022b05
        SIP-COMMON-MIB is used here."
Packit 022b05
Packit 022b05
    INDEX { applIndex,
Packit 022b05
            sipServerRegUserIndex,
Packit 022b05
            sipServerRegContactIndex
Packit 022b05
          }
Packit 022b05
    ::= { sipServerRegContactTable 1 }
Packit 022b05
Packit 022b05
SipServerRegContactEntry ::=
Packit 022b05
    SEQUENCE {
Packit 022b05
        sipServerRegContactIndex        Unsigned32,
Packit 022b05
        sipServerRegContactDisplayName  SnmpAdminString,
Packit 022b05
        sipServerRegContactURI          SnmpAdminString,
Packit 022b05
        sipServerRegContactLastUpdated  TimeStamp,
Packit 022b05
        sipServerRegContactExpiry       DateAndTime,
Packit 022b05
        sipServerRegContactPreference   SnmpAdminString
Packit 022b05
    }
Packit 022b05
Packit 022b05
sipServerRegContactIndex OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32 (1..4294967295)
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "Along with the sipServerRegUserIndex, this object uniquely
Packit 022b05
        identifies a conceptual row in the table."
Packit 022b05
    ::= { sipServerRegContactEntry 1 }
Packit 022b05
Packit 022b05
Packit 022b05
sipServerRegContactDisplayName OBJECT-TYPE
Packit 022b05
    SYNTAX      SnmpAdminString
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "This object contains the display name for the Contact.  For
Packit 022b05
        example, 'Santa at Home', or 'Santa on his Sled', corresponding
Packit 022b05
        to contact URIs of sip:BigGuy@example.com or
Packit 022b05
        sip:sclaus817@example.com, respectively."
Packit 022b05
    ::= { sipServerRegContactEntry 2 }
Packit 022b05
Packit 022b05
sipServerRegContactURI OBJECT-TYPE
Packit 022b05
    SYNTAX      SnmpAdminString
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "This object contains either a SIP URI where the user can be
Packit 022b05
        contacted.  This URI is normally returned to a client from a
Packit 022b05
        Redirect Server, or is used as the RequestURI in a SIP request
Packit 022b05
        line for requests forwarded by a proxy."
Packit 022b05
    ::= { sipServerRegContactEntry 3 }
Packit 022b05
Packit 022b05
sipServerRegContactLastUpdated OBJECT-TYPE
Packit 022b05
    SYNTAX      TimeStamp
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "This object indicates the time when this contact information
Packit 022b05
        was accepted.  If the contact information is updated via a
Packit 022b05
        subsequent REGISTER of the same information, this object is
Packit 022b05
        also updated."
Packit 022b05
    ::= { sipServerRegContactEntry 4 }
Packit 022b05
Packit 022b05
sipServerRegContactExpiry OBJECT-TYPE
Packit 022b05
    SYNTAX      DateAndTime
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "This object contains the date and time when the contact
Packit 022b05
        information will no longer be valid.  Such times may be
Packit 022b05
        specified by the user at registration (i.e., Expires header or
Packit 022b05
        expiry parameter in the Contact information), or a system
Packit 022b05
        default can be applied."
Packit 022b05
    ::= { sipServerRegContactEntry 5 }
Packit 022b05
Packit 022b05
sipServerRegContactPreference OBJECT-TYPE
Packit 022b05
    SYNTAX      SnmpAdminString
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "This object indicates a relative preference for the particular
Packit 022b05
        Contact header field value compared to other bindings for this
Packit 022b05
        address-of-record.  A registering user may provide this
Packit 022b05
        preference as a 'qvalue' parameter in the Contact header.
Packit 022b05
Packit 022b05
        The format of this item is a decimal number between 0 and 1
Packit 022b05
        (for example 0.9).  Higher values indicate locations preferred
Packit 022b05
        by the user."
Packit 022b05
    REFERENCE
Packit 022b05
       "RFC 3261, Section 10.2.1.2, 16.6, and 20.10"
Packit 022b05
    ::= { sipServerRegContactEntry 6 }
Packit 022b05
Packit 022b05
--
Packit 022b05
-- Registrar Statistics
Packit 022b05
--
Packit 022b05
sipServerRegStatsTable OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF SipServerRegStatsEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "This table contains the summary statistics objects applicable
Packit 022b05
        to all SIP Registrars in this system."
Packit 022b05
    ::= { sipServerRegStats 1 }
Packit 022b05
Packit 022b05
sipServerRegStatsEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      SipServerRegStatsEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "A row of summary statistics.
Packit 022b05
Packit 022b05
        Each row represents those objects for a particular SIP server
Packit 022b05
        present in this system.  applIndex is used to uniquely identify
Packit 022b05
        these instances of SIP servers and correlate them through the
Packit 022b05
        common framework of the NETWORK-SERVICES-MIB (RFC 2788).  The
Packit 022b05
        same value of applIndex used in the corresponding
Packit 022b05
        SIP-COMMON-MIB is used here."
Packit 022b05
    INDEX { applIndex }
Packit 022b05
    ::= { sipServerRegStatsTable 1 }
Packit 022b05
Packit 022b05
SipServerRegStatsEntry ::=
Packit 022b05
    SEQUENCE {
Packit 022b05
        sipServerRegStatsAcceptedRegs     Counter32,
Packit 022b05
        sipServerRegStatsRejectedRegs     Counter32,
Packit 022b05
        sipServerRegStatsDisconTime       TimeStamp
Packit 022b05
    }
Packit 022b05
Packit 022b05
Packit 022b05
sipServerRegStatsAcceptedRegs OBJECT-TYPE
Packit 022b05
    SYNTAX      Counter32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "This object contains a count of the number of REGISTER requests
Packit 022b05
        that have been accepted (status code 200) by the Registrar.
Packit 022b05
        This includes additions of new contact information, refreshing
Packit 022b05
        contact information, as well as requests for deletion of
Packit 022b05
        contact information.
Packit 022b05
Packit 022b05
        Discontinuities in the value of this counter can occur at
Packit 022b05
        re-initialization of the SIP entity or service.  A Management
Packit 022b05
        Station can detect discontinuities in this counter by
Packit 022b05
        monitoring the sipServerRegStatsDisconTime object in the same
Packit 022b05
        row."
Packit 022b05
    ::= { sipServerRegStatsEntry 1 }
Packit 022b05
Packit 022b05
sipServerRegStatsRejectedRegs OBJECT-TYPE
Packit 022b05
    SYNTAX      Counter32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "This object contains a count of the number REGISTER requests
Packit 022b05
        that have been rejected by the Registrar.
Packit 022b05
Packit 022b05
        Discontinuities in the value of this counter can occur at
Packit 022b05
        re-initialization of the SIP entity or service.  A Management
Packit 022b05
        Station can detect discontinuities in this counter by
Packit 022b05
        monitoring the sipServerRegStatsDisconTime object in the same
Packit 022b05
        row."
Packit 022b05
  ::= { sipServerRegStatsEntry 2 }
Packit 022b05
Packit 022b05
sipServerRegStatsDisconTime OBJECT-TYPE
Packit 022b05
    SYNTAX      TimeStamp
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "The value of the sysUpTime object when the counters for the
Packit 022b05
        registrar statistics objects in this row last experienced a
Packit 022b05
        discontinuity."
Packit 022b05
 ::= { sipServerRegStatsEntry 3 }
Packit 022b05
Packit 022b05
--
Packit 022b05
-- Conformance
Packit 022b05
--
Packit 022b05
sipServerMIBCompliances
Packit 022b05
         OBJECT IDENTIFIER ::= { sipServerMIBConformance 1 }
Packit 022b05
Packit 022b05
Packit 022b05
sipServerMIBGroups
Packit 022b05
         OBJECT IDENTIFIER ::= { sipServerMIBConformance 2 }
Packit 022b05
Packit 022b05
--
Packit 022b05
-- Compliance Statements
Packit 022b05
--
Packit 022b05
sipServerProxyServerCompliance MODULE-COMPLIANCE
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "The compliance statement for SIP entities acting as Proxy
Packit 022b05
        Servers."
Packit 022b05
    MODULE -- this module
Packit 022b05
        MANDATORY-GROUPS { sipServerConfigGroup,
Packit 022b05
                           sipServerProxyConfigGroup,
Packit 022b05
                           sipServerProxyStatsGroup
Packit 022b05
                         }
Packit 022b05
    ::= { sipServerMIBCompliances 1 }
Packit 022b05
Packit 022b05
sipRedirectServerCompliance MODULE-COMPLIANCE
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "The compliance statement for SIP entities acting as Redirect
Packit 022b05
        Servers."
Packit 022b05
    MODULE -- this module
Packit 022b05
        MANDATORY-GROUPS { sipServerConfigGroup }
Packit 022b05
    ::= { sipServerMIBCompliances 2 }
Packit 022b05
Packit 022b05
sipServerRegistrarServerCompliance MODULE-COMPLIANCE
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "The compliance statement for SIP entities acting as
Packit 022b05
        Registrars."
Packit 022b05
    MODULE -- this module
Packit 022b05
        MANDATORY-GROUPS { sipServerConfigGroup,
Packit 022b05
                           sipServerRegistrarConfigGroup,
Packit 022b05
                           sipServerRegistrarStatsGroup }
Packit 022b05
    GROUP sipServerRegistrarUsersGroup
Packit 022b05
    DESCRIPTION
Packit 022b05
       "This is an optional group."
Packit 022b05
    ::= { sipServerMIBCompliances 3 }
Packit 022b05
Packit 022b05
--
Packit 022b05
-- Units of Conformance
Packit 022b05
--
Packit 022b05
sipServerConfigGroup OBJECT-GROUP
Packit 022b05
    OBJECTS {
Packit 022b05
            sipServerCfgHostAddressType,
Packit 022b05
            sipServerCfgHostAddress
Packit 022b05
Packit 022b05
Packit 022b05
    }
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "A collection of objects providing configuration common to SIP
Packit 022b05
        Proxy and Redirect servers."
Packit 022b05
    ::= { sipServerMIBGroups 1 }
Packit 022b05
Packit 022b05
sipServerProxyConfigGroup OBJECT-GROUP
Packit 022b05
    OBJECTS {
Packit 022b05
            sipServerCfgProxyStatefulness,
Packit 022b05
            sipServerCfgProxyRecursion,
Packit 022b05
            sipServerCfgProxyRecordRoute,
Packit 022b05
            sipServerCfgProxyAuthMethod,
Packit 022b05
            sipServerCfgProxyAuthDefaultRealm
Packit 022b05
    }
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "A collection of objects providing configuration for SIP Proxy
Packit 022b05
        servers."
Packit 022b05
    ::= { sipServerMIBGroups 2 }
Packit 022b05
Packit 022b05
sipServerProxyStatsGroup OBJECT-GROUP
Packit 022b05
    OBJECTS {
Packit 022b05
            sipServerProxyStatProxyReqFailures,
Packit 022b05
            sipServerProxyStatsDisconTime
Packit 022b05
    }
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "A collection of objects providing statistics for SIP Proxy
Packit 022b05
        servers."
Packit 022b05
    ::= { sipServerMIBGroups 3 }
Packit 022b05
Packit 022b05
sipServerRegistrarConfigGroup OBJECT-GROUP
Packit 022b05
    OBJECTS {
Packit 022b05
            sipServerRegMaxContactExpiryDuration,
Packit 022b05
            sipServerRegMaxUsers,
Packit 022b05
            sipServerRegCurrentUsers,
Packit 022b05
            sipServerRegDfltRegActiveInterval
Packit 022b05
    }
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "A collection of objects providing configuration for SIP
Packit 022b05
        Registrars."
Packit 022b05
    ::= { sipServerMIBGroups 4 }
Packit 022b05
Packit 022b05
sipServerRegistrarStatsGroup OBJECT-GROUP
Packit 022b05
    OBJECTS {
Packit 022b05
            sipServerRegStatsAcceptedRegs,
Packit 022b05
Packit 022b05
Packit 022b05
            sipServerRegStatsRejectedRegs,
Packit 022b05
            sipServerRegStatsDisconTime
Packit 022b05
    }
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "A collection of objects providing statistics for SIP
Packit 022b05
        Registrars."
Packit 022b05
    ::= { sipServerMIBGroups 5 }
Packit 022b05
Packit 022b05
sipServerRegistrarUsersGroup OBJECT-GROUP
Packit 022b05
    OBJECTS {
Packit 022b05
            sipServerRegUserUri,
Packit 022b05
            sipServerRegUserAuthenticationFailures,
Packit 022b05
            sipServerRegUserDisconTime,
Packit 022b05
            sipServerRegContactDisplayName,
Packit 022b05
            sipServerRegContactURI,
Packit 022b05
            sipServerRegContactLastUpdated,
Packit 022b05
            sipServerRegContactExpiry,
Packit 022b05
            sipServerRegContactPreference
Packit 022b05
    }
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "A collection of objects related to registered users."
Packit 022b05
    ::= { sipServerMIBGroups 6 }
Packit 022b05
Packit 022b05
END