draft-ietf-sip-mib-01.txt   draft-ietf-sip-mib-02.txt 
SIP Working Group K. Lingle, Internet Engineering Task Force K. Lingle
Internet Draft Cisco Systems, Inc., Internet Draft Cisco Systems
draft-ietf-sip-mib-01.txt J. Maeng, Document: draft-ietf-sip-mib-02.txt J. Maeng
July 2000 VTEL Corp., March 2001 VTEL Corp.
Expires: January 2001 D. Walker, Expires: September 2001 J-F. Mule
Clarent Corp.
D. Walker
SS8 Networks, Inc. SS8 Networks, Inc.
Management Information Base Management Information Base
for Session Initiation Protocol for Session Initiation Protocol
Status of this Memo Status of this Memo
This document is an Internet-Draft and is in full conformance with This document is an Internet-Draft and is in full conformance with
all provisions of Section 10 of RFC 2026. all provisions of Section 10 of RFC 2026.
Internet-Drafts are working documents of the Internet Engineering Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF), its areas, and its working groups. Note that Task Force (IETF), its areas, and its working groups. Note that
other groups may also distribute working documents as Internet- other groups may also distribute working documents as Internet-
Drafts. Internet-Drafts are draft documents valid for a maximum of Drafts.
six months and may be updated, replaced, or obsoleted by other
documents at any time. It is inappropriate to use Internet-Drafts as 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." reference material or to cite them other than as "work in progress."
The list of current Internet-Drafts can be accessed at The list of current Internet-Drafts can be accessed at
http://www.ietf.org/ietf/1id-abstracts.txt The list of Internet- http://www.ietf.org/ietf/1id-abstracts.txt
Draft Shadow Directories can be accessed at The list of Internet-Draft Shadow Directories can be accessed at
http://www.ietf.org/shadow.html. http://www.ietf.org/shadow.html.
This particular draft is being developed in the Session Initiation This particular draft is being developed in the Session Initiation
Protocol Working Group. Discussion of it therefore belongs on that Protocol Working Group. Discussion of it therefore belongs on that
list. The charter for Session Initiation Protocol may be found at list. The charter for Session Initiation Protocol may be found at
http://www.ietf.org/html.charters/sip-charter.html http://www.ietf.org/html.charters/sip-charter.html
Abstract Abstract
This memo defines a portion of the Management Information Base (MIB) This memo defines a portion of the Management Information Base (MIB)
for use with network management protocols in the Internet community. for use with network management protocols in the Internet community.
In particular, it describes a set of managed objects that are used In particular, it describes a set of managed objects that are used
to manage Session Initiation Protocol(SIP) [17] devices, which to manage Session Initiation Protocol (SIP) entities, which include
include User Agents, Proxy servers, Redirect servers and Registrars. User Agents, Proxy servers, Redirect servers and Registrars.
Lingle/Maeng/Walker/Mule 1
Table of Contents
Abstract..........................................................1
1. Introduction...................................................2
2. The SNMP Management Framework..................................2
3. Overview.......................................................3
4. Structure of SIP MIB...........................................3
4.1. Textual Conventions..........................................4
4.2. Relationship to Other MIB....................................5
5. Definitions....................................................8
5.1. SIP Structure Management Information.........................8
5.2. SIP Textual Conventions......................................9
5.3. SIP Common..................................................10
5.4. SIP User Agent..............................................56
5.5. SIP Server (Registrar, Redirect & Proxy Server).............61
6. Security Considerations.......................................83
7. Intellectual Property.........................................84
8. Full Copyright Statement......................................84
9. References....................................................86
10. Author's Addresses..........................................87
1. Introduction 1. Introduction
This memo defines a portion of the Management Information Base This memo defines a portion of the Management Information Base (MIB)
(MIB)for use with network management protocols in the Internet for use with network management protocols in the Internet community.
community. In particular, it describes a set of managed objects that In particular, it describes a set of managed objects that are used
are used to schedule management operations periodically or at to schedule management operations periodically or at specified dates
specified dates and times. and times.
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in RFC 2119 [16]. document are to be interpreted as described in RFC 2119 [16].
Lingle/Maeng/Walker 1
2. The SNMP Management Framework 2. The SNMP Management Framework
The SNMP Management Framework presently consists of five major The SNMP Management Framework presently consists of five major
components: components:
- An overall architecture, described in RFC 2271 [1]. . An overall architecture, described in RFC 2271 [1].
- Mechanisms for describing and naming objects and events for the . Mechanisms for describing and naming objects and events for the
purpose of management. The first version of this Structure of purpose of management. The first version of this Structure of
Management Information (SMI) is called SMIv1 and described in Management Information (SMI) is called SMIv1 and described in
STD16, RFC 1155 [2], STD 16, RFC 1212 [3] and RFC 1215 [4]. The STD16, RFC 1155 [2], STD 16, RFC 1212 [3] and RFC 1215 [4]. The
second version, called SMIv2, is described in STD 58, RFC 2578 second version, called SMIv2, is described in STD 58, RFC 2578
[5], RFC 2579 [6] and RFC 2580 [7]. [5], RFC 2579 [6] and RFC 2580 [7].
- Message protocols for transferring management information. The . Message protocols for transferring management information. The
first version of the SNMP message protocol is called SNMPv1 and first version of the SNMP message protocol is called SNMPv1 and
Lingle/Maeng/Mule/Walker 2
described in RFC 1157 [8]. A second version of the SNMP message described in RFC 1157 [8]. A second version of the SNMP message
protocol, which is not an Internet standards track protocol, is protocol, which is not an Internet standards track protocol, is
called SNMPv2c and described in RFC 1901 [9] and RFC 1906 [10]. called SNMPv2c and described in RFC 1901 [9] and RFC 1906 [10].
The third version of the message protocol is called SNMPv3 and The third version of the message protocol is called SNMPv3 and
described in RFC 2272 [11] and RFC 2274 [12]. described in RFC 2272 [11] and RFC 2274 [12].
- Protocol operations for accessing management information. The . Protocol operations for accessing management information. The
first set of protocol operations and associated PDU formats is first set of protocol operations and associated PDU formats is
described in STD 15, RFC 1157 [8]. A second set of protocol described in STD 15, RFC 1157 [8]. A second set of protocol
operations and associated PDU formats is described in RFC 1905 operations and associated PDU formats is described in RFC 1905
13]. [13].
- A set of fundamental applications described in RFC 2273 [14] and . A set of fundamental applications described in RFC 2273 [14] and the
the view-based access control mechanism described in RFC 2275 view-based access control mechanism described in RFC 2275 [15].
[15].
Managed objects are accessed via a virtual information store, termed Managed objects are accessed via a virtual information store, termed
the Management Information Base or MIB. Objects in the MIB are the Management Information Base or MIB. Objects in the MIB are
defined using the mechanisms defined in the SMI. defined using the mechanisms defined in the SMI.
This memo specifies a MIB module that is compliant to the SMIv2. A This memo specifies a MIB module that is compliant to the SMIv2. A
MIB conforming to the SMIv1 can be produced through the appropriate MIB conforming to the SMIv1 can be produced through the appropriate
translations. The resulting translated MIB must be semantically translations. The resulting translated MIB must be semantically
equivalent, except where objects or events are omitted because no equivalent, except where objects or events are omitted because no
translation is possible (use of Counter64). Some machine readable translation is possible (use of Counter64). Some machine-readable
information in SMIv2 will be converted into textual descriptions in information in SMIv2 will be converted into textual descriptions in
SMIv1 during the translation process. However, this loss of machine-
SMIv1 during the translation process. However, this loss of readable information is not considered to change the semantics of
machinereadable information is not considered to change the the MIB.
semantics of the MIB.
3. Overview 3. Overview
The Session Initiation Protocol (SIP) [17] is an application-layer The Session Initiation Protocol (SIP) [17] is an application-layer
control protocol that can establish, modify and terminate multimedia control protocol that can establish, modify and terminate multimedia
sessions or calls. This MIB provides some managed objects for SIP sessions or calls. This MIB provides some managed objects for SIP
devices defined in RFC 2543 - User Agent, Proxy server, Redirect entities defined in RFC 2543 - User Agent, Proxy server, Redirect
Lingle/Maeng/Walker 2
server and Registrar. It is provided as a base for the work within server and Registrar. It is provided as a base for the work within
the working group to define a MIB. the working group to define a MIB.
This MIB is intended to provide management of the basic devices in This MIB is intended to provide management of the basic SIP
SIP. It provides for monitoring of status and protocol statistics, entities. It provides for monitoring of status and protocol
as well as for configuration of SIP devices. statistics, as well as for configuration of SIP entities. It also
includes objects for the SIP INFO method [20].
4. Structure of SIP MIB 4. Structure of SIP MIB
This memo specifies six MIB modules. They are SIP-MIB-SMI, SIP- This memo specifies five MIB modules. They are SIP-MIB-SMI, SIP-
COMMON-MIB, SIP-REGISTRAR-MIB, SIP-SERVER-MIB, SIP-UA-MIB and SIP- COMMON-MIB, SIP-SERVER-MIB, SIP-UA-MIB and SIP-TC. SIP-MIB-SMI
TC. SIP-MIB-SMI indicates the root OID of SIP MIB modules. SIP- indicates the root OID of SIP MIB modules. SIP-COMMON-MIB contains
COMMON-MIB contains common objects used in all the SIP entities such common objects used in all the SIP entities such as Registrars,
as Registrars, Proxy Servers, Redirect Servers and User Agents. SIP- Proxy Servers, Redirect Servers and User Agents. SIP-SERVER-MIB and
SIP-REGISTRAR-MIB, SIP-SERVER-MIB and SIP-UA-MIB includes objects SIP-UA-MIB includes objects defined for Registrars, Proxy Redirect
defined for Registrars, Proxy and Redirect servers, and User Agents,
respectively. SIP-TC defines the textual conventions used through
out MIB modules.
The MIB modules contain the following groups of objects: Lingle/Maeng/Mule/Walker 3
servers and User Agents, respectively. SIP-TC defines the textual
conventions used throughout MIB modules.
-- SIP-COMMON-MIB: Common to all the SIP devices Each MIB Module contains following groups of objects:
sipCommonConfigGroup
sipCommonStatsGroup
sipCommonNotifGroup
-- SIP-REGISTRAR-MIB: Groups of objects for Registrars -- SIP-COMMON-MIB: Common to all the SIP entities
sipRegistrarConfigGroup sipCommonConfigGroup,
sipRegistrarStatsGroup sipCommonStatsGroup,
sipCommonConfigTimerGroup,
sipCommonConfigTimerExtMethodGroup,
sipCommonConfigRetryGroup,
sipCommonConfigRetryExtMethodGroup,
sipCommonStatsRetryGroup,
sipCommonStatsRetryExtMethodsGroup,
sipCommonNotifGroup,
sipCommonStatusCodeNotifGroup.
-- SIP-SERVER-MIB: Groups of objects for proxy and Redirect Servers -- SIP-SERVER-MIB: Groups of objects for Registrars, Proxy and
sipServerConfigGroup -- Redirect Servers
sipServerStatsGroup sipServerConfigGroup,
sipProxyConfigGroup sipProxyConfigGroup,
sipProxyStatsGroup sipProxyStatsGroup
sipServerConfigGroup,
sipRegistrarConfigGroup,
sipRegistrarStatsGroup,
-- SIP-UA-MIB: Groups of objects for User Agents -- SIP-UA-MIB: Groups of objects for User Agents
sipUAConfigGroup sipUAConfigGroup
sipUAStatsGroup
It is required to implement SIP-COMMON-MIB together with its own MIB It is required to implement SIP-COMMON-MIB together with its own MIB
module in Registrars, Proxy Servers, Redirect Servers and User module in Registrars, Proxy Servers, Redirect Servers and User
Agents. For instance, a SIP Registrar will need four MIB modules, Agents. For instance, a SIP Registrar will need four MIB modules,
SIP-MIB-SMI, SIP-COMMON-MIB, SIP-REGISTRAR-MIB, and SIP-TC in order SIP-MIB-SMI, SIP-COMMON-MIB, SIP-SERVER-MIB, and SIP-TC in order to
to provide a complete set of objects . If a device has more than one provide a complete set of objects. If a device has more than one sip
sip entity or multiple instances of the same entity, it may entity or multiple instances of the same entity, it should implement
implement multiple SIP modules. Section 4.2 describes handling of multiple SIP modules. Section 4.2 describes handling of multiple
multiple instances in detail. instances in detail.
4.1 Textual Conventions 4.1. Textual Conventions
The data type SipServerActions is used as textual conventions in The data type SipTransportProtocol is used as textual conventions in
this document. These textual conventions have NO effect on either this document. These textual conventions have NO effect on either
the syntax nor the semantics of any managed object. Objects defined the syntax or the semantics of any managed object. Objects defined
Lingle/Maeng/Walker 3
using these conventions are always encoded by means of the rules using these conventions are always encoded by means of the rules
that define their primitive type. Hence, no changes to the SMI or that define their primitive type. Hence, no changes to the SMI or
the SNMP are necessary to accommodate these textual conventions the SNMP are necessary to accommodate these textual conventions,
which are adopted merely for the convenience of readers. which are adopted merely for the convenience of readers.
4.2 Relationship to Other MIB Lingle/Maeng/Mule/Walker 4
4.2. Relationship to Other MIB
There is a requirement to be able to support multiple instances of There is a requirement to be able to support multiple instances of
SIP MIB modules in the context of a single system having a single SIP MIB modules in the context of a single system having a single
SNMP agent. For example, a device acting as a SIP Proxy Server may SNMP agent.
also contain a Registrar function. It is also possible to have It is also possible to have multiple instances of a particular type
multiple instances of a particular type of SIP entity running on the of SIP entity running on the same system. For example, there may be
same system. For example, there may be Registrars for different Registrars for different domains with completely different
domains with completely different behaviors. behaviors.
While there are separate MIB modules defined for SIP Redirect & While there are separate MIB modules defined for SIP User Agents and
Proxy Servers, for Registrars, and for User Agents, there is also a SIP servers, there is also a "common" MIB module expected to be
"common" MIB module expected to be supported by every SIP entity. supported by every SIP entity. Further, all SIP entities are either
So a SIP Proxy Server must support the SIP-SERVER-MIB and SIP- acting as a UAC, UAS or perhaps both. So a SIP Proxy Server must
COMMON-MIB modules. Likewise, the Registrar must support the SIP- support the SIP-SERVER-MIB and SIP-COMMON-MIB modules. Likewise,
REGISTRAR and SIP-COMMON-MIB modules. Here we have the requirement the Registrar must support the SIP-SERVER-MIB and SIP-COMMON-MIB
for supporting multiple instances of a particular MIB module in one modules. Here we have the requirement for supporting multiple
system. instances of a particular MIB module in one system.
This problem is solved by using the framework provided by RFC 2788 This requirement is solved by using the framework provided by the
[19]. The Network Services Monitoring MIB applTable will be NETWORK-SERVICES-MIB, RFC 2788 [19]. A device implementing the SIP
populated with entries corresponding to each SIP entity in the MIB MUST support the NETWORK-SERVICES-MIB and, at a minimum, it MUST
system. Each entity will then have an applIndex associated with it. support the applIndex and applName objects in applTable. The
That applIndex is used throughout the SIP MIB modules' tables so following applName conventions will be adopted:
that each SIP entity can have its own set (instances) of managed
objects defined in those MIBs.
A quick example will illustrate how it would conceptually appear in o for a SIP Proxy entity, applName must be equal to "sip_proxy"
a running system. Take the example above of a Proxy Server co- o for a SIP Redirect entity, applName must be equal to
located with a Registrar. "sip_redirect"
o for a SIP Registrar entity, applName must be equal to
"sip_registrar"
o for a SIP User Agent entity, applName must be equal to
"sip_ua"
o for a SIP entity acting in any combination of Proxy, Redirect,
or Registrar, AND wishing to support only a single instance of
the SIP-COMMON-MIB, the applName for the combined server
entity must reflect the appropriate combination. For example,
"sip_proxy_redirect" or "sip_proxy_registrar".
NETWORK-SERVICES-MIB applTable would be populated something like the Additionally, the following objects may be supported in applTable.
following: If they are, the object values SHOULD be populated as follows:
applIndex | applName | applDescription o applVersion: version of the SIP application; if the SIP
----------+-----------------+------------------------------ protocol version is used, the value MUST be as defined in SIP
1 | "sip_proxy" | "ACME Inc. SIP Proxy Ver 1.0" [17], section 4.3.1.
----------+-----------------+------------------------------ o applUptime: value must be identical to sipServiceStartTime
2 | "registrar" | "ACME Inc. Registrar Ver 1.3" defined in the SIP-COMMON module,
----------+-----------------+------------------------------ o applOperStatus: value should reflect the operational status
defined in sipServiceOperStatus, at least by means of a
mapping,
o applLastChange: value must be identical to
sipServiceLastChange defined in the SIP-COMMON module.
Lingle/Maeng/Mule/Walker 5
Note: There are a number of other objects in the applTable. They Note: There are a number of other objects in the applTable. They
are not included for the sake of brevity and for the fact that they are not included for the sake of brevity and for the fact that they
do not enhance the concept being presented. do not enhance the concept being presented.
Example 1: The table below illustrates how it would conceptually
appear in a system acting as both, a Proxy and Registrar server and
wishing to maintain separate SIP-COMMON-MIB instances.
The NETWORK-SERVICES-MIB applTable would be populated as follows:
applIndex | applName | applDescription
----------+-----------------+------------------------------
1 | "sip_proxy" | "ACME SIP Proxy"
----------+-----------------+------------------------------
2 | "sip_registrar" | "ACME SIP Registrar"
----------+-----------------+------------------------------
The SIP-COMMON-MIB sipCommonCfgTable would have two rows: one for The SIP-COMMON-MIB sipCommonCfgTable would have two rows: one for
the proxy (applIndex=1) and one for the registrar (applIndex=2). the proxy (applIndex=1) and one for the registrar (applIndex=2).
The SIP-SERVER-MIB and SIP-REGISTRAR-MIB tables would, however, The SIP-SERVER-MIB tables would, however, only be populated with one
row indexed by applIndex=1 and applIndex=2 respectively if the
Lingle/Maeng/Walker 4 server provides either proxy or registrar.
only be populated with one row indexed by applIndex=1 and
applIndex=2 respectively.
SIP-COMMON-MIB sipCommonCfgTable might be populated as: SIP-COMMON-MIB sipCommonCfgTable might be populated as:
applIndex | sipProtocolVersion | sipServiceOperStatus | ... applIndex | sipProtocolVersion | sipServiceOperStatus | ...
----------+--------------------+----------------------+---- ----------+--------------------+----------------------+----
1 | "SIP/2.0" | up(1) | 1 | "SIP/2.0" | up(1) |
----------+--------------------+----------------------+---- ----------+--------------------+----------------------+----
2 | "SIP/2.0" | restarting(6) | 2 | "SIP/2.0" | restarting(6) |
----------+--------------------+----------------------+---- ----------+--------------------+----------------------+----
while the SIP-SERVER-MIB sipProxyCfgTable is populated as: while sipProxyCfgTable in SIP-SERVER-MIB is populated as:
applIndex | sipRequestMaxExpires | sipProxyStateful | ... applIndex | sipRequestMaxExpires | sipProxyStateful | ...
----------+----------------------+------------------+---- ----------+----------------------+------------------+----
1 | 3600 | false | 1 | 3600 | false |
----------+----------------------+------------------+---- ----------+----------------------+------------------+----
and the SIP-REGISTRAR-MIB sipRegUserTable is populated as: and sipRegUserTable in SIP-SERVER-MIB is populated as:
applIndex | sipUserIndex | sipUserUri | ... applIndex | sipUserIndex | sipUserUri | ...
----------+--------------+--------------------------+---- ----------+--------------+--------------------------+----
2 | 1 | drwalker@ss8networks.com | 2 | 1 | drwalker@ss8.com |
----------+--------------+--------------------------+---- ----------+--------------+--------------------------+----
2 | 2 | joon_maeng@vtel.com | 2 | 2 | jmaeng@vtel.com |
----------+--------------+--------------------------+---- ----------+--------------+--------------------------+----
2 | 3 | klingle@cisco.com | 2 | 3 | klingle@cisco.com |
----------+--------------+--------------------------+---- ----------+--------------+--------------------------+----
2 | 4 | jfm@clarent.com |
----------+--------------+--------------------------+----
Lingle/Maeng/Mule/Walker 6
Example 2: The next table illustrates how it would conceptually
appear in a system acting as both, a Proxy and Registrar server and
wishing to share a single instance of SIP-COMMON-MIB.
The NETWORK-SERVICES-MIB applTable would be populated as follows:
applIndex | applName | applDescription
----------+----------------------+---------------------------
1 | "sip_proxy_registrar"| "ACME SIP Proxy&Registrar"
----------+----------------------+---------------------------
The SIP-COMMON-MIB sipCommonCfgTable would have only one row to
cover both the proxy and the registrar.
SIP-COMMON-MIB sipCommonCfgTable might be populated as:
applIndex | sipProtocolVersion | sipServiceOperStatus | ...
----------+--------------------+----------------------+----
1 | "SIP/2.0" | up(1) |
----------+--------------------+----------------------+----
while sipProxyCfgTable in SIP-SERVER-MIB is populated as:
applIndex | sipRequestMaxExpires | sipProxyStateful | ...
----------+----------------------+------------------+----
1 | 3600 | false |
----------+----------------------+------------------+----
and sipRegUserTable in SIP-SERVER-MIB is populated as:
applIndex | sipUserIndex | sipUserUri | ...
----------+--------------+--------------------------+----
1 | 1 | drwalker@ss8networks.com |
----------+--------------+--------------------------+----
1 | 2 | jmaeng@vtel.com |
----------+--------------+--------------------------+----
1 | 3 | klingle@cisco.com |
----------+--------------+--------------------------+----
1 | 4 | jfm@clarent.com |
----------+--------------+--------------------------+----
The NETWORK-SERVICES-MIB assocTable is not considered a requirement The NETWORK-SERVICES-MIB assocTable is not considered a requirement
for SIP systems. It is not a mandatory group for NETWORK-SERVICES- for SIP systems. It is not a mandatory group for NETWORK-SERVICES-
MIB compliance. MIB compliance.
Lingle/Maeng/Mule/Walker 7
5. Definitions 5. Definitions
5.1. SIP Structure Management Information 5.1. SIP Structure Management Information
SIP-MIB-SMI DEFINITIONS ::= BEGIN SIP-MIB-SMI DEFINITIONS ::= BEGIN
IMPORTS IMPORTS
MODULE-IDENTITY, MODULE-IDENTITY,
mib-2 mib-2
FROM SNMPv2-SMI; FROM SNMPv2-SMI;
sipMIB MODULE-IDENTITY sipMIB MODULE-IDENTITY
LAST-UPDATED "200007080000Z" LAST-UPDATED "200102230000Z"
ORGANIZATION "IETF SIP Working Group, SIP MIB Team" ORGANIZATION "IETF SIP Working Group, SIP MIB Team"
CONTACT-INFO CONTACT-INFO
"SIP MIB Team email: sip-mib@egroups.com "SIP MIB Team email: sip-mib@egroups.com
Co-editor Kevin Lingle Co-editor Kevin Lingle
Cisco Systems, Inc. Cisco Systems, Inc.
postal: 7025 Kit Creek Road postal: 7025 Kit Creek Road
Lingle/Maeng/Walker 5
P.O. Box 14987 P.O. Box 14987
Research Triangle Park, NC 27709 Research Triangle Park, NC 27709
USA USA
email: klingle@cisco.com email: klingle@cisco.com
phone: +1-919-392-2029 phone: +1-919-392-2029
Co-editor Joon Maeng Co-editor Joon Maeng
VTEL Corporation VTEL Corporation
postal: 108 Wild Basin Rd. postal: 108 Wild Basin Rd.
Austin, TX 78746 Austin, TX 78746
USA USA
email: joon_maeng@vtel.com email: joon_maeng@vtel.com
phone: +1-512-437-4567 phone: +1-512-437-4567
Co-editor Dave Walker Co-editor Dave Walker
SS8 Networks, Inc. SS8 Networks, Inc.
postal: 80 Hines Road postal: 495 March Road
Kanata, ON K2K 2T8 Kanata, ON K2K 3G1
Canada Canada
email: drwalker@ss8networks.com email: drwalker@ss8.com
phone: +1 613 592 2100" phone: +1 613 592 2100
Co-editor Jean-Francois Mule
Clarent Corporation
700 Chesapeake Drive
Redwood City, CA 94063
email: jfm@clarent.com
phone: +1 650 481 2835"
DESCRIPTION DESCRIPTION
"Initial version of Session Initiation Protocol (SIP) "Initial version of Session Initiation Protocol (SIP)
MIB module that defines base OID for all other MIB module that defines base OID for all other
SIP-related MIB Modules." SIP-related MIB Modules."
Lingle/Maeng/Mule/Walker 8
::= { mib-2 9998 } -- to be assigned by IANA ::= { mib-2 9998 } -- to be assigned by IANA
END END
5.2. SIP Textual Conventions 5.2. SIP Textual Conventions
SIP-TC DEFINITIONS ::= BEGIN SIP-TC DEFINITIONS ::= BEGIN
IMPORTS IMPORTS
MODULE-IDENTITY MODULE-IDENTITY
FROM SNMPv2-SMI FROM SNMPv2-SMI
TEXTUAL-CONVENTION TEXTUAL-CONVENTION
FROM SNMPv2-TC FROM SNMPv2-TC
sipMIB sipMIB
FROM SIP-MIB-SMI; FROM SIP-MIB-SMI;
sipTC MODULE-IDENTITY sipTC MODULE-IDENTITY
LAST-UPDATED "200007080000Z" LAST-UPDATED "200102280000Z"
ORGANIZATION "IETF SIP Working Group, SIP MIB Team" ORGANIZATION "IETF SIP Working Group, SIP MIB Team"
CONTACT-INFO CONTACT-INFO
"SIP MIB Team email: sip-mib@egroups.com "SIP MIB Team email: sip-mib@yahoogroups.com
Co-editor Kevin Lingle Co-editor Kevin Lingle
Cisco Systems, Inc. Cisco Systems, Inc.
postal: 7025 Kit Creek Road postal: 7025 Kit Creek Road
P.O. Box 14987 P.O. Box 14987
Research Triangle Park, NC 27709 Research Triangle Park, NC 27709
Lingle/Maeng/Walker 6
USA USA
email: klingle@cisco.com email: klingle@cisco.com
phone: +1-919-392-2029 phone: +1 919 392 2029
Co-editor Joon Maeng Co-editor Joon Maeng
VTEL Corporation VTEL Corporation
postal: 108 Wild Basin Rd. postal: 108 Wild Basin Rd.
Austin, TX 78746 Austin, TX 78746
USA USA
email: joon_maeng@vtel.com email: joon_maeng@vtel.com
phone: +1-512-437-4567 phone: +1 512 437 4567
Co-editor Dave Walker Co-editor Dave Walker
SS8 Networks, Inc. SS8 Networks, Inc.
postal: 80 Hines Road postal: 495 March Road
Kanata, ON K2K 2T8 Kanata, ON K2K 3G1
Canada Canada
email: drwalker@ss8networks.com email: drwalker@ss8.com
phone: +1 613 592 2100" phone: +1 613 592 2100
Co-editor Jean-Francois Mule
Clarent Corporation
700 Chesapeake Drive
Redwood City, CA 94063
email: jfm@clarent.com
phone: +1 650 481 2835"
Lingle/Maeng/Mule/Walker 9
DESCRIPTION DESCRIPTION
"Initial version of Session Initiation Protocol (SIP) "Initial version of Session Initiation Protocol (SIP)
MIB Textual Conventions module used by other MIB Textual Conventions module used by other
SIP-related MIB Modules." SIP-related MIB Modules."
::= { sipMIB 1 } ::= { sipMIB 1 }
-- --
-- Textual Conventions -- Textual Conventions
-- --
SipServerActions ::= TEXTUAL-CONVENTION
SipTransportProtocol ::= TEXTUAL-CONVENTION
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Lists the possible actions of a SIP network server. "This convention is a bit map. Each bit represents a
A specific action may be requested by a user agent transport protocol. If a bit has value 1, then that
as a Contact parameter in a REGISTER." transport protocol selected in some way dependent on
SYNTAX INTEGER { the context of the object using this convention.
redirect(1), If a bit has value 0, then that transport protocol
proxy(2) is not selected. Combinations of bits can be
set when multiple transport protocols are selected.
bit 0 : a protocol other than those defined here.
bit 1 : User Datagram Protocol.
bit 2 : Transmission Control Protocol.
bit 3 : Stream Control Transmission Protocol.
bit 4 : Transport Layer Security Protocol."
SYNTAX BITS {
other(0), -- none of the following
udp(1),
tcp(2),
sctp(3),
tls(4)
} }
END END
5.3. SIP Common 5.3. SIP Common
SIP-COMMON-MIB DEFINITIONS ::= BEGIN SIP-COMMON-MIB DEFINITIONS ::= BEGIN
IMPORTS IMPORTS
MODULE-IDENTITY, MODULE-IDENTITY,
OBJECT-TYPE, OBJECT-TYPE,
NOTIFICATION-TYPE, NOTIFICATION-TYPE,
Counter32, Counter32,
Integer32, Integer32,
Gauge32, Gauge32,
TimeTicks, TimeTicks,
skipping to change at line 389 skipping to change at line 515
IMPORTS IMPORTS
MODULE-IDENTITY, MODULE-IDENTITY,
OBJECT-TYPE, OBJECT-TYPE,
NOTIFICATION-TYPE, NOTIFICATION-TYPE,
Counter32, Counter32,
Integer32, Integer32,
Gauge32, Gauge32,
TimeTicks, TimeTicks,
Unsigned32 Unsigned32
Lingle/Maeng/Walker 7
FROM SNMPv2-SMI FROM SNMPv2-SMI
DateAndTime, DateAndTime,
RowStatus, RowStatus,
TruthValue TruthValue
FROM SNMPv2-TC FROM SNMPv2-TC
MODULE-COMPLIANCE, MODULE-COMPLIANCE,
Lingle/Maeng/Mule/Walker 10
OBJECT-GROUP, OBJECT-GROUP,
NOTIFICATION-GROUP NOTIFICATION-GROUP
FROM SNMPv2-CONF FROM SNMPv2-CONF
SnmpAdminString SnmpAdminString
FROM SNMP-FRAMEWORK-MIB FROM SNMP-FRAMEWORK-MIB
sipMIB sipMIB
FROM SIP-MIB-SMI FROM SIP-MIB-SMI
SipTransportProtocol
FROM SIP-TC
applIndex applIndex
FROM NETWORK-SERVICES-MIB; FROM NETWORK-SERVICES-MIB;
sipCommonMIB MODULE-IDENTITY sipCommonMIB MODULE-IDENTITY
LAST-UPDATED "200004120000Z" LAST-UPDATED "200102230000Z"
ORGANIZATION "IETF SIP Working Group, SIP MIB Team" ORGANIZATION "IETF SIP Working Group, SIP MIB Team"
CONTACT-INFO CONTACT-INFO
"SIP MIB Team email: sip-mib@egroups.com "SIP MIB Team email: sip-mib@yahoogroups.com
Co-editor Kevin Lingle Co-editor Kevin Lingle
Cisco Systems, Inc. Cisco Systems, Inc.
postal: 7025 Kit Creek Road postal: 7025 Kit Creek Road
P.O. Box 14987 P.O. Box 14987
Research Triangle Park, NC 27709 Research Triangle Park, NC 27709
USA USA
email: klingle@cisco.com email: klingle@cisco.com
phone: +1-919-392-2029 phone: +1 919 392 2029
Co-editor Joon Maeng Co-editor Joon Maeng
VTEL Corporation VTEL Corporation
postal: 108 Wild Basin Rd. postal: 108 Wild Basin Rd.
Austin, TX 78746 Austin, TX 78746
USA USA
email: joon_maeng@vtel.com email: joon_maeng@vtel.com
phone: +1-512-437-4567 phone: +1 512 437 4567
Co-editor Dave Walker Co-editor Dave Walker
SS8 Networks, Inc. SS8 Networks, Inc.
postal: 80 Hines Road postal: 495 March Road
Kanata, ON K2K 2T8 Kanata, ON K2K 3G1
Canada Canada
email: drwalker@ss8networks.com email: drwalker@ss8.com
phone: +1 613 592 2100" phone: +1 613 592 2100
Co-editor Jean-Francois Mule
Clarent Corporation
700 Chesapeake Drive
Redwood City, CA 94063
email: jfm@clarent.com
phone: +1 650 481 2835"
DESCRIPTION DESCRIPTION
"Initial version of Session Initiation Protocol (SIP) "Initial version of Session Initiation Protocol (SIP)
Lingle/Maeng/Walker 8
Common MIB module. This module defines objects which Common MIB module. This module defines objects which
Lingle/Maeng/Mule/Walker 11
may be common to all SIP entities. may be common to all SIP entities.
SIP is an application-layer signalling protocol for SIP is an application-layer signalling protocol for
creating, modifying and terminating multimedia creating, modifying and terminating multimedia
sessions with one or more participants. These sessions sessions with one or more participants. These sessions
include Internet multimedia conferences and Internet include Internet multimedia conferences and Internet
telephone calls. SIP is defined in RFC 2543 (March telephone calls. SIP is defined in RFC 2543 (March
1999). 1999).
This MIB is defined for the managing objects which are This MIB is defined for the managing objects which are
skipping to change at line 491 skipping to change at line 627
requests. A Registrar is typically co-located with a requests. A Registrar is typically co-located with a
Proxy or Redirect Server." Proxy or Redirect Server."
::= { sipMIB 2 } ::= { sipMIB 2 }
-- --
-- sipCommon Group -- sipCommon Group
-- This group contains MIB objects that are common to all SIP -- This group contains MIB objects that are common to all SIP
-- entities. -- entities.
-- --
sipCommonCfg OBJECT IDENTIFIER ::= { sipCommonMIB 1 } sipCommonCfg OBJECT IDENTIFIER ::= { sipCommonMIB 1 }
sipCommonCfgBase OBJECT IDENTIFIER ::= { sipCommonCfg 1 }
sipCommonCfgTimer OBJECT IDENTIFIER ::= { sipCommonCfg 2 }
sipCommonCfgRetry OBJECT IDENTIFIER ::= { sipCommonCfg 3 }
sipCommonStats OBJECT IDENTIFIER ::= { sipCommonMIB 2 } sipCommonStats OBJECT IDENTIFIER ::= { sipCommonMIB 2 }
sipCommonStatsSummary OBJECT IDENTIFIER ::= { sipCommonStats 1 } sipCommonStatsSummary OBJECT IDENTIFIER ::= { sipCommonStats 1 }
sipCommonStatsMethod OBJECT IDENTIFIER ::= { sipCommonStats 2 } sipCommonStatsMethod OBJECT IDENTIFIER ::= { sipCommonStats 2 }
sipCommonStatusCode OBJECT IDENTIFIER ::= { sipCommonStats 3 } sipCommonStatusCode OBJECT IDENTIFIER ::= { sipCommonStats 3 }
sipCommonStatsTrans OBJECT IDENTIFIER ::= { sipCommonStats 4 } sipCommonStatsTrans OBJECT IDENTIFIER ::= { sipCommonStats 4 }
sipCommonStatsRetry OBJECT IDENTIFIER ::= { sipCommonStats 5 }
Lingle/Maeng/Walker 9 Lingle/Maeng/Mule/Walker 12
-- --
-- Common Configuration Objects -- Common Configuration Objects
-- --
sipCommonCfgTable OBJECT-TYPE sipCommonCfgTable OBJECT-TYPE
SYNTAX SEQUENCE OF SipCommonCfgEntry SYNTAX SEQUENCE OF SipCommonCfgEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table contains the common configuration objects "This table contains the common configuration objects
applicable to all SIP entities. Each row represents applicable to all SIP entities. Each row represents
those objects for a particular SIP entity present in those objects for a particular SIP entity present in
this system. The instances of SIP entities are this system. The instances of SIP entities are
uniquely identified by applIndex." uniquely identified by applIndex."
::= { sipCommonCfg 1 } ::= { sipCommonCfgBase 1 }
sipCommonCfgEntry OBJECT-TYPE sipCommonCfgEntry OBJECT-TYPE
SYNTAX SipCommonCfgEntry SYNTAX SipCommonCfgEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A row of common configuration." "A row of common configuration."
INDEX { applIndex } INDEX { applIndex }
::= { sipCommonCfgTable 1 } ::= { sipCommonCfgTable 1 }
SipCommonCfgEntry ::= SipCommonCfgEntry ::=
SEQUENCE { SEQUENCE {
sipProtocolVersion SnmpAdminString, sipProtocolVersion SnmpAdminString,
sipServiceOperStatus INTEGER, sipServiceOperStatus INTEGER,
sipServiceAdminStatus INTEGER, sipServiceAdminStatus INTEGER,
sipServiceStartTime TimeTicks, sipServiceStartTime TimeTicks,
sipServiceLastChange TimeTicks, sipServiceLastChange TimeTicks,
sipOrganization SnmpAdminString, sipOrganization SnmpAdminString,
sipMaxTransactions Unsigned32, sipMaxSessions Unsigned32,
sipInviteTimeout Unsigned32, sipInviteTimeout Unsigned32,
sipHideOperation INTEGER,
sipUserLocationServerAddr SnmpAdminString,
sipCanUseCompact TruthValue,
sipRequestUriHostMatching TruthValue sipRequestUriHostMatching TruthValue
} }
sipProtocolVersion OBJECT-TYPE sipProtocolVersion OBJECT-TYPE
SYNTAX SnmpAdminString SYNTAX SnmpAdminString
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object will reflect the version of SIP supported by "This object will reflect the version of SIP supported by
this SIP entity. It will follow the same format as SIP this SIP entity. It will follow the same format as SIP
version information contained in the SIP messages version information contained in the SIP messages
generated by this SIP entity. For example, entities generated by this SIP entity. For example, entities
supporting SIP version 2 will return 'SIP/2.0' as dictated supporting SIP version 2 will return 'SIP/2.0' as dictated
by RFC 2543." by RFC 2543."
::= { sipCommonCfgEntry 1 } ::= { sipCommonCfgEntry 1 }
Lingle/Maeng/Walker 10
sipServiceOperStatus OBJECT-TYPE sipServiceOperStatus OBJECT-TYPE
SYNTAX INTEGER { SYNTAX INTEGER {
up(1), up(1),
down(2), down(2),
testing(3), testing(3),
Lingle/Maeng/Mule/Walker 13
unknown(4), unknown(4),
halted(5), halted(5),
restarting(6) restarting(6)
} }
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object contains the current operational state of the "This object contains the current operational state of the
SIP application. SIP application.
skipping to change at line 605 skipping to change at line 743
state of the SIP server application. state of the SIP server application.
shutdown(1) : Immediately kill the application, don't shutdown(1) : Immediately kill the application, don't
restart. restart.
reset(2) : Restart application, reinitialize data, reset(2) : Restart application, reinitialize data,
requires rts. requires rts.
restart(3) : Restart application, no data loss, requires restart(3) : Restart application, no data loss, requires
rts. rts.
stop(4) : Stop processing new requests, requires rts. stop(4) : Stop processing new requests, requires rts.
rts(5) : Return to service." rts(5) : Return to service."
Lingle/Maeng/Walker 11
::= { sipCommonCfgEntry 3 } ::= { sipCommonCfgEntry 3 }
sipServiceStartTime OBJECT-TYPE sipServiceStartTime OBJECT-TYPE
SYNTAX TimeTicks SYNTAX TimeTicks
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The value of sysUpTime at the time the SIP entity was last "The value of sysUpTime at the time the SIP entity was last
started. If the current state was entered prior to the started. If the current state was entered prior to the
Lingle/Maeng/Mule/Walker 14
last re-initialization of the local network management last re-initialization of the local network management
subsystem, then this object contains a zero value." subsystem, then this object contains a zero value."
::= { sipCommonCfgEntry 4 } ::= { sipCommonCfgEntry 4 }
sipServiceLastChange OBJECT-TYPE sipServiceLastChange OBJECT-TYPE
SYNTAX TimeTicks SYNTAX TimeTicks
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The value of sysUpTime at the time the SIP entity entered "The value of sysUpTime at the time the SIP entity entered
skipping to change at line 645 skipping to change at line 783
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object contains the name of the organization issuing "This object contains the name of the organization issuing
the request or response. It may also be inserted by a the request or response. It may also be inserted by a
proxy at a boundary of an organization. If the object proxy at a boundary of an organization. If the object
exists, it is inserted into requests and responses." exists, it is inserted into requests and responses."
REFERENCE REFERENCE
"RFC 2543, Section 6.24" "RFC 2543, Section 6.24"
::= { sipCommonCfgEntry 6 } ::= { sipCommonCfgEntry 6 }
sipMaxTransactions OBJECT-TYPE sipMaxSessions OBJECT-TYPE
SYNTAX Unsigned32 (1..4294967295) SYNTAX Unsigned32 (1..4294967295)
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object indicates the maximum number of simultaneous "This object indicates the maximum number of simultaneous
transactions that the SIP entity can manage." sessions that the SIP entity can manage."
::= { sipCommonCfgEntry 7 } ::= { sipCommonCfgEntry 7 }
sipInviteTimeout OBJECT-TYPE sipInviteTimeout OBJECT-TYPE
SYNTAX Unsigned32 (0..4294967295) SYNTAX Unsigned32 (0..4294967295)
UNITS "seconds" UNITS "seconds"
MAX-ACCESS read-write MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"For user agent clients, this value is inserted into the
Lingle/Maeng/Walker 12 Expires header.
"This object specifies the default duration that a SIP
client will wait for a response to an INVITE request.
For proxy servers, if a received request contained an For proxy servers, if a received request contained an
Expires header, then the value in the header takes Expires header, then the value in the header takes
precedence. The server returns a 408 Request Timeout if precedence. The server returns a 408 Request Timeout if
no response is received before no response is received before
expiration of the request timer. expiration of the request timer."
For user agent clients, this value is inserted into the
Expires header."
::= { sipCommonCfgEntry 8 } ::= { sipCommonCfgEntry 8 }
sipHideOperation OBJECT-TYPE
SYNTAX INTEGER {
none(1),
hop(2),
route(3)
}
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object specifies which type of Hide header the server
adds to requests. These headers are normally added by a
User Agent, but may be added by a proxy. The value of
this object does not affect processing of Hide headers in
received requests.
The value of this object only applies to requests that do
not contain a Hide:route header.
none(1) : The server doesn't insert a Hide header.
hop(2) : The server inserts a Hide:hop header.
route(3) : The server inserts a Hide:route header."
REFERENCE
"RFC 2543, Section 6.22"
DEFVAL { none }
::= { sipCommonCfgEntry 9 }
sipUserLocationServerAddr OBJECT-TYPE
SYNTAX SnmpAdminString
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object will specify the address of the User Location
Server (ULS) being used to resolve the location of end
points.
This could be a Domain Name Server (DNS) or a SIP
proxy/redirect server in the case where this entity is a
user agent. This could be some sort of database server if
this entity is a proxy/redirect server.
The format of the address follows the IETF service
Lingle/Maeng/Walker 13
location protocol. The syntax is as follows:
mapping-type:type-specific-syntax
The mapping-type specifies a scheme for mapping the
matching dial string to a target server. The type-
specific-syntax is exactly that, something that the
particular mapping scheme can understand.
For example,
Session target Meaning
ipv4:171.68.13.55:1006 The session target is the IP
version 4 address of
171.68.13.55 and port 1006.
dns:pots.cisco.com The session target is the IP
host with dns name
pots.cisco.com.
The valid Mapping type definitions for the peer are as
follows:
ipv4 - Syntax: ipv4:w.x.y.z:port or ipv4:w.x.y.z
dns - Syntax: dns:host.domain."
::= { sipCommonCfgEntry 10 }
sipCanUseCompact OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object specifies whether or not the client is able
to use the compact encoding form in the requests it sends.
If the value of this object is TRUE, the client is able to
encode outgoing messages using the compact encoding form.
If the value is FALSE, the client is unable to encode
outgoing messages using the compact form."
REFERENCE
"RFC 2543, Section 9"
::= { sipCommonCfgEntry 11 }
sipRequestUriHostMatching OBJECT-TYPE sipRequestUriHostMatching OBJECT-TYPE
SYNTAX TruthValue SYNTAX TruthValue
MAX-ACCESS read-write MAX-ACCESS read-write
Lingle/Maeng/Mule/Walker 15
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object specifies whether or not the host in "This object specifies whether or not the host in
RequestURI must match server's host name. RequestURI must match server's host name.
If the value of this object is TRUE, then the server If the value of this object is TRUE, then the server
requires a match, and if the RequestURI doesn't match the requires a match, and if the RequestURI doesn't match the
server's host name, a 404 Not Found status code is server's host name, a 404 Not Found status code is
returned by the server. returned by the server.
If the value is FALSE, then no match is required." If the value is FALSE, then no match is required."
REFERENCE REFERENCE
"RFC 2543, Section 4.3" "RFC 2543, Section 4.3"
::= { sipCommonCfgEntry 9 }
Lingle/Maeng/Walker 14
::= { sipCommonCfgEntry 12 }
-- --
-- Support for multiple ports -- Support for multiple ports
-- --
sipPortTable OBJECT-TYPE sipPortTable OBJECT-TYPE
SYNTAX SEQUENCE OF SipPortEntry SYNTAX SEQUENCE OF SipPortEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table contains the list of ports that each SIP entity "This table contains the list of ports that each SIP entity
in this system is allowed to use. These ports can be in this system is allowed to use. These ports can be
advertised using the Contact header in a REGISTER request advertised using the Contact header in a REGISTER request
or response. The instances of SIP entities are uniquely or response. The instances of SIP entities are uniquely
identified by applIndex." identified by applIndex."
::= { sipCommonCfg 2 } ::= { sipCommonCfgBase 2 }
sipPortEntry OBJECT-TYPE sipPortEntry OBJECT-TYPE
SYNTAX SipPortEntry SYNTAX SipPortEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Specification of a particular port." "Specification of a particular port."
INDEX { applIndex, sipPort } INDEX { applIndex, sipPort }
::= { sipPortTable 1 } ::= { sipPortTable 1 }
SipPortEntry ::= SipPortEntry ::=
SEQUENCE { SEQUENCE {
sipPort INTEGER, sipPort INTEGER,
sipTransport INTEGER, sipTransportRcv SipTransportProtocol,
sipTransportSnd SipTransportProtocol,
sipPortStatus RowStatus sipPortStatus RowStatus
} }
sipPort OBJECT-TYPE sipPort OBJECT-TYPE
SYNTAX INTEGER (1..65535) SYNTAX INTEGER (1..65535)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object reflects a particular port that can be used by "This object reflects a particular port that can be used by
the SIP application." the SIP application."
::= { sipPortEntry 1 } ::= { sipPortEntry 1 }
sipTransport OBJECT-TYPE sipTransportRcv OBJECT-TYPE
SYNTAX INTEGER {
udp(1), Lingle/Maeng/Mule/Walker 16
tcp(2), SYNTAX SipTransportProtocol
udpAndTcp(3)
}
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object will specify the transport protocol the SIP "This object will specify the transport protocol the SIP
application will use to receive SIP messages. entity will use to receive SIP messages.
Lingle/Maeng/Walker 15 This object is a bit map. Each bit represents a transport
udp(1) : Use User Datagram Protocol. protocol. If a bit has value 1, then that transport protocol
tcp(2) : Use Transmission Control Protocol. is currently being used. If a bit has value 0, then that
udpAndTcp(3) : Use both UDP and TCP." transport protocol is currently not being used."
::= { sipPortEntry 2 } ::= { sipPortEntry 2 }
sipTransportSnd OBJECT-TYPE
SYNTAX SipTransportProtocol
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object will specify the transport protocol the SIP
entity will use to send SIP messages.
This object is a bit map. Each bit represents a transport
protocol. If a bit has value 1, then that transport protocol
is currently being used. If a bit has value 0, then that
transport protocol is currently not being used."
::= { sipPortEntry 3 }
sipPortStatus OBJECT-TYPE sipPortStatus OBJECT-TYPE
SYNTAX RowStatus SYNTAX RowStatus
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The row status of the entry. This object is required to "The row status of the entry. This object is required to
create or delete rows remotely by a manager. The row create or delete rows remotely by a manager. The row
associated with port 5060 need not be created and cannot associated with port 5060 need not be created and cannot
be deleted. It is always present in the table." be deleted. It is always present in the table."
::= { sipPortEntry 3 } ::= { sipPortEntry 4 }
-- --
-- Support for multiple non-SIP URIs -- Support for multiple non-SIP URI schemes
-- --
sipUriSupportedTable OBJECT-TYPE sipUriSupportedTable OBJECT-TYPE
SYNTAX SEQUENCE OF SipUriSupportedEntry SYNTAX SEQUENCE OF SipUriSupportedEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table contains a list of URIs supported by each SIP "This table contains a list of URI schemes supported by each
entity in this system. These are in addition to the SIP SIP entity in this system. These are in addition to the SIP
URL which must necessarily be supported. Normally the URL which must necessarily be supported. Normally the
list of URIs supported by an entity is static (i.e. will list of URI schemes supported by an entity is static
not change over time). (i.e. will not change over time).
A URI is a Uniform Resource Identifier (as defined in RFC A URI is a Uniform Resource Identifier (as defined in RFC
2396). 2396).
URIs could, for example, contain URLs for phones, fax, or URI schemes could, for example, contain URLs for phones, fax,
irc if they were defined) or a mailto: (RFC 2368) URL. or irc if they were defined) or a mailto: (RFC 2368) URL.
Lingle/Maeng/Mule/Walker 17
The instances of SIP entities are uniquely identified The instances of SIP entities are uniquely identified
by applIndex." by applIndex."
REFERENCE REFERENCE
"RFC 2543, Section 6.13" "RFC 2543, Section 6.13"
::= { sipCommonCfg 3 } ::= { sipCommonCfgBase 3 }
sipUriSupportedEntry OBJECT-TYPE sipUriSupportedEntry OBJECT-TYPE
SYNTAX SipUriSupportedEntry SYNTAX SipUriSupportedEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A particular non-SIP URI supported by the SIP entity." "A particular non-SIP URI supported by the SIP entity."
INDEX { applIndex, sipUriSupportedIndex } INDEX { applIndex, sipUriSupportedIndex }
::= { sipUriSupportedTable 1 } ::= { sipUriSupportedTable 1 }
SipUriSupportedEntry ::= SipUriSupportedEntry ::=
SEQUENCE { SEQUENCE {
Lingle/Maeng/Walker 16
sipUriSupportedIndex Unsigned32, sipUriSupportedIndex Unsigned32,
sipUriSupported SnmpAdminString sipUriSupported SnmpAdminString
} }
sipUriSupportedIndex OBJECT-TYPE sipUriSupportedIndex OBJECT-TYPE
SYNTAX Unsigned32 (1..4294967295) SYNTAX Unsigned32 (1..4294967295)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object uniquely identifies a conceptual row "This object uniquely identifies a conceptual row
in the table." in the table."
::= { sipUriSupportedEntry 1 } ::= { sipUriSupportedEntry 1 }
sipUriSupported OBJECT-TYPE sipUriSupported OBJECT-TYPE
SYNTAX SnmpAdminString SYNTAX SnmpAdminString
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object indicates a particular non-SIP URI supported "This object indicates a particular non-SIP URI scheme
by the SIP entity. Only the scheme itself (as described supported by the SIP entity. Only the scheme itself
in RFC 2396) is indicated. For example, if the mailto: (as described in RFC 2396) is indicated. For example,
URLs are supported,then the table entry contains 'mailto' if the mailto: URLs are supported, then the table entry
without the colon." contains 'mailto' without the colon."
REFERENCE REFERENCE
"RFC 2396 section 3" "RFC 2396 section 3"
::= { sipUriSupportedEntry 2 } ::= { sipUriSupportedEntry 2 }
-- --
-- Support for features which may be requested in Proxy-Require -- Support for features which may be requested in Proxy-Require
-- and Require headers -- and Require headers
-- --
sipFtrSupportedTable OBJECT-TYPE sipFtrSupportedTable OBJECT-TYPE
SYNTAX SEQUENCE OF SipFtrSupportedEntry SYNTAX SEQUENCE OF SipFtrSupportedEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table contains a list of the non-standard features "This table contains a list of the non-standard features
supported by each SIP entity in this system, and which supported by each SIP entity in this system, and which
may be required by a peer. Definition of such features is may be required by a peer. Definition of such features is
Lingle/Maeng/Mule/Walker 18
outside the scope of SIP, which only provides mechanisms outside the scope of SIP, which only provides mechanisms
whereby support for specific features may be signalled or whereby support for specific features may be signalled or
requested. requested.
For example, a user agent client may require that a server For example, a user agent client may require that a server
support the 'com.example.billing' feature, which it would support the 'com.example.billing' feature, which it would
indicate in a Require header. Such a client would have indicate in a Require header. Such a client would have
a row in its sipFtrSupportedTable containing the string a row in its sipFtrSupportedTable containing the string
'com.example.billing'. Similarly, a server which is 'com.example.billing'. Similarly, a server which is
capable of handling requests for such features would list capable of handling requests for such features would list
the string in its sipFtrSupportedTable. the string in its sipFtrSupportedTable.
If a server does not support the required feature If a server does not support the required feature
(indicated in a Require header to a UAS, or in a Proxy- (indicated in a Require header to a UAS, or in a Proxy-
Require to a proxy server), the server returns a 420 Bad Require to a proxy server), the server returns a 420 Bad
Lingle/Maeng/Walker 17
Extension listing the feature in an Unsupported header. Extension listing the feature in an Unsupported header.
Normally the list of such features supported by an entity Normally the list of such features supported by an entity
is static (i.e. will not change over time). is static (i.e. will not change over time).
The instances of SIP entities are uniquely identified The instances of SIP entities are uniquely identified
by applIndex." by applIndex."
REFERENCE REFERENCE
"RFC 2543, Sections 6.28, 6.30, and 6.38" "RFC 2543, Sections 6.28, 6.30, and 6.38"
::= { sipCommonCfg 4 } ::= { sipCommonCfgBase 4 }
sipFtrSupportedEntry OBJECT-TYPE sipFtrSupportedEntry OBJECT-TYPE
SYNTAX SipFtrSupportedEntry SYNTAX SipFtrSupportedEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A particular non-standard feature supported by the SIP "A particular non-standard feature supported by the SIP
entity, and which may be required by a peer." entity, and which may be required by a peer."
INDEX { applIndex, sipFtrSupportedIndex } INDEX { applIndex, sipFtrSupportedIndex }
::= { sipFtrSupportedTable 1 } ::= { sipFtrSupportedTable 1 }
skipping to change at line 980 skipping to change at line 1042
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object uniquely identifies a conceptual row in the "This object uniquely identifies a conceptual row in the
table." table."
::= { sipFtrSupportedEntry 1 } ::= { sipFtrSupportedEntry 1 }
sipFtrSupported OBJECT-TYPE sipFtrSupported OBJECT-TYPE
SYNTAX SnmpAdminString SYNTAX SnmpAdminString
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
Lingle/Maeng/Mule/Walker 19
DESCRIPTION DESCRIPTION
"This object indicates a particular non-standard feature "This object indicates a particular non-standard feature
which is supported by the SIP entity." which is supported by the SIP entity."
::= { sipFtrSupportedEntry 2 } ::= { sipFtrSupportedEntry 2 }
-- --
-- SIP Timer Configuration
--
sipCommonCfgTimerTable OBJECT-TYPE
SYNTAX SEQUENCE OF SipCommonCfgTimerEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table contains timer configuration objects applicable
to SIP user agent and SIP stateful proxy entities.
The instances of SIP entities are uniquely identified by
applIndex."
::= { sipCommonCfgTimer 1 }
sipCommonCfgTimerEntry OBJECT-TYPE
SYNTAX SipCommonCfgTimerEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A row of timer configuration."
INDEX { applIndex }
::= { sipCommonCfgTimerTable 1 }
SipCommonCfgTimerEntry ::=
SEQUENCE {
sipCfgInitialTimerInvite Unsigned32,
sipCfgTimerProv Unsigned32,
sipCfgInitialTimerAck Unsigned32,
sipCfgInitialTimerBye Unsigned32,
sipCfgInitialTimerRegister Unsigned32,
sipCfgInitialTimerOptions Unsigned32,
sipCfgInitialTimerInfo Unsigned32,
sipCfgInitialTimerRsp Unsigned32,
sipCfgTimerT2 Unsigned32
}
sipCfgInitialTimerInvite OBJECT-TYPE
SYNTAX Unsigned32 (100..1000)
UNITS "milliseconds"
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object specifies the initial value for the retransmit
timer for the INVITE method. The retransmit timer doubles
after each retransmission, ensuring an exponential backoff
in network traffic. This object represents the initial time
a SIP entity will wait to receive a provisional response to
an INVITE before resending the INVITE request."
DEFVAL { 500 }
::= { sipCommonCfgTimerEntry 1 }
Lingle/Maeng/Mule/Walker 20
sipCfgTimerProv OBJECT-TYPE
SYNTAX Unsigned32 (60000..300000)
UNITS "milliseconds"
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object specifies the maximum time a SIP entity will wait
to receive a final response to an INVITE. The timer is started
upon receipt of a provisional response."
DEFVAL { 60000 }
::= { sipCommonCfgTimerEntry 2 }
sipCfgInitialTimerAck OBJECT-TYPE
SYNTAX Unsigned32 (100..1000)
UNITS "milliseconds"
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object specifies the initial value for the retransmit
timer for the ACK method. The retransmit timer doubles
after each retransmission, ensuring an exponential backoff
in network traffic. This object represents the initial time
a SIP entity will wait to receive a response to an ACK."
DEFVAL { 500 }
::= { sipCommonCfgTimerEntry 3 }
sipCfgInitialTimerBye OBJECT-TYPE
SYNTAX Unsigned32 (100..1000)
UNITS "milliseconds"
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object specifies the initial value for the retransmit
timer for the BYE method. The retransmit timer doubles
after each retransmission, ensuring an exponential backoff
in network traffic. This object represents the initial time
a SIP entity will wait to receive a response to a BYE request."
DEFVAL { 500 }
::= { sipCommonCfgTimerEntry 4 }
sipCfgInitialTimerRegister OBJECT-TYPE
SYNTAX Unsigned32 (100..1000)
UNITS "milliseconds"
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object specifies the initial value for the retransmit
timer for the REGISTER method. The retransmit timer doubles
after each retransmission, ensuring an exponential backoff
in network traffic. This object represents the initial time
a SIP entity will wait to receive a response to a REGISTER
request."
DEFVAL { 500 }
::= { sipCommonCfgTimerEntry 5 }
sipCfgInitialTimerOptions OBJECT-TYPE
SYNTAX Unsigned32 (100..1000)
Lingle/Maeng/Mule/Walker 21
UNITS "milliseconds"
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object specifies the initial value for the retransmit
timer for the OPTIONS method. The retransmit timer doubles
after each retransmission, ensuring an exponential backoff
in network traffic. This object represents the initial time
a SIP entity will wait to receive a response to an OPTIONS
request."
DEFVAL { 500 }
::= { sipCommonCfgTimerEntry 6 }
sipCfgInitialTimerInfo OBJECT-TYPE
SYNTAX Unsigned32 (100..1000)
UNITS "milliseconds"
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object specifies the initial value for the retransmit
timer for the INFO method. The retransmit timer doubles
after each retransmission, ensuring an exponential backoff
in network traffic. This object represents the initial time
a SIP entity will wait to receive a response to a INFO request."
DEFVAL { 500 }
::= { sipCommonCfgTimerEntry 7 }
sipCfgInitialTimerRsp OBJECT-TYPE
SYNTAX Unsigned32 (100..1000)
UNITS "milliseconds"
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object specifies the initial value for the retransmit
timer for final responses. The retransmit timer doubles
after each retransmission, ensuring an exponential backoff
in network traffic. This object represents the initial time
a SIP entity will wait to retransmit a final response."
REFERENCE "Section 10.5.1 RFC2543"
DEFVAL { 500 }
::= { sipCommonCfgTimerEntry 8 }
sipCfgTimerT2 OBJECT-TYPE
SYNTAX Unsigned32 (200..10000)
UNITS "milliseconds"
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object specifies the T2 timer for a SIP entity."
REFERENCE "Section 10.4 and 10.5 RFC2543"
DEFVAL { 4000 }
::= { sipCommonCfgTimerEntry 9 }
Lingle/Maeng/Mule/Walker 22
--
-- Initial Timers Extensions: support for extension methods
--
sipCommonCfgTimerExtMethodTable OBJECT-TYPE
SYNTAX SEQUENCE OF SipCommonCfgTimerExtMethodEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table contains retransmit timers for each SIP
extension method this entity supports. The instances
of SIP entities are uniquely identified by applIndex.
The applicable T2 timer value for timers configured
in this table is that of the sipCfgTimerT2 object
with the same applIndex value."
::= { sipCommonCfgTimer 2 }
sipCommonCfgTimerExtMethodEntry OBJECT-TYPE
SYNTAX SipCommonCfgTimerExtMethodEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This row contains timer value information for
a particular extension method."
INDEX { applIndex, sipCommonCfgTimerExtMethodIndex }
::= { sipCommonCfgTimerExtMethodTable 1 }
SipCommonCfgTimerExtMethodEntry ::=
SEQUENCE {
sipCfgTimerExtMethodIndex Unsigned32,
sipCfgTimerExtMethodName SnmpAdminString,
sipCfgTimerExtMethodTimer Unsigned32,
sipCfgTimerExtMethodStatus RowStatus
}
sipCfgTimerExtMethodIndex OBJECT-TYPE
SYNTAX Unsigned32 (1..4294967295)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This object uniquely identifies a conceptual row in the
table."
::= { sipCommonCfgTimerExtMethodEntry 1 }
sipCfgTimerExtMethodName OBJECT-TYPE
SYNTAX SnmpAdminString
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object contains the name of the particular extension
method the SIP entity supports. For example, it may
contain the string 'REFER' if the REFER method is supported.
It is an error for any of the methods contained in RFC 2543
to be requested."
::= { sipCommonCfgTimerExtMethodEntry 2 }
sipCfgTimerExtMethodTimer OBJECT-TYPE
SYNTAX Unsigned32
Lingle/Maeng/Mule/Walker 23
UNITS "milliseconds"
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object specifies the time a SIP entity will wait
for a response to the extension method request before
retransmitting. The retransmit timer doubles after
each retransmission, ensuring an exponential backoff
in network traffic."
DEFVAL { 500 }
::= { sipCommonCfgTimerExtMethodEntry 3 }
sipCfgTimerExtMethodStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The row status of the entry. This object is required
to create or delete rows remotely by a manager.
A value for sipCfgTimerExtMethodName must be set
for row creation to be successful. If that method
already exists for a particular applIndex, the row
create operation will fail."
::= { sipCommonCfgTimerExtMethodEntry 4 }
--
-- SIP Retry Configuration
--
sipCommonCfgRetryTable OBJECT-TYPE
SYNTAX SEQUENCE OF SipCommonCfgRetryEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table contains retry configuration objects applicable
to SIP user agent and SIP proxies. The instances of
SIP entities are uniquely identified by applIndex."
::= { sipCommonCfgRetry 1 }
sipCommonCfgRetryEntry OBJECT-TYPE
SYNTAX SipCommonCfgRetryEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A row of retry configuration."
INDEX { applIndex }
::= { sipCommonCfgRetryTable 1 }
SipCommonCfgRetryEntry ::=
SEQUENCE {
sipCfgRetryInvite Unsigned32,
sipCfgRetryAck Unsigned32,
sipCfgRetryBye Unsigned32,
sipCfgRetryCancel Unsigned32,
sipCfgRetryRegister Unsigned32,
sipCfgRetryOptions Unsigned32,
Lingle/Maeng/Mule/Walker 24
sipCfgRetryInfo Unsigned32,
sipCfgRetryFinalResponse Unsigned32,
sipCfgRetryNonFinalResponse Unsigned32
}
sipCfgRetryInvite OBJECT-TYPE
SYNTAX Unsigned32 (1..10)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object will specify the number of times a SIP entity
will retry sending an INVITE request."
REFERENCE "Section 10.5 RFC 2543"
DEFVAL { 6 }
::= { sipCommonCfgRetryEntry 1 }
sipCfgRetryAck OBJECT-TYPE
SYNTAX Unsigned32(1..10)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object will specify the number of times a SIP entity
will retry sending an ACK request."
REFERENCE "Section 10.5 RFC 2543"
DEFVAL { 6 }
::= { sipCommonCfgRetryEntry 2 }
sipCfgRetryBye OBJECT-TYPE
SYNTAX Unsigned32 (1..10)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object will specify the number of times a SIP entity
will retry sending a BYE request."
REFERENCE "Section 10.4 RFC 2543"
DEFVAL { 6 }
::= { sipCommonCfgRetryEntry 3 }
sipCfgRetryCancel OBJECT-TYPE
SYNTAX Unsigned32 (1..10)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object will specify the number of times a SIP entity
will retry sending a CANCEL request."
REFERENCE "Section 10.4 RFC 2543"
DEFVAL { 6 }
::= { sipCommonCfgRetryEntry 4 }
sipCfgRetryRegister OBJECT-TYPE
SYNTAX Unsigned32 (1..10)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object will specify the number of times a SIP entity
will retry sending a REGISTER request."
REFERENCE "Section 10.4 RFC 2543"
Lingle/Maeng/Mule/Walker 25
DEFVAL { 6 }
::= { sipCommonCfgRetryEntry 5 }
sipCfgRetryOptions OBJECT-TYPE
SYNTAX Unsigned32 (1..10)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object will specify the number of times a SIP entity
will retry sending an OPTIONS request."
REFERENCE "Section 10.4 RFC2543"
DEFVAL { 6 }
::= { sipCommonCfgRetryEntry 6 }
sipCfgRetryInfo OBJECT-TYPE
SYNTAX Unsigned32 (1..10)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object will specify the number of times a SIP entity
will retry sending an INFO request."
REFERENCE "Section 2.4 RFC 2976"
DEFVAL { 6 }
::= { sipCommonCfgRetryEntry 7 }
sipCfgRetryFinalResponse OBJECT-TYPE
SYNTAX Unsigned32 (1..10)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object will specify the number of times a SIP entity
will retry sending a final response and expecting an ACK."
DEFVAL { 6 }
::= { sipCommonCfgRetryEntry 8 }
sipCfgRetryNonFinalResponse OBJECT-TYPE
SYNTAX Unsigned32 (1..10)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object will specify the number of times a SIP entity
will retry sending a non-final response."
DEFVAL { 6 }
::= { sipCommonCfgRetryEntry 9 }
--
-- Retry Extensions: support for extension methods
--
sipCommonCfgRetryExtMethodTable OBJECT-TYPE
SYNTAX SEQUENCE OF SipCommonCfgRetryExtMethodEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table contains retry configuration for each SIP
extension method this entity supports. The instances
Lingle/Maeng/Mule/Walker 26
of SIP entities are uniquely identified by applIndex."
::= { sipCommonCfgTimer 3 }
sipCommonCfgRetryExtMethodEntry OBJECT-TYPE
SYNTAX SipCommonCfgRetryExtMethodEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This row contains retry configuration information for
a particular extension method."
INDEX { applIndex, sipCommonCfgRetryExtMethodIndex }
::= { sipCommonCfgRetryExtMethodTable 1 }
SipCommonCfgRetryExtMethodEntry ::=
SEQUENCE {
sipCfgRetryExtMethodIndex Unsigned32,
sipCfgRetryExtMethodName SnmpAdminString,
sipCfgRetryExtMethodRetry Unsigned32,
sipCfgRetryExtMethodStatus RowStatus
}
sipCfgRetryExtMethodIndex OBJECT-TYPE
SYNTAX Unsigned32 (1..4294967295)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This object uniquely identifies a conceptual row in the
table."
::= { sipCommonCfgRetryExtMethodEntry 1 }
sipCfgRetryExtMethodName OBJECT-TYPE
SYNTAX SnmpAdminString
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object contains the name of the particular extension
method the SIP entity supports. For example, it may
contain the string 'REFER' if the REFER method is supported.
It is an error for any of the methods contained in RFC 2543
to be requested."
::= { sipCommonCfgRetryExtMethodEntry 2 }
sipCfgRetryExtMethodRetry OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object specifies the number of times a SIP entity
will retry sending its request for this particular
extension method."
DEFVAL { 6 }
::= { sipCommonCfgRetryExtMethodEntry 3 }
sipCfgRetryExtMethodStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
Lingle/Maeng/Mule/Walker 27
DESCRIPTION
"The row status of the entry. This object is required
to create or delete rows remotely by a manager.
A value for sipCfgRetryExtMethodName must be set
for row creation to be successful. If that method
already exists for a particular applIndex, the row
create operation will fail."
::= { sipCommonCfgRetryExtMethodEntry 4 }
--
-- Common Statistics Objects -- Common Statistics Objects
-- --
-- --
-- Summary Statistics -- Summary Statistics
-- --
Lingle/Maeng/Walker 18
sipSummaryStatsTable OBJECT-TYPE sipSummaryStatsTable OBJECT-TYPE
SYNTAX SEQUENCE OF SipSummaryStatsEntry SYNTAX SEQUENCE OF SipSummaryStatsEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table contains the summary statistics objects "This table contains the summary statistics objects
applicable to all SIP entities. Each row represents applicable to all SIP entities. Each row represents
those objects for a particular SIP entity present in those objects for a particular SIP entity present in
this system. The instances of SIP entities are uniquely this system. The instances of SIP entities are uniquely
identified by applIndex." identified by applIndex."
skipping to change at line 1034 skipping to change at line 1562
sipSummaryInRequests OBJECT-TYPE sipSummaryInRequests OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object indicates the total number of SIP request "This object indicates the total number of SIP request
messages received by the SIP entity including messages received by the SIP entity including
retransmissions." retransmissions."
::= { sipSummaryStatsEntry 1 } ::= { sipSummaryStatsEntry 1 }
Lingle/Maeng/Mule/Walker 28
sipSummaryOutRequests OBJECT-TYPE sipSummaryOutRequests OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object contains the total number of SIP request "This object contains the total number of SIP request
messages sent out (originated and relayed) by the SIP messages sent out (originated and relayed) by the SIP
entity. Where a particular message is sent more than entity. Where a particular message is sent more than
once, for example as a retransmission, or as a result of once, for example as a retransmission, or as a result of
forking, each transmission is counted separately." forking, each transmission is counted separately."
::= { sipSummaryStatsEntry 2 } ::= { sipSummaryStatsEntry 2 }
sipSummaryInResponses OBJECT-TYPE sipSummaryInResponses OBJECT-TYPE
Lingle/Maeng/Walker 19
SYNTAX Counter32 SYNTAX Counter32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object contains the total number of SIP response "This object contains the total number of SIP response
messages received by the SIP entity including messages received by the SIP entity including
retransmissions." retransmissions."
::= { sipSummaryStatsEntry 3 } ::= { sipSummaryStatsEntry 3 }
sipSummaryOutResponses OBJECT-TYPE sipSummaryOutResponses OBJECT-TYPE
skipping to change at line 1091 skipping to change at line 1618
A transaction is identified by the CSeq sequence number A transaction is identified by the CSeq sequence number
within a single call leg. The ACK request has the same within a single call leg. The ACK request has the same
CSeq number as the corresponding INVITE request, but CSeq number as the corresponding INVITE request, but
comprises a transaction of its own. comprises a transaction of its own.
In the case of a forked request, all branches count as a In the case of a forked request, all branches count as a
single transaction." single transaction."
::= { sipSummaryStatsEntry 5 } ::= { sipSummaryStatsEntry 5 }
-- --
Lingle/Maeng/Mule/Walker 29
-- SIP Method Statistics -- SIP Method Statistics
-- Total counts for each SIP method. -- Total counts for each SIP method.
-- --
sipMethodStatsTable OBJECT-TYPE sipMethodStatsTable OBJECT-TYPE
SYNTAX SEQUENCE OF SipMethodStatsEntry SYNTAX SEQUENCE OF SipMethodStatsEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table contains the per method statistics objects "This table contains the per method statistics objects
applicable to all SIP entities. Each row represents applicable to all SIP entities. Each row represents
those objects for a particular SIP entity present in those objects for a particular SIP entity present in
Lingle/Maeng/Walker 20
this system. The instances of SIP entities are uniquely this system. The instances of SIP entities are uniquely
identified by applIndex." identified by applIndex."
::= { sipCommonStatsMethod 1 } ::= { sipCommonStatsMethod 1 }
sipMethodStatsEntry OBJECT-TYPE sipMethodStatsEntry OBJECT-TYPE
SYNTAX SipMethodStatsEntry SYNTAX SipMethodStatsEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A row of per method statistics." "A row of per method statistics."
skipping to change at line 1130 skipping to change at line 1657
sipStatsInviteOuts Counter32, sipStatsInviteOuts Counter32,
sipStatsAckIns Counter32, sipStatsAckIns Counter32,
sipStatsAckOuts Counter32, sipStatsAckOuts Counter32,
sipStatsByeIns Counter32, sipStatsByeIns Counter32,
sipStatsByeOuts Counter32, sipStatsByeOuts Counter32,
sipStatsCancelIns Counter32, sipStatsCancelIns Counter32,
sipStatsCancelOuts Counter32, sipStatsCancelOuts Counter32,
sipStatsOptionsIns Counter32, sipStatsOptionsIns Counter32,
sipStatsOptionsOuts Counter32, sipStatsOptionsOuts Counter32,
sipStatsRegisterIns Counter32, sipStatsRegisterIns Counter32,
sipStatsRegisterOuts Counter32 sipStatsRegisterOuts Counter32,
sipStatsInfoIns Counter32,
sipStatsInfoOuts Counter32
} }
sipStatsInviteIns OBJECT-TYPE sipStatsInviteIns OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object reflects the total number of INVITE requests "This object reflects the total number of INVITE requests
received by the SIP entity." received by the SIP entity."
REFERENCE REFERENCE
"RFC 2543, Section 4.2.1" "RFC 2543, Section 4.2.1"
::= { sipMethodStatsEntry 1 } ::= { sipMethodStatsEntry 1 }
sipStatsInviteOuts OBJECT-TYPE sipStatsInviteOuts OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
Lingle/Maeng/Mule/Walker 30
DESCRIPTION DESCRIPTION
"This object reflects the total number of INVITE requests "This object reflects the total number of INVITE requests
sent by the SIP entity." sent by the SIP entity."
REFERENCE REFERENCE
"RFC 2543, Section 4.2.1" "RFC 2543, Section 4.2.1"
::= { sipMethodStatsEntry 2 } ::= { sipMethodStatsEntry 2 }
sipStatsAckIns OBJECT-TYPE sipStatsAckIns OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
MAX-ACCESS read-only MAX-ACCESS read-only
Lingle/Maeng/Walker 21
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object reflects the total number of ACK requests "This object reflects the total number of ACK requests
received by the SIP entity." received by the SIP entity."
REFERENCE REFERENCE
"RFC 2543, Section 4.2.2" "RFC 2543, Section 4.2.2"
::= { sipMethodStatsEntry 3 } ::= { sipMethodStatsEntry 3 }
sipStatsAckOuts OBJECT-TYPE sipStatsAckOuts OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
skipping to change at line 1207 skipping to change at line 1736
REFERENCE REFERENCE
"RFC 2543, Section 4.2.4" "RFC 2543, Section 4.2.4"
::= { sipMethodStatsEntry 6 } ::= { sipMethodStatsEntry 6 }
sipStatsCancelIns OBJECT-TYPE sipStatsCancelIns OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object reflects the total number of CANCEL requests "This object reflects the total number of CANCEL requests
Lingle/Maeng/Mule/Walker 31
received by the SIP entity." received by the SIP entity."
REFERENCE REFERENCE
"RFC 2543, Section 4.2.5" "RFC 2543, Section 4.2.5"
::= { sipMethodStatsEntry 7 } ::= { sipMethodStatsEntry 7 }
sipStatsCancelOuts OBJECT-TYPE sipStatsCancelOuts OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
Lingle/Maeng/Walker 22
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object reflects the total number of CANCEL requests "This object reflects the total number of CANCEL requests
sent by the SIP entity." sent by the SIP entity."
REFERENCE REFERENCE
"RFC 2543, Section 4.2.5" "RFC 2543, Section 4.2.5"
::= { sipMethodStatsEntry 8 } ::= { sipMethodStatsEntry 8 }
sipStatsOptionsIns OBJECT-TYPE sipStatsOptionsIns OBJECT-TYPE
skipping to change at line 1266 skipping to change at line 1795
::= { sipMethodStatsEntry 11 } ::= { sipMethodStatsEntry 11 }
sipStatsRegisterOuts OBJECT-TYPE sipStatsRegisterOuts OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object reflects the total number of REGISTER requests "This object reflects the total number of REGISTER requests
sent by the SIP entity." sent by the SIP entity."
REFERENCE REFERENCE
Lingle/Maeng/Mule/Walker 32
"RFC 2543, Section 4.2.6" "RFC 2543, Section 4.2.6"
::= { sipMethodStatsEntry 12 } ::= { sipMethodStatsEntry 12 }
-- sipStatsInfoIns OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object reflects the total number of INFO requests
received by the SIP entity."
REFERENCE
"RFC 2976"
::= { sipMethodStatsEntry 13 }
Lingle/Maeng/Walker 23 sipStatsInfoOuts OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object reflects the total number of INFO requests
sent by the SIP entity."
REFERENCE
"RFC 2976"
::= { sipMethodStatsEntry 14 }
--
-- support for extension methods -- support for extension methods
-- --
sipStatsExtMethodTable OBJECT-TYPE sipStatsExtMethodTable OBJECT-TYPE
SYNTAX SEQUENCE OF SipStatsExtMethodEntry SYNTAX SEQUENCE OF SipStatsExtMethodEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table contains the list of extension methods which "This table contains the list of extension methods which
each SIP entity in this system has been requested to each SIP entity in this system has been requested to
skipping to change at line 1303 skipping to change at line 1854
INDEX { applIndex, sipStatsExtMethodIndex } INDEX { applIndex, sipStatsExtMethodIndex }
::= { sipStatsExtMethodTable 1 } ::= { sipStatsExtMethodTable 1 }
SipStatsExtMethodEntry ::= SipStatsExtMethodEntry ::=
SEQUENCE { SEQUENCE {
sipStatsExtMethodIndex Unsigned32, sipStatsExtMethodIndex Unsigned32,
sipStatsExtMethodName SnmpAdminString, sipStatsExtMethodName SnmpAdminString,
sipStatsExtMethodIns Counter32, sipStatsExtMethodIns Counter32,
sipStatsExtMethodOuts Counter32, sipStatsExtMethodOuts Counter32,
sipStatsExtMethodStatus RowStatus sipStatsExtMethodStatus RowStatus
Lingle/Maeng/Mule/Walker 33
} }
sipStatsExtMethodIndex OBJECT-TYPE sipStatsExtMethodIndex OBJECT-TYPE
SYNTAX Unsigned32 (1..4294967295) SYNTAX Unsigned32 (1..4294967295)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object uniquely identifies a conceptual row in the "This object uniquely identifies a conceptual row in the
table." table."
::= { sipStatsExtMethodEntry 1 } ::= { sipStatsExtMethodEntry 1 }
sipStatsExtMethodName OBJECT-TYPE sipStatsExtMethodName OBJECT-TYPE
SYNTAX SnmpAdminString SYNTAX SnmpAdminString
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object contains the name of the particular extension "This object contains the name of the particular extension
method that the SIP entity has been requested to monitor. method that the SIP entity has been requested to monitor.
For example, it may contain the string 'INFO' if the For example, it may contain the string 'REFER' if the
network management station has requested that the SIP network management station has requested that the SIP
entity count the number of messages sent an received entity count the number of messages sent an received
which containing an INFO method. It is an error for any which containing a REFER method. It is an error for any
of the methods contained in RFC 2543 to be requested." of the methods contained in RFC 2543 to be requested."
Lingle/Maeng/Walker 24
::= { sipStatsExtMethodEntry 2 } ::= { sipStatsExtMethodEntry 2 }
sipStatsExtMethodIns OBJECT-TYPE sipStatsExtMethodIns OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object reflects the total number of requests received "This object reflects the total number of requests received
by the SIP entity which requested the method contained in by the SIP entity which requested the method contained in
the sipStatsExtMethodName column." the sipStatsExtMethodName column."
skipping to change at line 1361 skipping to change at line 1912
SYNTAX RowStatus SYNTAX RowStatus
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The row status of the entry. This object is required "The row status of the entry. This object is required
to create or delete rows remotely by a manager." to create or delete rows remotely by a manager."
::= { sipStatsExtMethodEntry 5 } ::= { sipStatsExtMethodEntry 5 }
-- --
-- SIP Response Status Codes -- SIP Response Status Codes
Lingle/Maeng/Mule/Walker 34
-- --
sipStatusCodesTable OBJECT-TYPE sipStatusCodesTable OBJECT-TYPE
SYNTAX SEQUENCE OF SipStatusCodesEntry SYNTAX SEQUENCE OF SipStatusCodesEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table contains statistics on response status code "This table contains statistics on response status code
classes for each SIP entity in this system. The instances classes for each SIP entity in this system. The instances
of SIP entities are uniquely identified by applIndex." of SIP entities are uniquely identified by applIndex."
::= { sipCommonStatusCode 1 } ::= { sipCommonStatusCode 1 }
sipStatusCodesEntry OBJECT-TYPE sipStatusCodesEntry OBJECT-TYPE
SYNTAX SipStatusCodesEntry SYNTAX SipStatusCodesEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This row contains statistics on response status codes." "This row contains statistics on response status codes."
INDEX { applIndex } INDEX { applIndex }
::= { sipStatusCodesTable 1 } ::= { sipStatusCodesTable 1 }
Lingle/Maeng/Walker 25
SipStatusCodesEntry ::= SipStatusCodesEntry ::=
SEQUENCE { SEQUENCE {
sipStatsInfoClassIns Counter32, sipStatsInfoClassIns Counter32,
sipStatsInfoClassOuts Counter32, sipStatsInfoClassOuts Counter32,
sipStatsSuccessClassIns Counter32, sipStatsSuccessClassIns Counter32,
sipStatsSuccessClassOuts Counter32, sipStatsSuccessClassOuts Counter32,
sipStatsRedirClassIns Counter32, sipStatsRedirClassIns Counter32,
sipStatsRedirClassOuts Counter32, sipStatsRedirClassOuts Counter32,
sipStatsReqFailClassIns Counter32, sipStatsReqFailClassIns Counter32,
sipStatsReqFailClassOuts Counter32, sipStatsReqFailClassOuts Counter32,
skipping to change at line 1419 skipping to change at line 1971
"RFC 2543, Sections 5.1.1 & 7.1" "RFC 2543, Sections 5.1.1 & 7.1"
::= { sipStatusCodesEntry 1 } ::= { sipStatusCodesEntry 1 }
sipStatsInfoClassOuts OBJECT-TYPE sipStatsInfoClassOuts OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object reflects the number of 1xx class "This object reflects the number of 1xx class
SIP responses sent by the SIP entity. SIP responses sent by the SIP entity.
Lingle/Maeng/Mule/Walker 35
This class of responses relates to providing some This class of responses relates to providing some
information concerning the progress of processing information concerning the progress of processing
a SIP request." a SIP request."
REFERENCE REFERENCE
"RFC 2543, Sections 5.1.1 & 7.1" "RFC 2543, Sections 5.1.1 & 7.1"
::= { sipStatusCodesEntry 2 } ::= { sipStatusCodesEntry 2 }
sipStatsSuccessClassIns OBJECT-TYPE sipStatsSuccessClassIns OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object reflects the number of 2xx class SIP "This object reflects the number of 2xx class SIP
responses received by the SIP entity. This class of responses received by the SIP entity. This class of
responses relate to successful completion of a SIP responses relate to successful completion of a SIP
request." request."
REFERENCE REFERENCE
Lingle/Maeng/Walker 26
"RFC 2543, Sections 5.1.1 & 7.2" "RFC 2543, Sections 5.1.1 & 7.2"
::= { sipStatusCodesEntry 3 } ::= { sipStatusCodesEntry 3 }
sipStatsSuccessClassOuts OBJECT-TYPE sipStatsSuccessClassOuts OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object reflects the number of 2xx class SIP "This object reflects the number of 2xx class SIP
responses sent by the SIP entity. This class of responses sent by the SIP entity. This class of
skipping to change at line 1478 skipping to change at line 2030
SYNTAX Counter32 SYNTAX Counter32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object reflects the number of 3xx class SIP "This object reflects the number of 3xx class SIP
responses sent by the SIP entity. This class of responses sent by the SIP entity. This class of
responses relate to call redirection actions taken responses relate to call redirection actions taken
by a Redirect Server." by a Redirect Server."
REFERENCE REFERENCE
"RFC 2543, Sections 5.1.1 & 7.3" "RFC 2543, Sections 5.1.1 & 7.3"
Lingle/Maeng/Mule/Walker 36
::= { sipStatusCodesEntry 6 } ::= { sipStatusCodesEntry 6 }
sipStatsReqFailClassIns OBJECT-TYPE sipStatsReqFailClassIns OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object reflects the number of 4xx class SIP "This object reflects the number of 4xx class SIP
responses received by the SIP entity. This class of responses received by the SIP entity. This class of
responses reflect request failure by a SIP entity responses reflect request failure by a SIP entity
providing a client function." providing a client function."
REFERENCE REFERENCE
"RFC 2543, Sections 5.1.1 & 7.4" "RFC 2543, Sections 5.1.1 & 7.4"
::= { sipStatusCodesEntry 7 } ::= { sipStatusCodesEntry 7 }
Lingle/Maeng/Walker 27
sipStatsReqFailClassOuts OBJECT-TYPE sipStatsReqFailClassOuts OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object reflects the number of 4xx class SIP "This object reflects the number of 4xx class SIP
responses sent by the SIP entity. This class of responses sent by the SIP entity. This class of
responses reflect request failure by a SIP entity responses reflect request failure by a SIP entity
providing a server function." providing a server function."
REFERENCE REFERENCE
skipping to change at line 1536 skipping to change at line 2089
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object reflects the number of 5xx class SIP "This object reflects the number of 5xx class SIP
responses sent by the SIP entity. This class of responses sent by the SIP entity. This class of
responses reflect failure responses sent by a SIP responses reflect failure responses sent by a SIP
entity providing a server function. These entity providing a server function. These
responses are not definite failures and must not responses are not definite failures and must not
terminate a search if other possible locations remain terminate a search if other possible locations remain
untried." untried."
REFERENCE REFERENCE
Lingle/Maeng/Mule/Walker 37
"RFC 2543, Sections 5.1.1 & 7.5" "RFC 2543, Sections 5.1.1 & 7.5"
::= { sipStatusCodesEntry 10 } ::= { sipStatusCodesEntry 10 }
sipStatsGlobalFailClassIns OBJECT-TYPE sipStatsGlobalFailClassIns OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object reflects the number of 6xx class SIP "This object reflects the number of 6xx class SIP
responses received by the SIP entity. This class of responses received by the SIP entity. This class of
responses reflect failure responses received by a responses reflect failure responses received by a
Lingle/Maeng/Walker 28
SIP entity providing a client function. SIP entity providing a client function.
The responses generally indicate that a server has The responses generally indicate that a server has
definitive information about a particular called party, definitive information about a particular called party,
not just the particular instance indicated in the not just the particular instance indicated in the
Request-URI. All further searches for this user are Request-URI. All further searches for this user are
doomed to failure and pending searches should be doomed to failure and pending searches should be
terminated." terminated."
REFERENCE REFERENCE
"RFC 2543, Sections 5.1.1 & 7.6" "RFC 2543, Sections 5.1.1 & 7.6"
skipping to change at line 1584 skipping to change at line 2137
Request-URI. All further searches for this user are Request-URI. All further searches for this user are
doomed to failure and pending searches should be doomed to failure and pending searches should be
terminated." terminated."
REFERENCE REFERENCE
"RFC 2543, Sections 5.1.1 & 7.6" "RFC 2543, Sections 5.1.1 & 7.6"
::= { sipStatusCodesEntry 12 } ::= { sipStatusCodesEntry 12 }
-- --
-- support for specific status codes -- support for specific status codes
-- --
sipCommonStatusCodeTable OBJECT-TYPE sipCommonStatusCodeTable OBJECT-TYPE
SYNTAX SEQUENCE OF SipCommonStatusCodeEntry SYNTAX SEQUENCE OF SipCommonStatusCodeEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table contains the list of SIP status codes which "This table contains the list of SIP status codes which
each SIP entity in this system has been requested to each SIP entity in this system has been requested to
monitor. The instances of SIP entities are uniquely monitor. It is the mechanism by which specific status
identified by applIndex." codes are monitored. The instances of SIP entities are
uniquely identified by applIndex."
::= { sipCommonStatusCode 2 } ::= { sipCommonStatusCode 2 }
Lingle/Maeng/Mule/Walker 38
sipCommonStatusCodeEntry OBJECT-TYPE sipCommonStatusCodeEntry OBJECT-TYPE
SYNTAX SipCommonStatusCodeEntry SYNTAX SipCommonStatusCodeEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This row contains information on a particular SIP status "This row contains information on a particular SIP status
code that the SIP entity has been requested to monitor." code that the SIP entity has been requested to monitor."
Lingle/Maeng/Walker 29
INDEX { applIndex, sipCommonStatusCodeValue } INDEX { applIndex, sipCommonStatusCodeValue }
::= { sipCommonStatusCodeTable 1 } ::= { sipCommonStatusCodeTable 1 }
SipCommonStatusCodeEntry ::= SipCommonStatusCodeEntry ::=
SEQUENCE { SEQUENCE {
sipCommonStatusCodeValue INTEGER, sipCommonStatusCodeValue INTEGER,
sipCommonStatusCodeIns Counter32, sipCommonStatusCodeIns Counter32,
sipCommonStatusCodeOuts Counter32, sipCommonStatusCodeOuts Counter32,
sipCommonStatusCodeSendNotif TruthValue,
sipCommonStatusCodeStatus RowStatus sipCommonStatusCodeStatus RowStatus
} }
sipCommonStatusCodeValue OBJECT-TYPE sipCommonStatusCodeValue OBJECT-TYPE
SYNTAX INTEGER (100..999) SYNTAX INTEGER (100..999)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object contains a SIP status code value that the SIP "This object contains a SIP status code value that the SIP
entity has been requested to monitor. All of the other entity has been requested to monitor. All of the other
skipping to change at line 1647 skipping to change at line 2198
sipCommonStatusCodeOuts OBJECT-TYPE sipCommonStatusCodeOuts OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object reflects the total number of response messages "This object reflects the total number of response messages
sent by the SIP entity with the status code value sent by the SIP entity with the status code value
contained in the sipCommonStatusCodeValue column." contained in the sipCommonStatusCodeValue column."
::= { sipCommonStatusCodeEntry 3 } ::= { sipCommonStatusCodeEntry 3 }
sipCommonStatusCodeSendNotif OBJECT-TYPE sipCommonStatusCodeStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The row augmentation in sipCommonStatusCodeNotifTable
will be governed by the value of this RowStatus.This
object is required to create or delete rows remotely
Lingle/Maeng/Mule/Walker 39
by a manager.
If set to 'notInService', all counters values may be
reset to zero and any associated notifications will be
disabled. Associated notifications are specified in the
sipCommonStatusCodeNotifTable.
The configuration specified by an entry will be made
active when this object is set to 'active'."
::= { sipCommonStatusCodeEntry 4 }
--
-- support for specific status code notifications
--
sipCommonStatusCodeNotifTable OBJECT-TYPE
SYNTAX SEQUENCE OF SipCommonStatusCodeNotifEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table contains objects to control notifications
related to particular status codes each SIP entity in
this system has been requested to monitor.
There is an entry in this table corresponding to each
entry in sipCommonStatusCodeTable. Therefore, this
table augments that table and utilizes the same index
methodology."
::= { sipCommonStatusCode 3 }
sipCommonStatusCodeNotifEntry OBJECT-TYPE
SYNTAX SipCommonStatusCodeNotifEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This row contains information controlling notifications
for a particular SIP status code that the SIP entity has
been requested to monitor."
AUGMENTS { sipCommonStatusCodeEntry }
::= { sipCommonStatusCodeNotifTable 1 }
SipCommonStatusCodeNotifEntry ::=
SEQUENCE {
sipCommonStatusCodeNotifSend TruthValue,
sipCommonStatusCodeNotifEmitMode INTEGER,
sipCommonStatusCodeNotifThresh Unsigned32,
sipCommonStatusCodeNotifInterval TimeTicks
}
sipCommonStatusCodeNotifSend OBJECT-TYPE
SYNTAX TruthValue SYNTAX TruthValue
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object controls whether a notification is sent when "This object controls whether a sipStatusCodeNotif
the status code value specified in the is emitted when the status code value specified in
sipCommonStatusCodeValue column is sent or received. by sipCommonStatusCodeValue is sent or received.
If the value of this object is TRUE, then a notification If the value of this object is TRUE, then a notification
is sent. If it is FALSE, no notification is sent."
Lingle/Maeng/Mule/Walker 40
is sent. If it is FALSE, no notification is sent.
Note well, that a notification may be emitted for
every msg sent or received that contains the particular
status code. Depending on the status code involved,
this can cause a significant number of notification
emissions that could be detrimental to network performance.
Managers are forewarned to be prudent in the use of
this object to enable notifications. Look to
sipCommonStatusCodeNotifEmitMode for alternative
controls for sipStatusCodeNotif emissions."
DEFVAL { false } DEFVAL { false }
::= { sipCommonStatusCodeEntry 4 } ::= { sipCommonStatusCodeNotifEntry 1 }
Lingle/Maeng/Walker 30 sipCommonStatusCodeNotifEmitMode OBJECT-TYPE
sipCommonStatusCodeStatus OBJECT-TYPE SYNTAX INTEGER {
SYNTAX RowStatus normal(1),
oneShot(2),
triggered(3) -- read-only
}
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The row status of the entry. This object is required "The object sipCommonStatusCodeNotifSend must be set
to create or delete rows remotely by a manager." to TRUE for the values of this object to have any
::= { sipCommonStatusCodeEntry 5 } effect. It is recommended that the desired emit mode
be established by this object prior to setting
sipCommonStatusCodeNotifSend to TRUE.
This object specifies the mode for emissions of
sipStatusCodeNotif notifications.
normal : sipStatusCodeNotif notifications will
be emitted by the system for each
SIP response messages sent or received
that contains the desired status code.
oneShot : Only one sipStatusCodeNotif notification
will be emitted. It will be the next
SIP response messages sent or received
that contains the desired status code.
No more notifs are emitted until this
object is set to either 'oneShot' again
or 'normal'. This option is provided
as a means of quelling the potential
promiscuous behavior that can be associated
with the sipStatusCodeNotif.
triggered : This value is only readable and cannot be
set. It reflects when the 'oneShot' has
occurred and indicates the mode needs to
be reset to get further notifications.
The mode is reset by setting this object
to 'oneShot' or 'normal'."
DEFVAL { normal }
::= { sipCommonStatusCodeNotifEntry 2 }
sipCommonStatusCodeNotifThresh OBJECT-TYPE
SYNTAX Unsigned32
Lingle/Maeng/Mule/Walker 41
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object specifies the number of response messages
sent or received by this system that are considered
excessive. Based on crossing that threshold, a
sipStatusCodeExceededNotif notification will be sent.
The sipStatusCodeExceededNotif can be used as an
early warning mechanism in lieu of using sipStatusCodeNotif."
DEFVAL { 500 }
::= { sipCommonStatusCodeNotifEntry 3 }
sipCommonStatusCodeNotifInterval OBJECT-TYPE
SYNTAX TimeTicks
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object specifies the time interval over which
if sipCommonStatusCodeThresh is exceeded a
sipCommonStatusCodeThresh notification will be sent."
DEFVAL { 6000 } -- 60 seconds
::= { sipCommonStatusCodeNotifEntry 4 }
--
-- support for status code notification attributes.
--
sipStatusCodeNotifTo OBJECT-TYPE
SYNTAX SnmpAdminString
MAX-ACCESS accessible-for-notify
STATUS current
DESCRIPTION
"This object contains the value of the To header in the
message containing the status code that caused the
notification."
::= { sipCommonStatusCode 4 }
sipStatusCodeNotifFrom OBJECT-TYPE
SYNTAX SnmpAdminString
MAX-ACCESS accessible-for-notify
STATUS current
DESCRIPTION
"This object contains the value of the From header in the
message containing the status code that caused the
notification."
::= { sipCommonStatusCode 5 }
sipStatusCodeNotifCallId OBJECT-TYPE
SYNTAX SnmpAdminString
MAX-ACCESS accessible-for-notify
STATUS current
DESCRIPTION
"This object contains the value of the CallId in the
message containing the status code that caused the
notification."
::= { sipCommonStatusCode 6 }
sipStatusCodeNotifCSeq OBJECT-TYPE
Lingle/Maeng/Mule/Walker 42
SYNTAX Unsigned32
MAX-ACCESS accessible-for-notify
STATUS current
DESCRIPTION
"This object contains the CSeq value in the message
containing the status code that caused the notification."
::= { sipCommonStatusCode 7 }
-- --
-- Transaction Statistics -- Transaction Statistics
-- --
sipCurrentTransTable OBJECT-TYPE sipCurrentTransTable OBJECT-TYPE
SYNTAX SEQUENCE OF SipCurrentTransEntry SYNTAX SEQUENCE OF SipCurrentTransEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table contains information on the transactions "This table contains information on the transactions
skipping to change at line 1712 skipping to change at line 2435
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object contains the number of transactions awaiting "This object contains the number of transactions awaiting
definitive (non-1xx) response. In the case of a forked definitive (non-1xx) response. In the case of a forked
request, all branches count as a single transaction. The request, all branches count as a single transaction. The
value of this object will reflect the number of rows in value of this object will reflect the number of rows in
sipTransactionTable." sipTransactionTable."
::= { sipCurrentTransEntry 1 } ::= { sipCurrentTransEntry 1 }
sipTransactionTable OBJECT-TYPE sipTransactionTable OBJECT-TYPE
Lingle/Maeng/Walker 31
SYNTAX SEQUENCE OF SipTransactionEntry SYNTAX SEQUENCE OF SipTransactionEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table contains information on all of the transactions "This table contains information on all of the transactions
Lingle/Maeng/Mule/Walker 43
currently being processed (the count of such transactions currently being processed (the count of such transactions
is maintained in the sipCurrentTransactions object) by a is maintained in the sipCurrentTransactions object) by a
particular SIP entity in this system. The instances of SIP particular SIP entity in this system. The instances of SIP
entities are uniquely identified by applIndex." entities are uniquely identified by applIndex."
::= { sipCommonStatsTrans 2 } ::= { sipCommonStatsTrans 2 }
sipTransactionEntry OBJECT-TYPE sipTransactionEntry OBJECT-TYPE
SYNTAX SipTransactionEntry SYNTAX SipTransactionEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
skipping to change at line 1768 skipping to change at line 2491
SYNTAX SnmpAdminString SYNTAX SnmpAdminString
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object contains the value of the To header in request "This object contains the value of the To header in request
message." message."
::= { sipTransactionEntry 2 } ::= { sipTransactionEntry 2 }
sipTransFrom OBJECT-TYPE sipTransFrom OBJECT-TYPE
SYNTAX SnmpAdminString SYNTAX SnmpAdminString
Lingle/Maeng/Walker 32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object contains the value of the From header in the "This object contains the value of the From header in the
request message." request message."
::= { sipTransactionEntry 3 } ::= { sipTransactionEntry 3 }
sipTransCallId OBJECT-TYPE sipTransCallId OBJECT-TYPE
Lingle/Maeng/Mule/Walker 44
SYNTAX SnmpAdminString SYNTAX SnmpAdminString
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object contains the value of the CallId value in the "This object contains the value of the CallId value in the
request message." request message."
::= { sipTransactionEntry 4 } ::= { sipTransactionEntry 4 }
sipTransCSeq OBJECT-TYPE sipTransCSeq OBJECT-TYPE
SYNTAX Unsigned32 SYNTAX Unsigned32
skipping to change at line 1824 skipping to change at line 2547
initial(2) : Prior to sending or receiving any initial(2) : Prior to sending or receiving any
request. request.
calling(3) : After sending the request and prior to calling(3) : After sending the request and prior to
receiving any response. receiving any response.
ringing(4) : After receiving one or more ringing(4) : After receiving one or more
informational (1xx) responses. informational (1xx) responses.
completed(5) : After ACK has been sent following completed(5) : After ACK has been sent following
reception of definitive response. reception of definitive response.
callProceeding(6) : Entered on reception of an INVITE. callProceeding(6) : Entered on reception of an INVITE.
failure(7) : Entered when call fails(send status failure(7) : Entered when call fails(send status
Lingle/Maeng/Walker 33
code>=300). code>=300).
success(8) : Entered when user answers(send status success(8) : Entered when user answers(send status
code=200). code=200).
confirmed(9) : Entered on reception of an ACK in confirmed(9) : Entered on reception of an ACK in
failure or success states." failure or success states."
REFERENCE REFERENCE
"RFC 2543, Figures 12 and 13" "RFC 2543, Figures 12 and 13"
::= { sipTransactionEntry 6 } ::= { sipTransactionEntry 6 }
sipTransNumOutstandingBranches OBJECT-TYPE sipTransNumOutstandingBranches OBJECT-TYPE
SYNTAX Integer32 (0..255) SYNTAX Integer32 (0..255)
Lingle/Maeng/Mule/Walker 45
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object contains a count of the number of branches "This object contains a count of the number of branches
awaiting a final response. Only a forking proxy will have awaiting a final response. Only a forking proxy will have
a value greater than one." a value greater than one."
::= { sipTransactionEntry 7 } ::= { sipTransactionEntry 7 }
sipTransExpiry OBJECT-TYPE sipTransExpiry OBJECT-TYPE
SYNTAX DateAndTime SYNTAX DateAndTime
skipping to change at line 1880 skipping to change at line 2603
::= { sipTransactionEntry 9 } ::= { sipTransactionEntry 9 }
sipTransCalledPartyContentType OBJECT-TYPE sipTransCalledPartyContentType OBJECT-TYPE
SYNTAX SnmpAdminString SYNTAX SnmpAdminString
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object contains the content type of the transaction, "This object contains the content type of the transaction,
including parameters, as indicated by the session including parameters, as indicated by the session
respondant. All optional white space is removed from respondant. All optional white space is removed from
Lingle/Maeng/Walker 34
subfields in the media-type specification. It may subfields in the media-type specification. It may
indicate mime multipart, in which case the multiple indicate mime multipart, in which case the multiple
entries are separated by spaces." entries are separated by spaces."
REFERENCE REFERENCE
"RFC 2543, Section 6.16 and RFC 2068, Section 3.7" "RFC 2543, Section 6.16 and RFC 2068, Section 3.7"
::= { sipTransactionEntry 10 } ::= { sipTransactionEntry 10 }
-- --
-- SIP Retry Statistics
--
-- The counter objects in this group correspond directly to the
-- retry timers supported in sipCommonCfgRetry group. applIndex can
-- be used to correlate the two groups.
Lingle/Maeng/Mule/Walker 46
--
--
sipCommonStatsRetryTable OBJECT-TYPE
SYNTAX SEQUENCE OF SipCommonStatsRetryEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table contains retry statistics objects applicable
to each SIP entity in this system. The instances of
SIP entities are uniquely identified by applIndex."
::= { sipCommonStatsRetry 1 }
sipCommonStatsRetryEntry OBJECT-TYPE
SYNTAX SipCommonStatsRetryEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A row of retry statistics."
INDEX { applIndex }
::= { sipCommonStatsRetryTable 1 }
SipCommonStatsRetryEntry ::=
SEQUENCE {
sipStatsRetryInvites Counter32,
sipStatsRetryAcks Counter32,
sipStatsRetryByes Counter32,
sipStatsRetryCancels Counter32,
sipStatsRetryRegisters Counter32,
sipStatsRetryOptions Counter32,
sipStatsRetryInfos Counter32,
sipStatsRetryFinalResponses Counter32,
sipStatsRetryNonFinalResponses Counter32
}
sipStatsRetryInvites OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object reflects the total number of INVITE retries
that have been sent by the SIP entity. If the number of
'first attempt' INVITES is of interest, subtract the value
of this object from sipStatsInviteOuts."
::= { sipCommonStatsRetryEntry 1 }
sipStatsRetryAcks OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object reflects the total number of ACK retries
that have been sent by the SIP entity. If the number of
'first attempt' ACKs is of interest, subtract the value
of this object from sipStatsAckOuts."
::= { sipCommonStatsRetryEntry 2 }
sipStatsRetryByes OBJECT-TYPE
Lingle/Maeng/Mule/Walker 47
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object reflects the total number of BYE retries that
have been sent by the SIP entity. If the number of
'first attempt' BYEs is of interest, subtract the value
of this object from sipStatsByeOuts."
::= { sipCommonStatsRetryEntry 3 }
sipStatsRetryCancels OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object reflects the total number of CANCEL retries
that have been sent by the SIP entity. If the number of
'first attempt' CANCELs is of interest, subtract the value
of this object from sipStatsCancelOuts."
::= { sipCommonStatsRetryEntry 4 }
sipStatsRetryRegisters OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object reflects the total number of REGISTER retries
that have been sent by the SIP entity. If the number of
'first attempt' REGISTERSs is of interest, subtract the value
of this object from sipStatsRegisterOuts."
::= { sipCommonStatsRetryEntry 5 }
sipStatsRetryOptions OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object reflects the total number of OPTIONS retries
that have been sent by the SIP entity. If the number of
'first attempt' OPTIONS is of interest, subtract the value
of this object from sipStatsOptionsOuts."
::= { sipCommonStatsRetryEntry 6 }
sipStatsRetryInfos OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object reflects the total number of INFO retries that
have been sent by the SIP entity. If the number of
'first attempt' INFOS is of interest, subtract the value
of this object from sipStatsInfoOuts."
::= { sipCommonStatsRetryEntry 7 }
sipStatsRetryFinalResponses OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
Lingle/Maeng/Mule/Walker 48
STATUS current
DESCRIPTION
"This object reflects the total number of Final Response
retries that have been sent by the SIP entity."
::= { sipCommonStatsRetryEntry 8 }
sipStatsRetryNonFinalResponses OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object reflects the total number of non-Final Response
retries that have been sent by the SIP entity."
::= { sipCommonStatsRetryEntry 9 }
--
-- Retry Extensions Stats: support for extension methods
--
sipCommonStatsRetryExtMethodTable OBJECT-TYPE
SYNTAX SEQUENCE OF SipCommonStatsRetryExtMethodEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table contains retry statistics for each SIP
extension method this entity supports. The instances
of SIP entities are uniquely identified by applIndex."
::= { sipCommonStatsRetry 2 }
sipCommonStatsRetryExtMethodEntry OBJECT-TYPE
SYNTAX SipCommonStatsRetryExtMethodEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This row contains retry statistics for
a particular extension method."
::= { sipCommonStatsRetryExtMethodTable 1 }
SipCommonStatsRetryExtMethodEntry ::=
SEQUENCE {
sipStatsRetryExtMethodIndex Unsigned32,
sipStatsRetryExtMethodName SnmpAdminString,
sipStatsRetryExtMethodRetries Counter32,
sipStatsRetryExtMethodStatus RowStatus
}
sipStatsRetryExtMethodIndex OBJECT-TYPE
SYNTAX Unsigned32 (1..4294967295)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This object uniquely identifies a conceptual row in the
table."
::= { sipCommonStatsRetryExtMethodEntry 1 }
sipStatsRetryExtMethodName OBJECT-TYPE
Lingle/Maeng/Mule/Walker 49
SYNTAX SnmpAdminString
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object contains the name of the particular extension
method the SIP entity supports.
For example, it may contain the string 'REFER' if the
REFER method is supported.
It is an error for any of the methods contained
in RFC 2543 to be requested."
::= { sipCommonStatsRetryExtMethodEntry 2 }
sipStatsRetryExtMethodRetries OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object reflects the total number of retries
sent by the SIP entity for a given extension method."
::= { sipCommonStatsRetryExtMethodEntry 3 }
sipStatsRetryExtMethodStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The row status of the entry. This object is required
to create or delete rows remotely by a manager.
A value for sipStatsRetryExtMethodName must be set
for row creation to be successful. If that method
already exists for a particular applIndex, the row
create operation will fail."
::= { sipCommonStatsRetryExtMethodEntry 4 }
--
-- Other Common Statistics -- Other Common Statistics
-- --
sipOtherStatsTable OBJECT-TYPE sipOtherStatsTable OBJECT-TYPE
SYNTAX SEQUENCE OF SipOtherStatsEntry SYNTAX SEQUENCE OF SipOtherStatsEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table contains other common statistics supported by "This table contains other common statistics supported by
each SIP entity in this system. The instances of SIP each SIP entity in this system. The instances of SIP
entities are uniquely identified by applIndex." entities are uniquely identified by applIndex."
::= { sipCommonStats 5 } ::= { sipCommonStats 6 }
sipOtherStatsEntry OBJECT-TYPE sipOtherStatsEntry OBJECT-TYPE
SYNTAX SipOtherStatsEntry SYNTAX SipOtherStatsEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Information on a particular SIP entities' other common "Information on a particular SIP entities' other common
statistics." statistics."
INDEX { applIndex } INDEX { applIndex }
::= { sipOtherStatsTable 1 } ::= { sipOtherStatsTable 1 }
Lingle/Maeng/Mule/Walker 50
SipOtherStatsEntry ::= SipOtherStatsEntry ::=
SEQUENCE { SEQUENCE {
sipNumUnsupportedUris Counter32 sipNumUnsupportedUris Counter32
} }
sipNumUnsupportedUris OBJECT-TYPE sipNumUnsupportedUris OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
skipping to change at line 1934 skipping to change at line 2874
Request status code." Request status code."
::= { sipOtherStatsEntry 5 } ::= { sipOtherStatsEntry 5 }
-- --
-- Notifications -- Notifications
-- --
sipCommonMIBNotifPrefix OBJECT IDENTIFIER ::= { sipCommonMIB 7 } sipCommonMIBNotifPrefix OBJECT IDENTIFIER ::= { sipCommonMIB 7 }
sipCommonMIBNotif OBJECT IDENTIFIER ::= { sipCommonMIBNotif OBJECT IDENTIFIER ::= {
sipCommonMIBNotifPrefix 0 } sipCommonMIBNotifPrefix 0 }
Lingle/Maeng/Walker 35 sipNotifApplIndex OBJECT-TYPE
SYNTAX INTEGER (1..2147483647)
MAX-ACCESS accessible-for-notify
STATUS current
DESCRIPTION
"This object contains the applIndex as described
in RFC 2788. It is used to bind this notification
with a specific instance of SIP entity."
::= { sipCommonMIBNotif 1 }
sipStatusCodeNotif NOTIFICATION-TYPE sipStatusCodeNotif NOTIFICATION-TYPE
OBJECTS { OBJECTS {
sipStatusCodeNotifValue, sipNotifApplIndex,
sipStatusCodeNotifTo, sipStatusCodeNotifTo,
sipStatusCodeNotifFrom, sipStatusCodeNotifFrom,
sipStatusCodeNotifCallId, sipStatusCodeNotifCallId,
sipStatusCodeNotifCSeq sipStatusCodeNotifCSeq
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Signifies that a specific status code has been used." "Signifies that a specific status code has been sent
::= { sipCommonMIBNotif 1 } or received by the system."
sipStatusCodeNotifValue OBJECT-TYPE
SYNTAX INTEGER (100..999)
MAX-ACCESS accessible-for-notify
STATUS current
DESCRIPTION
"This object contains the status code that caused the
notification."
::= { sipCommonMIBNotif 2 } ::= { sipCommonMIBNotif 2 }
sipStatusCodeNotifTo OBJECT-TYPE sipStatusCodeThreshExceededNotif NOTIFICATION-TYPE
SYNTAX SnmpAdminString OBJECTS {
MAX-ACCESS accessible-for-notify sipNotifApplIndex,
STATUS current sipCommonStatusCodeIns,
DESCRIPTION sipCommonStatusCodeOuts
"This object contains the value of the To header in the }
message containing the status code that caused the
notification."
::= { sipCommonMIBNotif 3 }
sipStatusCodeNotifFrom OBJECT-TYPE
SYNTAX SnmpAdminString
MAX-ACCESS accessible-for-notify
STATUS current
DESCRIPTION
"This object contains the value of the From header in the
message containing the status code that caused the
notification."
::= { sipCommonMIBNotif 4 }
sipStatusCodeNotifCallId OBJECT-TYPE
SYNTAX SnmpAdminString
MAX-ACCESS accessible-for-notify
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object contains the value of the CallId in the "Signifies that a specific status code was found to
message containing the status code that caused the have been sent or received by the system enough to
notification." exceed the configured threshold. This notification
::= { sipCommonMIBNotif 5 }
sipStatusCodeNotifCSeq OBJECT-TYPE
SYNTAX Unsigned32
Lingle/Maeng/Walker 36 Lingle/Maeng/Mule/Walker 51
MAX-ACCESS accessible-for-notify can be used as an early warning mechanism in lieu
STATUS current of using sipStatusCodeNotif."
DESCRIPTION ::= { sipCommonMIBNotif 3 }
"This object contains the CSeq value in the message
containing the status code that caused the notification."
::= { sipCommonMIBNotif 6 }
-- --
-- Conformance -- Conformance
-- --
sipCommonMIBConformance sipCommonMIBConformance
OBJECT IDENTIFIER ::= { sipCommonMIB 6 } OBJECT IDENTIFIER ::= { sipCommonMIB 6 }
sipCommonMIBCompliances sipCommonMIBCompliances
OBJECT IDENTIFIER ::= { sipCommonMIBConformance 1 } OBJECT IDENTIFIER ::= { sipCommonMIBConformance 1 }
sipCommonMIBGroups sipCommonMIBGroups
OBJECT IDENTIFIER ::= { sipCommonMIBConformance 2 } OBJECT IDENTIFIER ::= { sipCommonMIBConformance 2 }
skipping to change at line 2018 skipping to change at line 2935
-- --
-- Compliance Statements -- Compliance Statements
-- --
sipCommonCompliance MODULE-COMPLIANCE sipCommonCompliance MODULE-COMPLIANCE
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The compliance statement for SIP entities." "The compliance statement for SIP entities."
MODULE -- this module MODULE -- this module
MANDATORY-GROUPS { sipCommonConfigGroup, MANDATORY-GROUPS { sipCommonConfigGroup,
sipCommonStatsGroup, sipCommonStatsGroup }
sipCommonNotifGroup }
GROUP sipCommonConfigTimerGroup
DESCRIPTION
"This group is optional. A SIP entity can elect to
not provide any timer configuration."
GROUP sipCommonConfigTimerExtMethodGroup
DESCRIPTION
"This group is optional. A SIP entity can elect to
not provide any extension method timer configuration.
If implemented, the sipCommonConfigTimerGroup must also
be implemented because of a dependency on sipCfgTimerT2."
GROUP sipCommonConfigRetryGroup
DESCRIPTION
"This group is optional. A SIP entity can elect to
not provide any retry configuration."
GROUP sipCommonConfigRetryExtMethodGroup
DESCRIPTION
"This group is optional. A SIP entity can elect to
not provide any extension method retry configuration."
GROUP sipCommonStatsRetryGroup
DESCRIPTION
"This group is optional. A SIP entity can elect to
not provide any retry statistics. If implemented,
the sipCommonConfigRetryGroup must also be implemented."
GROUP sipCommonStatsRetryExtMethodsGroup
DESCRIPTION
"This group is optional. A SIP entity can elect to
Lingle/Maeng/Mule/Walker 52
not provide any extension method retry statistics.
If implemented, the sipCommonConfigRetryExtMethodGroup
must also be implemented."
GROUP sipCommonNotifGroup
DESCRIPTION
"This group is optional. A SIP entity can elect to
not provide any notifications. If implemented, the
sipCommonStatusCodeNotifGroup must also be implemented."
GROUP sipCommonStatusCodeNotifGroup
DESCRIPTION
"This group is optional. A SIP entity can elect to
not provide any notifications. If implemented, the
sipCommonNotifGroup must also be implemented."
::= { sipCommonMIBCompliances 1 } ::= { sipCommonMIBCompliances 1 }
-- --
-- Units of Conformance -- Units of Conformance
-- --
sipCommonConfigGroup OBJECT-GROUP sipCommonConfigGroup OBJECT-GROUP
OBJECTS { OBJECTS {
sipProtocolVersion, sipProtocolVersion,
sipServiceOperStatus, sipServiceOperStatus,
sipServiceAdminStatus, sipServiceAdminStatus,
sipServiceStartTime, sipServiceStartTime,
sipServiceLastChange, sipServiceLastChange,
sipTransport, sipTransportRcv,
sipTransportSnd,
sipPortStatus, sipPortStatus,
sipUriSupported, sipUriSupported,
sipFtrSupported, sipFtrSupported,
sipOrganization, sipOrganization,
sipMaxTransactions, sipMaxSessions,
sipInviteTimeout, sipInviteTimeout,
sipHideOperation, sipRequestUriHostMatching
sipUserLocationServerAddr,
Lingle/Maeng/Walker 37
sipCanUseCompact,
sipRequestUriHostMatching,
sipStatusCodeNotifValue,
sipStatusCodeNotifTo,
sipStatusCodeNotifFrom,
sipStatusCodeNotifCallId,
sipStatusCodeNotifCSeq
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A collection of objects providing configuration common "A collection of objects providing configuration common
to all SIP enities." to all SIP enities."
::= { sipCommonMIBGroups 1 } ::= { sipCommonMIBGroups 1 }
sipCommonConfigTimerGroup OBJECT-GROUP
OBJECTS {
sipCfgInitialTimerInvite,
sipCfgTimerProv,
sipCfgInitialTimerAck,
sipCfgInitialTimerBye,
sipCfgInitialTimerRegister,
sipCfgInitialTimerOptions,
sipCfgInitialTimerInfo,
sipCfgInitialTimerResp,
sipCfgTimerT2
}
STATUS current
Lingle/Maeng/Mule/Walker 53
DESCRIPTION
"A collection of objects providing timer configuration
common to all SIP enities."
::= { sipCommonMIBGroups 2 }
sipCommonConfigTimerExtMethodGroup OBJECT-GROUP
OBJECTS {
sipCfgTimerExtMethodName,
sipCfgTimerExtMethodTimer,
sipCfgTimerExtMethodStatus
}
STATUS current
DESCRIPTION
"A collection of objects providing extension method timer
configuration."
::= { sipCommonMIBGroups 3 }
sipCommonConfigRetryGroup OBJECT-GROUP
OBJECTS {
sipCfgRetryInvite,
sipCfgRetryBye,
sipCfgRetryCancel,
sipCfgRetryRegister,
sipCfgRetryResponse,
sipCfgRetryOptions,
sipCfgRetryInfo
}
STATUS current
DESCRIPTION
"A collection of objects providing retry configuration
common to all SIP enities."
::= { sipCommonMIBGroups 4 }
sipCommonConfigRetryExtMethodGroup OBJECT-GROUP
OBJECTS {
sipCfgRetryExtMethodName,
sipCfgRetryExtMethodRetry,
sipCfgRetryExtMethodStatus
}
STATUS current
DESCRIPTION
"A collection of objects providing extension method retry
configuration."
::= { sipCommonMIBGroups 5 }
sipCommonStatsGroup OBJECT-GROUP sipCommonStatsGroup OBJECT-GROUP
OBJECTS { OBJECTS {
sipSummaryInRequests, sipSummaryInRequests,
sipSummaryOutRequests, sipSummaryOutRequests,
sipSummaryInResponses, sipSummaryInResponses,
sipSummaryOutResponses, sipSummaryOutResponses,
sipSummaryTotalTransactions, sipSummaryTotalTransactions,
sipStatsInviteIns, sipStatsInviteIns,
sipStatsInviteOuts, sipStatsInviteOuts,
sipStatsAckIns, sipStatsAckIns,
sipStatsAckOuts, sipStatsAckOuts,
sipStatsByeIns, sipStatsByeIns,
Lingle/Maeng/Mule/Walker 54
sipStatsByeOuts, sipStatsByeOuts,
sipStatsCancelIns, sipStatsCancelIns,
sipStatsCancelOuts, sipStatsCancelOuts,
sipStatsOptionsIns, sipStatsOptionsIns,
sipStatsOptionsOuts, sipStatsOptionsOuts,
sipStatsRegisterIns, sipStatsRegisterIns,
sipStatsRegisterOuts, sipStatsRegisterOuts,
sipStatsInfoIns,
sipStatsInfoOuts,
sipStatsExtMethodName, sipStatsExtMethodName,
sipStatsExtMethodIns, sipStatsExtMethodIns,
sipStatsExtMethodOuts, sipStatsExtMethodOuts,
sipStatsExtMethodStatus, sipStatsExtMethodStatus,
sipStatsInfoClassIns, sipStatsInfoClassIns,
sipStatsInfoClassOuts, sipStatsInfoClassOuts,
sipStatsSuccessClassIns, sipStatsSuccessClassIns,
sipStatsSuccessClassOuts, sipStatsSuccessClassOuts,
sipStatsRedirClassIns, sipStatsRedirClassIns,
sipStatsRedirClassOuts, sipStatsRedirClassOuts,
sipStatsReqFailClassIns, sipStatsReqFailClassIns,
sipStatsReqFailClassOuts, sipStatsReqFailClassOuts,
sipStatsServerFailClassIns, sipStatsServerFailClassIns,
sipStatsServerFailClassOuts, sipStatsServerFailClassOuts,
sipStatsGlobalFailClassIns, sipStatsGlobalFailClassIns,
sipStatsGlobalFailClassOuts, sipStatsGlobalFailClassOuts,
sipCommonStatusCodeIns, sipCommonStatusCodeIns,
sipCommonStatusCodeOuts, sipCommonStatusCodeOuts,
sipCommonStatusCodeSendNotif,
sipCommonStatusCodeStatus, sipCommonStatusCodeStatus,
sipCurrentTransactions, sipCurrentTransactions,
Lingle/Maeng/Walker 38
sipTransTo, sipTransTo,
sipTransFrom, sipTransFrom,
sipTransCallId, sipTransCallId,
sipTransCSeq, sipTransCSeq,
sipTransState, sipTransState,
sipTransNumOutstandingBranches, sipTransNumOutstandingBranches,
sipTransExpiry, sipTransExpiry,
sipTransCallingPartyContentType, sipTransCallingPartyContentType,
sipTransCalledPartyContentType, sipTransCalledPartyContentType,
sipNumUnsupportedUris sipNumUnsupportedUris
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A collection of objects providing statistics common "A collection of objects providing statistics common
toall SIP entities." toall SIP entities."
::= { sipCommonMIBGroups 2 } ::= { sipCommonMIBGroups 6 }
sipCommonStatsRetryGroup OBJECT-GROUP
OBJECTS {
sipStatsRetryInvites,
sipStatsRetryByes,
sipStatsRetryCancels,
sipStatsRetryRegisters,
sipStatsRetryResponses,
sipStatsRetryOptions,
sipStatsRetryInfo
}
STATUS current
Lingle/Maeng/Mule/Walker 55
DESCRIPTION
"A collection of objects providing retry statistics."
::= { sipCommonMIBGroups 7 }
sipCommonStatsRetryExtMethodsGroup OBJECT-GROUP
OBJECTS {
sipStatsRetryExtMethodName,
sipStatsRetryExtMethodRetries,
sipStatsRetryExtMethodStatus
}
STATUS current
DESCRIPTION
"A collection of objects providing extension method retry
statistics."
::= { sipCommonMIBGroups 8 }
sipCommonNotifGroup NOTIFICATION-GROUP sipCommonNotifGroup NOTIFICATION-GROUP
NOTIFICATIONS { NOTIFICATIONS {
sipStatusCodeNotif sipStatusCodeNotif,
sipStatusCodeThreshExceededNotif
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A collection of notifications common to all SIP entities." "A collection of notifications common to all SIP entities."
::= { sipCommonMIBGroups 3 } ::= { sipCommonMIBGroups 9 }
sipCommonStatusCodeNotifGroup OBJECT-GROUP
OBJECTS {
sipCommonStatusCodeNotifSend,
sipCommonStatusCodeNotifEmitMode,
sipCommonStatusCodeNotifThresh,
sipCommonStatusCodeNotifInterval,
sipStatusCodeNotifTo,
sipStatusCodeNotifFrom,
sipStatusCodeNotifCallId,
sipStatusCodeNotifCSeq
}
STATUS current
DESCRIPTION
"A collection of objects related to controlling and attribution
of notifications common to all SIP entities."
::= { sipCommonMIBGroups 10 }
END END
5.4. SIP User Agent 5.4. SIP User Agent
SIP-UA-MIB DEFINITIONS ::= BEGIN SIP-UA-MIB DEFINITIONS ::= BEGIN
IMPORTS IMPORTS
MODULE-IDENTITY, MODULE-IDENTITY,
OBJECT-TYPE, OBJECT-TYPE,
Counter32, Counter32,
Integer32 Integer32
FROM SNMPv2-SMI FROM SNMPv2-SMI
Lingle/Maeng/Mule/Walker 56
MODULE-COMPLIANCE, MODULE-COMPLIANCE,
OBJECT-GROUP, OBJECT-GROUP,
NOTIFICATION-GROUP NOTIFICATION-GROUP
FROM SNMPv2-CONF FROM SNMPv2-CONF
RowStatus
FROM SNMPv2-TC
sipMIB sipMIB
FROM SIP-MIB-SMI FROM SIP-MIB-SMI
applIndex applIndex
FROM NETWORK-SERVICES-MIB; FROM NETWORK-SERVICES-MIB
sipUAMIB MODULE-IDENTITY InetAddressType,
LAST-UPDATED "200007080000Z" InetAddress
FROM INET-ADDRESS-MIB;
Lingle/Maeng/Walker 39 sipUAMIB MODULE-IDENTITY
LAST-UPDATED "200102230000Z"
ORGANIZATION "IETF SIP Working Group, SIP MIB Team" ORGANIZATION "IETF SIP Working Group, SIP MIB Team"
CONTACT-INFO CONTACT-INFO
"SIP MIB Team email: sip-mib@egroups.com "SIP MIB Team email: sip-mib@yahoogroups.com
Co-editor Kevin Lingle Co-editor Kevin Lingle
Cisco Systems, Inc. Cisco Systems, Inc.
postal: 7025 Kit Creek Road postal: 7025 Kit Creek Road
P.O. Box 14987 P.O. Box 14987
Research Triangle Park, NC 27709 Research Triangle Park, NC 27709
USA USA
email: klingle@cisco.com email: klingle@cisco.com
phone: +1-919-392-2029 phone: +1 919 392 2029
Co-editor Joon Maeng Co-editor Joon Maeng
VTEL Corporation VTEL Corporation
postal: 108 Wild Basin Rd. postal: 108 Wild Basin Rd.
Austin, TX 78746 Austin, TX 78746
USA USA
email: joon_maeng@vtel.com email: joon_maeng@vtel.com
phone: +1-512-437-4567 phone: +1 512 437 4567
Co-editor Dave Walker Co-editor Dave Walker
SS8 Networks, Inc. SS8 Networks, Inc.
postal: 80 Hines Road postal: 495 March Road
Kanata, ON K2K 2T8 Kanata, ON K2K 3G1
Canada Canada
email: drwalker@ss8networks.com email: drwalker@ss8.com
phone: +1 613 592 2100" phone: +1 613 592 2100
Co-editor Jean-Francois Mule
Clarent Corporation
700 Chesapeake Drive
Redwood City, CA 94063
email: jfm@clarent.com
phone: +1 650 481 2835"
DESCRIPTION DESCRIPTION
Lingle/Maeng/Mule/Walker 57
"Initial version of Session Initiation Protocol (SIP) "Initial version of Session Initiation Protocol (SIP)
User Agent (UA) MIB module. User Agent (UA) MIB module.
SIP is an application-layer signalling protocol for SIP is an application-layer signalling protocol for
creating, modifying and terminating multimedia creating, modifying and terminating multimedia
sessions with one or more participants. These sessions sessions with one or more participants. These sessions
include Internet multimedia conferences and Internet include Internet multimedia conferences and Internet
telephone calls. SIP is defined in RFC 2543 (March telephone calls. SIP is defined in RFC 2543 (March
1999). 1999).
skipping to change at line 2207 skipping to change at line 3286
SIP request is received and that returns a response on SIP request is received and that returns a response on
behalf of the user. The response accepts, rejects, or behalf of the user. The response accepts, rejects, or
redirects the request." redirects the request."
::= { sipMIB 3 } ::= { sipMIB 3 }
-- --
-- sipUA group -- sipUA group
-- This group contains MIB objects related to SIP User Agents. -- This group contains MIB objects related to SIP User Agents.
-- --
sipUACfg OBJECT IDENTIFIER ::= { sipUAMIB 1 } sipUACfg OBJECT IDENTIFIER ::= { sipUAMIB 1 }
sipUACfgSipServer OBJECT IDENTIFIER ::= { sipUACfg 1 }
Lingle/Maeng/Walker 40
sipUACfgTimer OBJECT IDENTIFIER ::= { sipUACfg 1 }
sipUACfgRetry OBJECT IDENTIFIER ::= { sipUACfg 2 }
sipUAStats OBJECT IDENTIFIER ::= { sipUAMIB 2 } sipUAStats OBJECT IDENTIFIER ::= { sipUAMIB 2 }
sipUAStatsRetry OBJECT IDENTIFIER ::= { sipUAStats 1 }
-- --
-- User Agent Configuration -- User Agent Configuration
-- --
-- --
-- SIP Timer Configuration -- SIP Server Configuration
-- --
sipUACfgTimerTable OBJECT-TYPE sipUACfgSipServerTable OBJECT-TYPE
SYNTAX SEQUENCE OF SipUACfgTimerEntry SYNTAX SEQUENCE OF SipUACfgSipServerEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table contains timer configuration objects applicable "This table contains SIP server configuration objects
to each SIP user agent in this system. The instances of applicable to each SIP user agent in this system. The
SIP entities are uniquely identified by applIndex." instances of SIP entities are uniquely identified
::= { sipUACfgTimer 1 } by applIndex."
::= { sipUACfgSipServer 1 }
sipUACfgTimerEntry OBJECT-TYPE sipUACfgSipServerEntry OBJECT-TYPE
SYNTAX SipUACfgTimerEntry SYNTAX SipUACfgSipServerEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A row of timer configuration." "A row of server configuration."
INDEX { applIndex } INDEX { applIndex, sipUACfgSipServerIndex }
::= { sipUACfgTimerTable 1 } ::= { sipUACfgSipServerTable 1 }
SipUACfgTimerEntry ::= SipUACfgSipServerEntry ::=
Lingle/Maeng/Mule/Walker 58
SEQUENCE { SEQUENCE {
sipUACfgTimerTrying Integer32, sipUACfgSipServerAddrIndex Unsigned32,
sipUACfgTimerProv Integer32, sipUACfgSipServerAddrType InetAddressType,
sipUACfgTimerAck Integer32, sipUACfgSipServerAddr InetAddress,
sipUACfgTimerDisconnect Integer32, sipUACfgSipServerAddrStatus RowStatus
sipUACfgTimerReRegister Integer32
} }
sipUACfgTimerTrying OBJECT-TYPE sipUACfgSipServerAddrIndex OBJECT-TYPE
SYNTAX Integer32 (100..1000) SYNTAX Unsigned32
UNITS "milliseconds" MAX-ACCESS not-accessible
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object specifies the time a user agent will wait to
receive a provisional response to an INVITE before
resending the INVITE."
::= { sipUACfgTimerEntry 1 }
sipUACfgTimerProv OBJECT-TYPE
SYNTAX Integer32 (60000..300000)
Lingle/Maeng/Walker 41
UNITS "milliseconds"
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object specifies the time a user agent will wait to
receive a final response to an INVITE before canceling the
transaction."
::= { sipUACfgTimerEntry 2 }
sipUACfgTimerAck OBJECT-TYPE
SYNTAX Integer32 (100..1000)
UNITS "milliseconds"
MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object specifies the time a user agent will wait to "A unique identifier of a server address when
receive an ACK confirmation indicating that a session is multiple addresses are configured by the SIP entity.
established." If one address isn't reachable, then another can
::= { sipUACfgTimerEntry 3 } be tried."
::= { sipUACfgSipServerEntry 1 }
sipUACfgTimerDisconnect OBJECT-TYPE sipUACfgSipServerAddrType OBJECT-TYPE
SYNTAX Integer32 (100..1000) SYNTAX InetAddressType
UNITS "milliseconds" MAX-ACCESS read-create
MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object specifies the time a user agent will wait to "This object specifies the type of address contained
receive a BYE confirmation indicating that a session is in the associated instance of sipUACfgSipServerAddr."
disconnected." REFERENCE "INET-ADDRESS-MIB (RFC 2851)"
::= { sipUACfgTimerEntry 4 } DEFVAL { ipv4 }
::= { sipUACfgSipServerEntry 2 }
sipUACfgTimerReRegister OBJECT-TYPE sipUACfgSipServerAddr OBJECT-TYPE
SYNTAX Integer32 (1..2147483647) SYNTAX InetAddress
UNITS "seconds" MAX-ACCESS read-create
MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object specifies how long the user agent wishes its "This object specifies the address of a SIP server
registrations to be valid." this user agent will use to proxy/redirect calls."
::= { sipUACfgTimerEntry 5 } ::= { sipUACfgSipServerEntry 3 }
-- sipUACfgSipServerAddrStatus OBJECT-TYPE
-- SIP Retry Configuration SYNTAX RowStatus
-- MAX-ACCESS read-create
sipUACfgRetryTable OBJECT-TYPE
SYNTAX SEQUENCE OF SipUACfgRetryEntry
MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table contains retry configuration objects applicable "This object is used to control rows in this table.
to each SIP user agent in this system. The instances of
SIP entities are uniquely identified by applIndex."
::= { sipUACfgRetry 1 }
Lingle/Maeng/Walker 42 'active' : the row's information is completely
sipUACfgRetryEntry OBJECT-TYPE populated and that information is
SYNTAX SipUACfgRetryEntry being used by the user agent.
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A row of retry configuration."
INDEX { applIndex }
::= { sipUACfgRetryTable 1 }
SipUACfgRetryEntry ::= 'notInService' : the row's address is not being used
SEQUENCE { by the user agent, but will remain in the table.
sipUACfgRetryInvite Integer32,
sipUACfgRetryBye Integer32,
sipUACfgRetryCancel Integer32,
sipUACfgRetryRegister Integer32,
sipUACfgRetryResponse Integer32
}
sipUACfgRetryInvite OBJECT-TYPE 'notReady' : key information is missing thus, preventing
SYNTAX Integer32 (1..10) the row from being made 'active' (eg, no
MAX-ACCESS read-write address specified).
STATUS current
DESCRIPTION
"This object will specify the number of times a user agent
will retry sending an INVITE request."
::= { sipUACfgRetryEntry 1 }
sipUACfgRetryBye OBJECT-TYPE 'createAndGo' : only allowed if the manager also provides
SYNTAX Integer32 (1..10)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object will specify the number of times a user agent
will retry sending a BYE request."
::= { sipUACfgRetryEntry 2 }
sipUACfgRetryCancel OBJECT-TYPE Lingle/Maeng/Mule/Walker 59
SYNTAX Integer32 (1..10) a varbind for sipUACfgSipServerAddr object
MAX-ACCESS read-write in the same set operation.
STATUS current
DESCRIPTION
"This object will specify the number of times a user agent
will retry sending a CANCEL request."
::= { sipUACfgRetryEntry 3 }
sipUACfgRetryRegister OBJECT-TYPE 'createAndWait' : not applicable.
SYNTAX Integer32 (1..10)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object will specify the number of times a user agent
will retry sending a REGISTER request."
::= { sipUACfgRetryEntry 4 }
Lingle/Maeng/Walker 43 'destroy' : the row's address will no longer be used
sipUACfgRetryResponse OBJECT-TYPE by the user agent and the row will be
SYNTAX Integer32 (1..10) removed from the table."
MAX-ACCESS read-write ::= { sipUACfgSipServerEntry 4 }
STATUS current
DESCRIPTION
"This object will specify the number of times a user agent
will retry sending a Response and expecting an ACK."
::= { sipUACfgRetryEntry 5 }
-- --
-- User Agent Statistics -- User Agent Statistics
-- --
-- -- none at this time
-- SIP Retry Statistics
--
-- The counter objects in this group correspond directly to the
-- retry timers supported in sipCfgRetry group. applIndex can
-- be used to correlate the two groups.
--
--
sipUAStatsRetryTable OBJECT-TYPE
SYNTAX SEQUENCE OF SipUAStatsRetryEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table contains retry statistics objects applicable
to each SIP user agent in this system. The instances of
SIP entities are uniquely identified by applIndex."
::= { sipUAStatsRetry 1 }
sipUAStatsRetryEntry OBJECT-TYPE
SYNTAX SipUAStatsRetryEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A row of retry statistics."
INDEX { applIndex }
::= { sipUAStatsRetryTable 1 }
SipUAStatsRetryEntry ::=
SEQUENCE {
sipStatsRetryInvites Counter32,
sipStatsRetryByes Counter32,
sipStatsRetryCancels Counter32,
sipStatsRetryRegisters Counter32,
sipStatsRetryResponses Counter32
}
sipStatsRetryInvites OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
Lingle/Maeng/Walker 44
STATUS current
DESCRIPTION
"This object reflects the total number of INVITE retries
that have been sent by the user agent. If the number of
'first attempt' INVITES is of interest, subtract the value
of this object from sipStatsTrafficInviteOut."
::= { sipUAStatsRetryEntry 1 }
sipStatsRetryByes OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object reflects the total number of BYE retries that
have been sent by the user agent."
::= { sipUAStatsRetryEntry 2 }
sipStatsRetryCancels OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object reflects the total number of CANCEL retries
that have been sent by the user agent."
::= { sipUAStatsRetryEntry 3 }
sipStatsRetryRegisters OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object reflects the total number of REGISTER retries
that have been sent by the user agent."
::= { sipUAStatsRetryEntry 4 }
sipStatsRetryResponses OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object reflects the total number of Response (while
expecting an ACK) retries that have been sent by the user
agent."
::= { sipUAStatsRetryEntry 5 }
-- --
-- Notifications -- Notifications
-- --
sipUAMIBNotif OBJECT IDENTIFIER ::= { sipUAMIB 3 } sipUAMIBNotif OBJECT IDENTIFIER ::= { sipUAMIB 3 }
-- none at this time -- none at this time
Lingle/Maeng/Walker 45
-- --
-- Conformance -- Conformance
-- --
sipUAMIBConformance sipUAMIBConformance
OBJECT IDENTIFIER ::= { sipUAMIB 4 } OBJECT IDENTIFIER ::= { sipUAMIB 4 }
sipUAMIBCompliances sipUAMIBCompliances
OBJECT IDENTIFIER ::= { sipUAMIBConformance 1 } OBJECT IDENTIFIER ::= { sipUAMIBConformance 1 }
sipUAMIBGroups sipUAMIBGroups
OBJECT IDENTIFIER ::= { sipUAMIBConformance 2 } OBJECT IDENTIFIER ::= { sipUAMIBConformance 2 }
-- --
-- Compliance Statements -- Compliance Statements
-- --
sipUACompliance MODULE-COMPLIANCE sipUACompliance MODULE-COMPLIANCE
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The compliance statement for SIP entities." "The compliance statement for SIP entities."
MODULE -- this module MODULE -- this module
MANDATORY-GROUPS { sipUAConfigGroup, MANDATORY-GROUPS { sipUAConfigGroup }
sipUAStatsGroup }
-- sipUANotifGroup } -- sipUANotifGroup }
::= { sipUAMIBCompliances 1 } ::= { sipUAMIBCompliances 1 }
-- --
-- Units of Conformance -- Units of Conformance
-- --
sipUAConfigGroup OBJECT-GROUP sipUAConfigGroup OBJECT-GROUP
OBJECTS { OBJECTS {
sipUACfgTimerTrying, sipUACfgSipServerAddrIndex,
sipUACfgTimerProv,
sipUACfgTimerAck, Lingle/Maeng/Mule/Walker 60
sipUACfgTimerDisconnect, sipUACfgSipServerAddrType,
sipUACfgTimerReRegister, sipUACfgSipServerAddr,
sipUACfgRetryInvite, sipUACfgSipServerStatus
sipUACfgRetryBye,
sipUACfgRetryCancel,
sipUACfgRetryRegister,
sipUACfgRetryResponse
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A collection of objects providing configuration for "A collection of objects providing configuration for
SIP User Agents." SIP User Agents."
::= { sipUAMIBGroups 1 } ::= { sipUAMIBGroups 1 }
sipUAStatsGroup OBJECT-GROUP
OBJECTS {
sipStatsRetryInvites,
sipStatsRetryByes,
sipStatsRetryCancels,
Lingle/Maeng/Walker 46
sipStatsRetryRegisters,
sipStatsRetryResponses
}
STATUS current
DESCRIPTION
"A collection of objects providing statistics for
SIP User Agents."
::= { sipUAMIBGroups 2 }
--sipUANotifGroup NOTIFICATION-GROUP --sipUANotifGroup NOTIFICATION-GROUP
-- OBJECTS { -- OBJECTS {
-- none at this time -- none at this time
-- } -- }
-- STATUS current -- STATUS current
-- DESCRIPTION -- DESCRIPTION
-- "A collection of notifications defined for SIP User -- "A collection of notifications defined for SIP User
-- Agents." -- Agents."
-- ::= { sipMIBGroups 3 } -- ::= { sipMIBGroups 2 }
END END
5.5. SIP Redirect & Proxy Server 5.5. SIP Server (Registrar, Redirect & Proxy Server)
SIP-SERVER-MIB DEFINITIONS ::= BEGIN SIP-SERVER-MIB DEFINITIONS ::= BEGIN
IMPORTS IMPORTS
MODULE-IDENTITY, MODULE-IDENTITY,
OBJECT-TYPE, OBJECT-TYPE,
Counter32, Counter32,
Integer32, Integer32,
Unsigned32 Unsigned32
FROM SNMPv2-SMI FROM SNMPv2-SMI
RowStatus, RowStatus,
TruthValue TruthValue,
TimeStamp, DateAndTime
FROM SNMPv2-TC FROM SNMPv2-TC
MODULE-COMPLIANCE, MODULE-COMPLIANCE,
OBJECT-GROUP OBJECT-GROUP
FROM SNMPv2-CONF FROM SNMPv2-CONF
SnmpAdminString SnmpAdminString
FROM SNMP-FRAMEWORK-MIB FROM SNMP-FRAMEWORK-MIB
SipServerActions
FROM SIP-TC
sipMIB sipMIB
FROM SIP-MIB-SMI FROM SIP-MIB-SMI
applIndex applIndex
FROM NETWORK-SERVICES-MIB; FROM NETWORK-SERVICES-MIB;
Lingle/Maeng/Walker 47
sipServerMIB MODULE-IDENTITY sipServerMIB MODULE-IDENTITY
LAST-UPDATED "200007080000Z" LAST-UPDATED "200102280000Z"
Lingle/Maeng/Mule/Walker 61
ORGANIZATION "IETF SIP Working Group, SIP MIB Team" ORGANIZATION "IETF SIP Working Group, SIP MIB Team"
CONTACT-INFO CONTACT-INFO
"SIP MIB Team email: sip-mib@egroups.com "SIP MIB Team email: sip-mib@yahoogroups.com
Co-editor Kevin Lingle Co-editor Kevin Lingle
Cisco Systems, Inc. Cisco Systems, Inc.
postal: 7025 Kit Creek Road postal: 7025 Kit Creek Road
P.O. Box 14987 P.O. Box 14987
Research Triangle Park, NC 27709 Research Triangle Park, NC 27709
USA USA
email: klingle@cisco.com email: klingle@cisco.com
phone: +1-919-392-2029 phone: +1 919 392 2029
Co-editor Joon Maeng Co-editor Joon Maeng
VTEL Corporation VTEL Corporation
postal: 108 Wild Basin Rd. postal: 108 Wild Basin Rd.
Austin, TX 78746 Austin, TX 78746
USA USA
email: joon_maeng@vtel.com email: joon_maeng@vtel.com
phone: +1-512-437-4567 phone: +1 512 437 4567
Co-editor Dave Walker Co-editor Dave Walker
SS8 Networks, Inc. SS8 Networks, Inc.
postal: 80 Hines Road postal: 495 March Road
Kanata, ON K2K 2T8 Kanata, ON K2K 3G1
Canada Canada
email: drwalker@ss8networks.com email: drwalker@ss8.com
phone: +1 613 592 2100" phone: +1 613 592 2100
Co-editor Jean-Francois Mule
Clarent Corporation
700 Chesapeake Drive
Redwood City, CA 94063
email: jfm@clarent.com
phone: +1 650 481 2835"
DESCRIPTION DESCRIPTION
"Initial version of Session Initiation Protocol (SIP) "Initial version of Session Initiation Protocol (SIP)
Server MIB module. Server MIB module.
SIP is an application-layer signalling protocol for SIP is an application-layer signalling protocol for
creating, modifying and terminating multimedia creating, modifying and terminating multimedia
sessions with one or more participants. These sessions sessions with one or more participants. These sessions
include Internet multimedia conferences and Internet include Internet multimedia conferences and Internet
telephone calls. SIP is defined in RFC 2543 (March telephone calls. SIP is defined in RFC 2543 (March
1999). 1999).
This MIB is defined for the management of SIP Proxy This MIB is defined for the management of SIP Proxy,
and Redirect Servers. Redirect, and Registrar Servers.
A Proxy Server acts as both a client and a server. A Proxy Server acts as both a client and a server.
It accepts requests from other clients, either It accepts requests from other clients, either
responding to them or passing them on to other responding to them or passing them on to other
servers, possibly after modification. servers, possibly after modification.
A Redirect Server accepts requests from clients and A Redirect Server accepts requests from clients and
returns zero or more addresses to that client. Unlike returns zero or more addresses to that client. Unlike
a Proxy server it does not initiate requests. Unlike a Proxy server it does not initiate requests. Unlike
a User Agent Server it does not accept calls."
Lingle/Maeng/Walker 48 Lingle/Maeng/Mule/Walker 62
a User Agent Server it does not accept calls.
A Registrar is a server that accepts REGISTER
requests. A Registrar is typically co-located with a
Proxy or Redirect Server."
::= { sipMIB 4 } ::= { sipMIB 4 }
-- --
-- sipServer group -- sipServer group
-- This group contains MIB objects common to Proxy and Redirect -- This group contains MIB objects common to Proxy and Redirect
-- Servers. -- Servers.
-- --
sipServerCfg OBJECT IDENTIFIER ::= { sipServerMIB 1 } sipServerCfg OBJECT IDENTIFIER ::= { sipServerMIB 1 }
sipServerStats OBJECT IDENTIFIER ::= { sipServerMIB 2 } sipServerStats OBJECT IDENTIFIER ::= { sipServerMIB 2 }
skipping to change at line 2681 skipping to change at line 3590
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A row of common configuration." "A row of common configuration."
INDEX { applIndex } INDEX { applIndex }
::= { sipServerCfgTable 1 } ::= { sipServerCfgTable 1 }
SipServerCfgEntry ::= SipServerCfgEntry ::=
SEQUENCE { SEQUENCE {
sipServerHost SnmpAdminString, sipServerHost SnmpAdminString,
sipInformationAlwaysSendTrying TruthValue,
sipInformationTryingInterval Integer32, sipInformationTryingInterval Integer32,
sipPgpVersion SnmpAdminString, sipPgpVersion SnmpAdminString,
sipServerDfltAction SipServerActions, sipServerContactDfltAction INTEGER,
sipServerRespectUAAction TruthValue sipServerRespectUAAction TruthValue
} }
sipServerHost OBJECT-TYPE sipServerHost OBJECT-TYPE
SYNTAX SnmpAdminString SYNTAX SnmpAdminString
MAX-ACCESS read-write MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This is the host portion of a SIP URL that is assigned "This is the host portion of a SIP URL that is assigned
to the SIP server. It may contain a fully qualified to the SIP server. It may contain a fully qualified
domain name, or an IP address (v4 only for now)." domain name, or an IP address (v4 only for now)."
REFERENCE
Lingle/Maeng/Walker 49 Lingle/Maeng/Mule/Walker 63
REFERENCE
"RFC 2543, Section 2" "RFC 2543, Section 2"
::= { sipServerCfgEntry 1 } ::= { sipServerCfgEntry 1 }
-- --
-- Support for 1xx Status Codes -- Support for 1xx Status Codes
-- --
sipInformationAlwaysSendTrying OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"If this object is true, the server sends 100 Trying when a
request is processed."
::= { sipServerCfgEntry 2 }
sipInformationTryingInterval OBJECT-TYPE sipInformationTryingInterval OBJECT-TYPE
SYNTAX Integer32 (0..60000) SYNTAX Integer32 (0..60000)
UNITS "milliseconds" UNITS "milliseconds"
MAX-ACCESS read-write MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Server sends a 100 Trying at intervals of this duration "Server sends a 100 Trying at intervals of this duration
as counted from when the request was processed. If the as counted from when the request was processed. If the
value is zero, no such retransmission is performed." value is zero, no such retransmission is performed."
::= { sipServerCfgEntry 3 } ::= { sipServerCfgEntry 2 }
-- --
-- Security -- Security
-- --
sipPgpVersion OBJECT-TYPE sipPgpVersion OBJECT-TYPE
SYNTAX SnmpAdminString SYNTAX SnmpAdminString
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object indicates the version of PGP (Pretty Good "This object indicates the version of PGP (Pretty Good
Privacy) supported by this server. Common values are Privacy) supported by this server. Common values are
2.6.2 and 5.0." 2.6.2 and 5.0."
::= { sipServerCfgEntry 4 } ::= { sipServerCfgEntry 3 }
-- --
-- Additional Server Configuration -- Additional Server Configuration
-- --
sipServerDfltAction OBJECT-TYPE sipServerContactDfltAction OBJECT-TYPE
SYNTAX SipServerActions SYNTAX INTEGER {
redirect(1),
proxy(2)
}
MAX-ACCESS read-write MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object specifies whether the default action of the "This object specifies whether the default contact action
server is to be a proxy server or a redirect server. A of the server is to be a proxy or a redirect server. A
User Agent may indicate a preference upon registration of User Agent may indicate a preference upon registration of
Contact information. The value of this object is used in Contact information. The value of this object is used in
the absence of such an indication." the absence of such an indication."
REFERENCE REFERENCE
"RFC 2543, Section 6.13" "RFC 2543, Section 6.13"
::= { sipServerCfgEntry 4 }
Lingle/Maeng/Walker 50
::= { sipServerCfgEntry 5 }
sipServerRespectUAAction OBJECT-TYPE sipServerRespectUAAction OBJECT-TYPE
SYNTAX TruthValue SYNTAX TruthValue
MAX-ACCESS read-write MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object specifies whether the server should respect "This object specifies whether the server should respect
Lingle/Maeng/Mule/Walker 64
the wishes of a User Agent when the UA specifies a server the wishes of a User Agent when the UA specifies a server
action (proxy or redirect) for certain Contact action (proxy or redirect) for certain Contact
information. If the value of this object is false, then information. If the value of this object is false, then
the value contained in the sipServerDfltAction is used." the value contained in the sipServerDfltAction is used."
REFERENCE REFERENCE
"RFC 2543, Section 6.13" "RFC 2543, Section 6.13"
::= { sipServerCfgEntry 6 } ::= { sipServerCfgEntry 5 }
-- --
-- Common Server Statistics -- Common Server Statistics
-- --
-- none at this time -- none at this time
-- sipProxy group -- sipProxy group
-- This group contains MIB objects related to SIP Proxy Servers. -- This group contains MIB objects related to SIP Proxy Servers.
-- --
skipping to change at line 2806 skipping to change at line 3708
by applIndex." by applIndex."
::= { sipProxyCfg 1 } ::= { sipProxyCfg 1 }
sipProxyCfgEntry OBJECT-TYPE sipProxyCfgEntry OBJECT-TYPE
SYNTAX SipProxyCfgEntry SYNTAX SipProxyCfgEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A row of common configuration." "A row of common configuration."
INDEX { applIndex } INDEX { applIndex }
Lingle/Maeng/Walker 51
::= { sipProxyCfgTable 1 } ::= { sipProxyCfgTable 1 }
SipProxyCfgEntry ::= SipProxyCfgEntry ::=
SEQUENCE { SEQUENCE {
sipRequestMaxExpires Unsigned32, sipRequestMaxExpires Unsigned32,
sipProxyStateful TruthValue, sipProxyStateful TruthValue,
sipProxySendsCancel TruthValue, sipProxySendsCancel TruthValue,
sipProxyForwardAll1xx TruthValue, sipProxyForwardAll1xx TruthValue,
sipProxyRecursion TruthValue, sipProxyRecursion TruthValue,
sipProxyProvideAlternatives TruthValue, sipProxyProvideAlternatives TruthValue,
sipProxyRecordRoute TruthValue, sipProxyRecordRoute TruthValue,
Lingle/Maeng/Mule/Walker 65
sipProxyStateTimeout Integer32, sipProxyStateTimeout Integer32,
sipProxyAuthMethod INTEGER, sipProxyAuthMethod BITS,
sipProxyAuthPgpAlgorithm INTEGER, sipProxyAuthPgpAlgorithm INTEGER,
sipProxyAuthRealm SnmpAdminString, sipProxyAuthRealm SnmpAdminString,
sipProxyNonceLifeTime Integer32, sipProxyNonceLifeTime Integer32,
sipPgpPrivateKey OCTET sipPgpPrivateKey OCTET STRING
STRING(SIZE(0..255)),
sipHideRespect TruthValue
} }
sipRequestMaxExpires OBJECT-TYPE sipRequestMaxExpires OBJECT-TYPE
SYNTAX Unsigned32 (0..4294967295) SYNTAX Unsigned32 (0..4294967295)
UNITS "seconds" UNITS "seconds"
MAX-ACCESS read-write MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object specifies the maximum duration that a SIP "This object specifies the maximum duration that a SIP
proxy server will accept from a client in the Expires proxy server will accept from a client in the Expires
skipping to change at line 2862 skipping to change at line 3762
which generated outgoing requests, and the outgoing which generated outgoing requests, and the outgoing
requests. A stateless proxy forgets all information requests. A stateless proxy forgets all information
once an outgoing request is generated. once an outgoing request is generated.
If the value of this object is TRUE, the proxy defaults If the value of this object is TRUE, the proxy defaults
to stateful. If FALSE, the proxy defaults to stateless." to stateful. If FALSE, the proxy defaults to stateless."
REFERENCE REFERENCE
"RFC 2543, Section 12.3" "RFC 2543, Section 12.3"
::= { sipProxyCfgEntry 2 } ::= { sipProxyCfgEntry 2 }
Lingle/Maeng/Walker 52
sipProxySendsCancel OBJECT-TYPE sipProxySendsCancel OBJECT-TYPE
SYNTAX TruthValue SYNTAX TruthValue
MAX-ACCESS read-write MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object specifies whether or not a forking proxy sends "This object specifies whether or not a forking proxy sends
CANCEL on outstanding branch requests after receiving a CANCEL on outstanding branch requests after receiving a
2xx or 6xx, or after the request times-out. 2xx or 6xx, or after the request times-out.
If the value of this object is TRUE, the server sends a If the value of this object is TRUE, the server sends a
CANCELs on branches where no definitive response has been CANCELs on branches where no definitive response has been
received. If FALSE, the proxy does not send CANCELs." received. If FALSE, the proxy does not send CANCELs."
REFERENCE REFERENCE
"RFC 2543, Section 12.4" "RFC 2543, Section 12.4"
::= { sipProxyCfgEntry 3 } ::= { sipProxyCfgEntry 3 }
Lingle/Maeng/Mule/Walker 66
sipProxyForwardAll1xx OBJECT-TYPE sipProxyForwardAll1xx OBJECT-TYPE
SYNTAX TruthValue SYNTAX TruthValue
MAX-ACCESS read-write MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object specifies whether or not the proxy forwards "This object specifies whether or not the proxy forwards
all 1xx responses, except the 100 Trying response, all 1xx responses, except the 100 Trying response,
upstream towards the source of the request. upstream towards the source of the request.
If the value of this object is TRUE, the 1xx responses are If the value of this object is TRUE, the 1xx responses are
skipping to change at line 2917 skipping to change at line 3817
sipProxyProvideAlternatives OBJECT-TYPE sipProxyProvideAlternatives OBJECT-TYPE
SYNTAX TruthValue SYNTAX TruthValue
MAX-ACCESS read-write MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The object specifies whether or not the Server provides "The object specifies whether or not the Server provides
alternative Contacts in 3xx and 485 responses. alternative Contacts in 3xx and 485 responses.
If the value of this object is TRUE, the server inserts a If the value of this object is TRUE, the server inserts a
Lingle/Maeng/Walker 53
list of alternative URLs into a Contact header where the list of alternative URLs into a Contact header where the
request Originator may possibly find the desired called request Originator may possibly find the desired called
party. If the value is FALSE, the server doesn't add party. If the value is FALSE, the server doesn't add
Contact information to 3xx and 485 responses. Contact information to 3xx and 485 responses.
Note that the policies of a server may limit the Note that the policies of a server may limit the
particular alternatives that are returned when this object particular alternatives that are returned when this object
is TRUE." is TRUE."
REFERENCE REFERENCE
"RFC 2543, Section 6.13" "RFC 2543, Section 6.13"
DEFVAL { false } DEFVAL { false }
::= { sipProxyCfgEntry 6 } ::= { sipProxyCfgEntry 6 }
sipProxyRecordRoute OBJECT-TYPE sipProxyRecordRoute OBJECT-TYPE
SYNTAX TruthValue SYNTAX TruthValue
MAX-ACCESS read-write MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object specifies whether or not the proxy adds itself "This object specifies whether or not the proxy adds itself
Lingle/Maeng/Mule/Walker 67
to the Record-Route header as a default action. This to the Record-Route header as a default action. This
header is used to list the proxies that insist on being in header is used to list the proxies that insist on being in
the signalling path for subsequent requests related to the the signalling path for subsequent requests related to the
call-leg. call-leg.
If the value of this object is TRUE, the proxy adds itself If the value of this object is TRUE, the proxy adds itself
to the end of the Record-Route header, creating the header to the end of the Record-Route header, creating the header
if required. If the value is FALSE, the proxy doesn't add if required. If the value is FALSE, the proxy doesn't add
itself to the Record-Route header." itself to the Record-Route header."
REFERENCE REFERENCE
skipping to change at line 2969 skipping to change at line 3869
retains state in order to handle possible retransmissions retains state in order to handle possible retransmissions
of the response." of the response."
REFERENCE REFERENCE
"RFC 2543, Section 12.3.6" "RFC 2543, Section 12.3.6"
::= { sipProxyCfgEntry 8 } ::= { sipProxyCfgEntry 8 }
-- --
-- Security -- Security
-- --
sipProxyAuthMethod OBJECT-TYPE sipProxyAuthMethod OBJECT-TYPE
SYNTAX INTEGER { SYNTAX BITS {
none(1), none(0),
basic(2), basic(1),
digest(3), digest(2),
pgp(3)
Lingle/Maeng/Walker 54
pgp(4)
} }
MAX-ACCESS read-write MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object specifies the authentication method that is "This object specifies the authentication method that is
used to authenticate request originators. If the value is used to authenticate request originators.
none(1), no authentication is performed."
bit 0 no authentication is performed
bit 1 HTTP basic is used
bit 2 HTTP digest is used
bit 3 PGP (Pretty Good Privacy) is used."
::= { sipProxyCfgEntry 9 } ::= { sipProxyCfgEntry 9 }
sipProxyAuthPgpAlgorithm OBJECT-TYPE sipProxyAuthPgpAlgorithm OBJECT-TYPE
SYNTAX INTEGER { SYNTAX INTEGER {
other(1), other(1),
md5(2), md5(2),
sha1(3) sha1(3)
} }
MAX-ACCESS read-write MAX-ACCESS read-write
Lingle/Maeng/Mule/Walker 68
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object specifies the PGP algorithm the proxy uses." "This object specifies the PGP algorithm the proxy uses."
::= { sipProxyCfgEntry 10 } ::= { sipProxyCfgEntry 10 }
sipProxyAuthRealm OBJECT-TYPE sipProxyAuthRealm OBJECT-TYPE
SYNTAX SnmpAdminString SYNTAX SnmpAdminString
MAX-ACCESS read-write MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
skipping to change at line 3029 skipping to change at line 3933
::= { sipProxyCfgEntry 12 } ::= { sipProxyCfgEntry 12 }
-- --
-- Proxy-Authenticate received by this server -- Proxy-Authenticate received by this server
-- (i.e. this server is being authenticated by a peer) -- (i.e. this server is being authenticated by a peer)
-- --
sipPgpPrivateKey OBJECT-TYPE sipPgpPrivateKey OBJECT-TYPE
SYNTAX OCTET STRING(SIZE(0..255)) SYNTAX OCTET STRING(SIZE(0..255))
MAX-ACCESS read-write MAX-ACCESS read-write
STATUS current STATUS current
Lingle/Maeng/Walker 55
DESCRIPTION DESCRIPTION
"The value of this object is the server's private PGP key, "The value of this object is the server's private PGP key,
used for both PGP authentication of this server and for used for both PGP authentication of this server and for
PGP-based PGP-based
encryption." encryption."
::= { sipProxyCfgEntry 13 } ::= { sipProxyCfgEntry 13 }
sipHideRespect OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object specifies whether the server encrypts Via
headers as requested by received Hide headers."
::= { sipProxyCfgEntry 14 }
sipRxProxyAuthTable OBJECT-TYPE sipRxProxyAuthTable OBJECT-TYPE
SYNTAX SEQUENCE OF SipRxProxyAuthEntry SYNTAX SEQUENCE OF SipRxProxyAuthEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table contains authentication data for peers of each "This table contains authentication data for peers of each
proxy server in this system. The instances of proxy proxy server in this system. The instances of proxy
server are uniquely identified by the applIndex." server are uniquely identified by the applIndex."
::= { sipProxyCfg 2 } ::= { sipProxyCfg 2 }
sipRxProxyAuthEntry OBJECT-TYPE sipRxProxyAuthEntry OBJECT-TYPE
SYNTAX SipRxProxyAuthEntry SYNTAX SipRxProxyAuthEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
Lingle/Maeng/Mule/Walker 69
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object contains authentication data for a single "This object contains authentication data for a single
peer." peer."
INDEX { applIndex, sipRxProxyAuthIndex } INDEX { applIndex, sipRxProxyAuthIndex }
::= { sipRxProxyAuthTable 1 } ::= { sipRxProxyAuthTable 1 }
SipRxProxyAuthEntry ::= SipRxProxyAuthEntry ::=
SEQUENCE { SEQUENCE {
sipRxProxyAuthIndex Unsigned32, sipRxProxyAuthIndex Unsigned32,
skipping to change at line 3084 skipping to change at line 3979
sipRxProxyAuthIndex OBJECT-TYPE sipRxProxyAuthIndex OBJECT-TYPE
SYNTAX Unsigned32 (1..4294967295) SYNTAX Unsigned32 (1..4294967295)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object uniquely identifies a conceptual row in the "This object uniquely identifies a conceptual row in the
table." table."
::= { sipRxProxyAuthEntry 1 } ::= { sipRxProxyAuthEntry 1 }
Lingle/Maeng/Walker 56
sipRxProxyAuthRealm OBJECT-TYPE sipRxProxyAuthRealm OBJECT-TYPE
SYNTAX SnmpAdminString SYNTAX SnmpAdminString
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object contains the realm that is specified by "This object contains the realm that is specified by
another server when it is authenticating this server." another server when it is authenticating this server."
::= { sipRxProxyAuthEntry 2 } ::= { sipRxProxyAuthEntry 2 }
sipRxProxyAuthPassword OBJECT-TYPE sipRxProxyAuthPassword OBJECT-TYPE
skipping to change at line 3117 skipping to change at line 4011
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The row status of the entry. This object is required "The row status of the entry. This object is required
to create or delete rows remotely by a manager." to create or delete rows remotely by a manager."
::= { sipRxProxyAuthEntry 4 } ::= { sipRxProxyAuthEntry 4 }
-- --
-- Proxy Server Statistics -- Proxy Server Statistics
-- --
Lingle/Maeng/Mule/Walker 70
sipProxyStatsTable OBJECT-TYPE sipProxyStatsTable OBJECT-TYPE
SYNTAX SEQUENCE OF SipProxyStatsEntry SYNTAX SEQUENCE OF SipProxyStatsEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table contains the statistics objects applicable "This table contains the statistics objects applicable
to all SIP Proxy Servers in this system. to all SIP Proxy Servers in this system.
Each row represents those objects for a particular Each row represents those objects for a particular
SIP Proxy Server. The instances of SIP Proxy Server SIP Proxy Server. The instances of SIP Proxy Server
skipping to change at line 3139 skipping to change at line 4035
sipProxyStatsEntry OBJECT-TYPE sipProxyStatsEntry OBJECT-TYPE
SYNTAX SipProxyStatsEntry SYNTAX SipProxyStatsEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A row of summary statistics." "A row of summary statistics."
INDEX { applIndex } INDEX { applIndex }
::= { sipProxyStatsTable 1 } ::= { sipProxyStatsTable 1 }
Lingle/Maeng/Walker 57
SipProxyStatsEntry ::= SipProxyStatsEntry ::=
SEQUENCE { SEQUENCE {
sipNumProxyRequireFailures Counter32 sipNumProxyRequireFailures Counter32
} }
sipNumProxyRequireFailures OBJECT-TYPE sipNumProxyRequireFailures OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
skipping to change at line 3168 skipping to change at line 4063
-- sipRedir group -- sipRedir group
-- This group contains MIB objects related to SIP Redirect Servers. -- This group contains MIB objects related to SIP Redirect Servers.
-- --
sipRedir OBJECT IDENTIFIER ::= { sipServerMIB 4 } sipRedir OBJECT IDENTIFIER ::= { sipServerMIB 4 }
sipRedirCfg OBJECT IDENTIFIER ::= { sipRedir 1 } sipRedirCfg OBJECT IDENTIFIER ::= { sipRedir 1 }
sipRedirStats OBJECT IDENTIFIER ::= { sipRedir 2 } sipRedirStats OBJECT IDENTIFIER ::= { sipRedir 2 }
-- none at this time -- none at this time
-- --
-- Notifications
--
sipServerMIBNotif OBJECT IDENTIFIER ::= { sipServerMIB 5 }
sipProxyNotif OBJECT IDENTIFIER ::= { sipServerMIBNotif 1 }
sipRedirNotif OBJECT IDENTIFIER ::= { sipServerMIBNotif 2 }
-- none at this time
--
-- Conformance
--
sipServerMIBConformance
OBJECT IDENTIFIER ::= { sipServerMIB 6 }
sipServerMIBCompliances
OBJECT IDENTIFIER ::= { sipServerMIBConformance 1 }
sipServerMIBGroups
OBJECT IDENTIFIER ::= { sipServerMIBConformance 2 }
--
-- Compliance Statements
--
Lingle/Maeng/Walker 58
sipCompliance MODULE-COMPLIANCE
STATUS current
DESCRIPTION
"The compliance statement for SIP entities."
MODULE -- this module
MANDATORY-GROUPS { sipServerConfigGroup }
-- sipServerStatsGroup,
-- sipServerNotifGroup }
GROUP sipProxyConfigGroup
DESCRIPTION
"This group is mandatory for SIP Proxy servers."
GROUP sipProxyStatsGroup
DESCRIPTION
"This group is mandatory for SIP Proxy servers."
-- GROUP sipProxyNotifGroup
-- DESCRIPTION
-- "This group is mandatory for SIP Proxy servers."
-- GROUP sipRedirectConfigGroup
-- DESCRIPTION
-- "This group is mandatory for SIP Redirect servers."
-- GROUP sipRedirectStatsGroup
-- DESCRIPTION
-- "This group is mandatory for SIP Redirect servers."
-- GROUP sipRedirectNotifGroup
-- DESCRIPTION
-- "This group is mandatory for SIP Redirect servers."
::= { sipServerMIBCompliances 1 }
--
-- Units of Conformance
--
sipServerConfigGroup OBJECT-GROUP
OBJECTS {
sipServerHost,
sipInformationAlwaysSendTrying,
sipInformationTryingInterval,
sipPgpVersion,
sipServerDfltAction,
sipServerRespectUAAction
}
STATUS current
DESCRIPTION
"A collection of objects providing configuration common
to SIP Proxy and Redirect servers."
Lingle/Maeng/Walker 59
::= { sipServerMIBGroups 1 }
--sipServerStatsGroup OBJECT-GROUP
-- OBJECTS {
-- none at this time
-- }
-- STATUS current
-- DESCRIPTION
-- "A collection of objects providing common statistics for
-- SIP Proxy and Redirect servers."
-- ::= { sipServerMIBGroups 2 }
sipProxyConfigGroup OBJECT-GROUP
OBJECTS {
sipRequestMaxExpires,
sipProxyStateful,
sipProxySendsCancel,
sipProxyForwardAll1xx,
sipProxyRecursion,
sipProxyProvideAlternatives,
sipProxyRecordRoute,
sipProxyStateTimeout,
sipProxyAuthMethod,
sipProxyAuthPgpAlgorithm,
sipProxyAuthRealm,
sipProxyNonceLifeTime,
sipPgpPrivateKey,
sipRxProxyAuthRealm,
sipRxProxyAuthPassword,
sipRxProxyAuthStatus,
sipHideRespect
}
STATUS current
DESCRIPTION
"A collection of objects providing configuration for
SIP Proxy servers."
::= { sipServerMIBGroups 3 }
sipProxyStatsGroup OBJECT-GROUP
OBJECTS {
sipNumProxyRequireFailures
}
STATUS current
DESCRIPTION
"A collection of objects providing statistics for
SIP Proxy servers."
::= { sipServerMIBGroups 4 }
--sipProxyNotifGroup NOTIFICATION-GROUP
-- OBJECTS {
-- none at this time
-- }
-- STATUS current
-- DESCRIPTION
Lingle/Maeng/Walker 60
-- "A collection of notifications defined for SIP
-- Proxy servers."
-- ::= { sipServerMIBGroups 5 }
--sipRedirectConfigGroup OBJECT-GROUP
-- OBJECTS {
-- none at this time
-- }
-- STATUS current
-- DESCRIPTION
-- "A collection of objects providing configuration for
-- SIP Redirect servers."
-- ::= { sipServerMIBGroups 6 }
--sipRedirectStatsGroup OBJECT-GROUP
-- OBJECTS {
-- none at this time
-- }
-- STATUS current
-- DESCRIPTION
-- "A collection of objects providing statistics for
-- SIP Redirect servers."
-- ::= { sipServerMIBGroups 7 }
--sipRedirectNotifGroup NOTIFICATION-GROUP
-- OBJECTS {
-- none at this time
-- }
-- STATUS current
-- DESCRIPTION
-- "A collection of notifications defined for SIP
-- Redirect servers."
-- ::= { sipServerMIBGroups 8 }
END
5.6. SIP Registrar
SIP-REGISTRAR-MIB DEFINITIONS ::= BEGIN
IMPORTS
MODULE-IDENTITY,
OBJECT-TYPE,
Counter32,
Gauge32,
Unsigned32
FROM SNMPv2-SMI
DateAndTime,
RowStatus,
TimeStamp,
TruthValue
FROM SNMPv2-TC
Lingle/Maeng/Walker 61
MODULE-COMPLIANCE,
OBJECT-GROUP
FROM SNMPv2-CONF
SnmpAdminString
FROM SNMP-FRAMEWORK-MIB
SipServerActions
FROM SIP-TC
sipMIB
FROM SIP-MIB-SMI
applIndex
FROM NETWORK-SERVICES-MIB;
sipRegistrarMIB MODULE-IDENTITY
LAST-UPDATED "200007080000Z"
ORGANIZATION "IETF SIP Working Group, SIP MIB Team"
CONTACT-INFO
"SIP MIB Team email: sip-mib@egroups.com
Co-editor Kevin Lingle
Cisco Systems, Inc.
postal: 7025 Kit Creek Road
P.O. Box 14987
Research Triangle Park, NC 27709
USA
email: klingle@cisco.com
phone: +1-919-392-2029
Co-editor Joon Maeng
VTEL Corporation
postal: 108 Wild Basin Rd.
Austin, TX 78746
USA
email: joon_maeng@vtel.com
phone: +1-512-437-4567
Co-editor Dave Walker
SS8 Networks, Inc.
postal: 80 Hines Road
Kanata, ON K2K 2T8
Canada
email: drwalker@ss8networks.com
phone: +1 613 592 2100"
DESCRIPTION
"Initial version of Session Initiation Protocol (SIP)
Registrar MIB module.
SIP is an application-layer signalling protocol for
creating, modifying and terminating multimedia
sessions with one or more participants. These sessions
Lingle/Maeng/Walker 62
include Internet multimedia conferences and Internet
telephone calls. SIP is defined in RFC 2543 (March
1999).
A Registrar is a server that accepts REGISTER
requests. A Registrar is typically co-located with a
Proxy or Redirect Server."
::= { sipMIB 5 }
--
-- sipReg group -- sipReg group
-- This group contains MIB objects related to SIP Registrars. -- This group contains MIB objects related to SIP Registrars.
-- --
sipRegCfg OBJECT IDENTIFIER ::= { sipRegistrarMIB 1 } sipReg OBJECT IDENTIFIER ::= { sipServerMIB 5 }
sipRegStats OBJECT IDENTIFIER ::= { sipRegistrarMIB 2 } sipRegCfg OBJECT IDENTIFIER ::= { sipReg 1 }
sipRegStats OBJECT IDENTIFIER ::= { sipReg 2 }
Lingle/Maeng/Mule/Walker 71
-- --
-- Registrar Configuration -- Registrar Configuration
-- --
sipRegCfgTable OBJECT-TYPE sipRegCfgTable OBJECT-TYPE
SYNTAX SEQUENCE OF SipRegCfgEntry SYNTAX SEQUENCE OF SipRegCfgEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table contains configuration objects applicable "This table contains configuration objects applicable
SIP registrars. Each row represents those objects SIP registrars. Each row represents those objects
skipping to change at line 3460 skipping to change at line 4103
::= { sipRegCfgTable 1 } ::= { sipRegCfgTable 1 }
SipRegCfgEntry ::= SipRegCfgEntry ::=
SEQUENCE { SEQUENCE {
sipRegAllowThirdParty TruthValue, sipRegAllowThirdParty TruthValue,
sipRegContactDfltExpiryDuration Unsigned32, sipRegContactDfltExpiryDuration Unsigned32,
sipRegContactDfltExpiryDate DateAndTime, sipRegContactDfltExpiryDate DateAndTime,
sipRegMaxContactExpiryDate Unsigned32, sipRegMaxContactExpiryDate Unsigned32,
sipRegRespHasContacts TruthValue, sipRegRespHasContacts TruthValue,
sipRegMaxUsers Unsigned32, sipRegMaxUsers Unsigned32,
sipRegCurrentUsers Gauge32 sipRegCurrentUsers Gauge32,
sipRegDfltRegActiveInterval Unsigned32
} }
sipRegAllowThirdParty OBJECT-TYPE sipRegAllowThirdParty OBJECT-TYPE
Lingle/Maeng/Walker 63
SYNTAX TruthValue SYNTAX TruthValue
MAX-ACCESS read-write MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object specifies whether or not the Registrar should "This object specifies whether or not the Registrar should
allows third party registrations. In third-party allows third party registrations. In third-party
registration, the entity issuing the request (in the From registration, the entity issuing the request (in the From
header) is different from the entity being registered (in header) is different from the entity being registered (in
the To header) to whom the the To header) to whom the
provided Contact information applies. provided Contact information applies.
If the value of this object is TRUE, the Registrar allows If the value of this object is TRUE, the Registrar allows
third party registrations. If the value is FALSE, third third party registrations. If the value is FALSE, third
party registrations are rejected: a 403 Forbidden status party registrations are rejected: a 403 Forbidden status
code is returned to the requestor." code is returned to the requestor."
REFERENCE REFERENCE
"RFC 2543, Section 4.2.6" "RFC 2543, Section 4.2.6"
::= { sipRegCfgEntry 1 } ::= { sipRegCfgEntry 1 }
Lingle/Maeng/Mule/Walker 72
sipRegContactDfltExpiryDuration OBJECT-TYPE sipRegContactDfltExpiryDuration OBJECT-TYPE
SYNTAX Unsigned32 SYNTAX Unsigned32
UNITS "seconds" UNITS "seconds"
MAX-ACCESS read-write MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object specifies the default expiration (time-to- "This object specifies the default expiration (time-to-
live) of Contact information that is provided by User live) of Contact information that is provided by User
Agents when registering with this Registrar. This value Agents when registering with this Registrar. This value
is only used when no expiration has been specified by the is only used when no expiration has been specified by the
skipping to change at line 3520 skipping to change at line 4163
::= { sipRegCfgEntry 2 } ::= { sipRegCfgEntry 2 }
sipRegContactDfltExpiryDate OBJECT-TYPE sipRegContactDfltExpiryDate OBJECT-TYPE
SYNTAX DateAndTime SYNTAX DateAndTime
MAX-ACCESS read-write MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object specifies the default expiration date (time- "This object specifies the default expiration date (time-
to-live) of Contact information that is provided by User to-live) of Contact information that is provided by User
Agents when registering with this Registrar. This value Agents when registering with this Registrar. This value
Lingle/Maeng/Walker 64
is only used when no expiration has been specified by the is only used when no expiration has been specified by the
user in the REGISTER request. user in the REGISTER request.
If this value is applied to a registration, the server If this value is applied to a registration, the server
must return the value to the registered User Agent. must return the value to the registered User Agent.
The value contained in this object only applies if the The value contained in this object only applies if the
value of the sipContactDfltExpiryDuration object is zero. value of the sipContactDfltExpiryDuration object is zero.
If the value of this object applies, and is NULL, then no If the value of this object applies, and is NULL, then no
default expiry is applied to default expiry is applied to
skipping to change at line 3544 skipping to change at line 4185
"RFC 2543, Section 4.2.6" "RFC 2543, Section 4.2.6"
::= { sipRegCfgEntry 3 } ::= { sipRegCfgEntry 3 }
sipRegMaxContactExpiryDate OBJECT-TYPE sipRegMaxContactExpiryDate OBJECT-TYPE
SYNTAX Unsigned32 (0..4294967295) SYNTAX Unsigned32 (0..4294967295)
UNITS "seconds" UNITS "seconds"
MAX-ACCESS read-write MAX-ACCESS read-write
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object specifies the maximum expiry that may be "This object specifies the maximum expiry that may be
Lingle/Maeng/Mule/Walker 73
requested by a User Agent for a particular Contact. User requested by a User Agent for a particular Contact. User
Agents can specify expiry using either an Expiry header in Agents can specify expiry using either an Expiry header in
a REGISTER request, or using an Expires parameter in a a REGISTER request, or using an Expires parameter in a
Contact header in a REGISTER request. If the value Contact header in a REGISTER request. If the value
requested by the User Agent is greater than the value of requested by the User Agent is greater than the value of
this object, then the contact information is given the this object, then the contact information is given the
duration specified by this object, and that duration duration specified by this object, and that duration
is indicated to the User Agent in the response." is indicated to the User Agent in the response."
DEFVAL { 4294967295 } DEFVAL { 4294967295 }
::= { sipRegCfgEntry 4 } ::= { sipRegCfgEntry 4 }
skipping to change at line 3576 skipping to change at line 4219
the locations in the REGISTER response. If the value is the locations in the REGISTER response. If the value is
FALSE, no location information is provided." FALSE, no location information is provided."
::= { sipRegCfgEntry 5 } ::= { sipRegCfgEntry 5 }
sipRegMaxUsers OBJECT-TYPE sipRegMaxUsers OBJECT-TYPE
SYNTAX Unsigned32 (1..4294967295) SYNTAX Unsigned32 (1..4294967295)
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object specifies the maximum number of users that the "This object specifies the maximum number of users that the
Lingle/Maeng/Walker 65
registrar supports. The current number of users is registrar supports. The current number of users is
reflected by sipRegCurrentUsers." reflected by sipRegCurrentUsers."
::= { sipRegCfgEntry 6 } ::= { sipRegCfgEntry 6 }
sipRegCurrentUsers OBJECT-TYPE sipRegCurrentUsers OBJECT-TYPE
SYNTAX Gauge32 (0..4294967295) SYNTAX Gauge32 (0..4294967295)
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object specifies the number of users currently "This object specifies the number of users currently
configured on the registrar." configured on the registrar."
::= { sipRegCfgEntry 7 } ::= { sipRegCfgEntry 7 }
sipRegDfltRegActiveInterval OBJECT-TYPE
SYNTAX Unsigned32 (1..4294967295)
UNITS "seconds"
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object specifies the default time interval the
Registrar considers registrations to be active. The
value is used to compute the Expires header in the
REGISTER response. If a user agent requests a time
interval shorter than specified by this object, the
Registrar should honor that request."
Lingle/Maeng/Mule/Walker 74
REFERENCE "Expires header, section 6.23 RFC2543"
::= { sipRegCfgEntry 8 }
-- --
-- Per User Information -- Per User Information
-- --
sipRegUserTable OBJECT-TYPE sipRegUserTable OBJECT-TYPE
SYNTAX SEQUENCE OF SipRegUserEntry SYNTAX SEQUENCE OF SipRegUserEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table contains information on all users registered to "This table contains information on all users registered to
each Registrar in this system. The instances of SIP each Registrar in this system. The instances of SIP
skipping to change at line 3632 skipping to change at line 4290
sipUserIndex OBJECT-TYPE sipUserIndex OBJECT-TYPE
SYNTAX Unsigned32 (1..4294967295) SYNTAX Unsigned32 (1..4294967295)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object uniquely identifies a conceptual row in the "This object uniquely identifies a conceptual row in the
table." table."
::= { sipRegUserEntry 1 } ::= { sipRegUserEntry 1 }
Lingle/Maeng/Walker 66
sipUserUri OBJECT-TYPE sipUserUri OBJECT-TYPE
SYNTAX SnmpAdminString SYNTAX SnmpAdminString
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object contains the user's address-of-record. It is "This object contains the user's address-of-record. It is
the main form by which the registrar knows the user. The the main form by which the registrar knows the user. The
format is typically 'user@domain'. It is contained in the format is typically 'user@domain'. It is contained in the
To header for all REGISTER requests." To header for all REGISTER requests."
::= { sipRegUserEntry 2 } ::= { sipRegUserEntry 2 }
sipUserPassword OBJECT-TYPE sipUserPassword OBJECT-TYPE
SYNTAX OCTET STRING (SIZE(0..255)) SYNTAX OCTET STRING (SIZE(0..255))
Lingle/Maeng/Mule/Walker 75
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object specifies the password that the user must "This object specifies the password that the user must
enter when being authenticated." enter when being authenticated."
::= { sipRegUserEntry 3 } ::= { sipRegUserEntry 3 }
sipUserAuthenticationFailures OBJECT-TYPE sipUserAuthenticationFailures OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
MAX-ACCESS read-only MAX-ACCESS read-only
skipping to change at line 3681 skipping to change at line 4340
-- --
-- Per Contact Information -- Per Contact Information
-- --
sipContactTable OBJECT-TYPE sipContactTable OBJECT-TYPE
SYNTAX SEQUENCE OF SipContactEntry SYNTAX SEQUENCE OF SipContactEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table contains information on every location where a "This table contains information on every location where a
registered user (specified by sipUserIndex) wishes to be registered user (specified by sipUserIndex) wishes to be
found (i.e. has provided Contact information) to each SIP found (i.e. the user has provided Contact information to
Registrar in this system. each SIP Registrar in this system).
The instances of SIP Registrar are uniquely identified by The instances of SIP Registrar are uniquely identified by
applIndex." applIndex."
::= { sipRegCfg 3 } ::= { sipRegCfg 3 }
Lingle/Maeng/Walker 67
sipContactEntry OBJECT-TYPE sipContactEntry OBJECT-TYPE
SYNTAX SipContactEntry SYNTAX SipContactEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This entry contains information for a single Contact. "This entry contains information for a single Contact.
Multiple contacts may exist for a single user." Multiple contacts may exist for a single user."
INDEX { applIndex, sipUserIndex, sipContactIndex } INDEX { applIndex, sipUserIndex, sipContactIndex }
::= { sipContactTable 1 } ::= { sipContactTable 1 }
SipContactEntry ::= SipContactEntry ::=
SEQUENCE { SEQUENCE {
sipContactIndex Unsigned32, sipContactIndex Unsigned32,
sipContactDisplayName SnmpAdminString, sipContactDisplayName SnmpAdminString,
sipContactURI SnmpAdminString, sipContactURI SnmpAdminString,
Lingle/Maeng/Mule/Walker 76
sipContactLastUpdated TimeStamp, sipContactLastUpdated TimeStamp,
sipContactExpiry DateAndTime, sipContactExpiry DateAndTime,
sipContactAction SipServerActions,
sipContactPreference OCTET STRING, sipContactPreference OCTET STRING,
sipContactAction INTEGER,
sipContactRetryAfter DateAndTime sipContactRetryAfter DateAndTime
} }
sipContactIndex OBJECT-TYPE sipContactIndex OBJECT-TYPE
SYNTAX Unsigned32 (1..4294967295) SYNTAX Unsigned32 (1..4294967295)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Along with the sipUserIndex, this object uniquely "Along with the sipUserIndex, this object uniquely
identifies a conceptual row in the table." identifies a conceptual row in the table."
skipping to change at line 3742 skipping to change at line 4402
sipContactURI OBJECT-TYPE sipContactURI OBJECT-TYPE
SYNTAX SnmpAdminString SYNTAX SnmpAdminString
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object contains either a SIP URL or a URI where the "This object contains either a SIP URL or a URI where the
user can be contacted. This URI is normally returned to a user can be contacted. This URI is normally returned to a
client from a redirect server, or is used as the client from a redirect server, or is used as the
RequestURI in a SIP request line for requests forwarded by RequestURI in a SIP request line for requests forwarded by
a proxy." a proxy."
Lingle/Maeng/Walker 68
::= { sipContactEntry 3 } ::= { sipContactEntry 3 }
sipContactLastUpdated OBJECT-TYPE sipContactLastUpdated OBJECT-TYPE
SYNTAX TimeStamp SYNTAX TimeStamp
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object indicates the time when this contact "This object indicates the time when this contact
information was accepted. If the contact information is information was accepted. If the contact information is
updated via a subsequent REGISTER of the same information, updated via a subsequent REGISTER of the same information,
this object is also updated." this object is also updated."
::= { sipContactEntry 4 } ::= { sipContactEntry 4 }
sipContactExpiry OBJECT-TYPE sipContactExpiry OBJECT-TYPE
SYNTAX DateAndTime SYNTAX DateAndTime
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object contains the date and time when the contact "This object contains the date and time when the contact
Lingle/Maeng/Mule/Walker 77
information will no longer be valid. Such times may be information will no longer be valid. Such times may be
specified by the user at registration (Expires header or specified by the user at registration (Expires header or
expiry parameter in the Contact information), or a system expiry parameter in the Contact information), or a system
default can be applied." default can be applied."
::= { sipContactEntry 5 } ::= { sipContactEntry 5 }
sipContactPreference OBJECT-TYPE sipContactPreference OBJECT-TYPE
SYNTAX OCTET STRING (SIZE(0..255)) SYNTAX OCTET STRING (SIZE(0..255))
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
skipping to change at line 3787 skipping to change at line 4447
parameter in the Contact header. parameter in the Contact header.
The format of this item is a decimal number between 0 The format of this item is a decimal number between 0
and 1 (for example 0.9). Higher values indicate locations and 1 (for example 0.9). Higher values indicate locations
preferred by the user." preferred by the user."
REFERENCE REFERENCE
"RFC 2543, Section 6.13" "RFC 2543, Section 6.13"
::= { sipContactEntry 6 } ::= { sipContactEntry 6 }
sipContactAction OBJECT-TYPE sipContactAction OBJECT-TYPE
SYNTAX SipServerActions SYNTAX INTEGER {
redirect(1),
proxy(2)
}
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object indicates whether the user wanted the server "This object indicates whether the user wanted the server
to act as a redirect server or as a proxy server. It is to act as a redirect server or as a proxy server. It is
specified by the optional 'action' parameter in the specified by the optional 'action' parameter in the
Contact header." Contact header."
::= { sipContactEntry 7 } ::= { sipContactEntry 7 }
sipContactRetryAfter OBJECT-TYPE sipContactRetryAfter OBJECT-TYPE
Lingle/Maeng/Walker 69
SYNTAX DateAndTime SYNTAX DateAndTime
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object indicates that the contact information is "This object indicates that the contact information is
currently inactive, and that it should only be activated currently inactive, and that it should only be activated
after the date and time specified by the object. This after the date and time specified by the object. This
value is provided by a user when deleting contact value is provided by a user when deleting contact
information using a REGISTER request containing a Retry- information using a REGISTER request containing a Retry-
After header." After header."
REFERENCE REFERENCE
"RFC 2543, Section 6.32" "RFC 2543, Section 6.32"
::= { sipContactEntry 8 } ::= { sipContactEntry 8 }
-- --
-- Registrar Statistics -- Registrar Statistics
-- --
sipRegStatsTable OBJECT-TYPE sipRegStatsTable OBJECT-TYPE
Lingle/Maeng/Mule/Walker 78
SYNTAX SEQUENCE OF SipRegStatsEntry SYNTAX SEQUENCE OF SipRegStatsEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table contains the summary statistics objects "This table contains the summary statistics objects
applicable to all SIP Registrars in this system. applicable to all SIP Registrars in this system.
Each row represents those objects for a particular Each row represents those objects for a particular
SIP Registrar. The instances of SIP Registrars are SIP Registrar. The instances of SIP Registrars are
uniquely identified by applIndex." uniquely identified by applIndex."
::= { sipRegStats 1 } ::= { sipRegStats 1 }
skipping to change at line 3851 skipping to change at line 4514
sipRegRejectedRegistrations Counter32 sipRegRejectedRegistrations Counter32
} }
sipRegAcceptedRegistrations OBJECT-TYPE sipRegAcceptedRegistrations OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object contains a count of the number of REGISTER "This object contains a count of the number of REGISTER
requests that have been accepted (status code 200) by the requests that have been accepted (status code 200) by the
Lingle/Maeng/Walker 70
Registrar. This includes additions of new contact Registrar. This includes additions of new contact
information, refreshing contact information, as well as information, refreshing contact information, as well as
requests for deletion of contact information." requests for deletion of contact information."
::= { sipRegStatsEntry 1 } ::= { sipRegStatsEntry 1 }
sipRegRejectedRegistrations OBJECT-TYPE sipRegRejectedRegistrations OBJECT-TYPE
SYNTAX Counter32 SYNTAX Counter32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object contains a count of the number REGISTER "This object contains a count of the number REGISTER
requests that have been rejected by the Registrar." requests that have been rejected by the Registrar."
::= { sipRegStatsEntry 2 } ::= { sipRegStatsEntry 2 }
-- --
-- Notifications -- Notifications
-- --
sipRegMIBNotif OBJECT IDENTIFIER ::= { sipRegistrarMIB 3 } sipServerMIBNotif OBJECT IDENTIFIER ::= { sipServerMIB 5 }
sipProxyNotif OBJECT IDENTIFIER ::= { sipServerMIBNotif 1 }
sipRedirNotif OBJECT IDENTIFIER ::= { sipServerMIBNotif 2 }
-- none at this time -- none at this time
Lingle/Maeng/Mule/Walker 79
-- --
-- Conformance -- Conformance
-- --
sipRegMIBConformance sipServerMIBConformance
OBJECT IDENTIFIER ::= { sipRegistrarMIB 4 } OBJECT IDENTIFIER ::= { sipServerMIB 6 }
sipRegMIBCompliances sipServerMIBCompliances
OBJECT IDENTIFIER ::= { sipRegMIBConformance 1 } OBJECT IDENTIFIER ::= { sipServerMIBConformance 1 }
sipRegMIBGroups sipServerMIBGroups
OBJECT IDENTIFIER ::= { sipRegMIBConformance 2 } OBJECT IDENTIFIER ::= { sipServerMIBConformance 2 }
-- --