mibs/ietf/SIP-SERVER-MIB

   1 SIP-SERVER-MIB DEFINITIONS ::= BEGIN
   2
   3 IMPORTS
   4     MODULE-IDENTITY,
   5     OBJECT-TYPE,
   6     Counter32,
   7     Unsigned32,
   8     Gauge32,
   9     mib-2
  10           FROM SNMPv2-SMI             -- RFC 2578
  11
  12     TruthValue,
  13     TimeStamp, DateAndTime
  14           FROM SNMPv2-TC              -- RFC 2579
  15
  16     MODULE-COMPLIANCE,
  17     OBJECT-GROUP
  18           FROM SNMPv2-CONF            -- RFC 2580
  19
  20     SnmpAdminString
  21           FROM SNMP-FRAMEWORK-MIB     -- RFC 3411
  22
  23
  24     applIndex
  25           FROM NETWORK-SERVICES-MIB   -- RFC 2788
  26
  27     InetAddressType,
  28     InetAddress
  29           FROM INET-ADDRESS-MIB;      -- RFC 4001
  30
  31 sipServerMIB MODULE-IDENTITY
  32     LAST-UPDATED   "200704200000Z"
  33     ORGANIZATION   "IETF Session Initiation Protocol
  34                     Working Group"
  35     CONTACT-INFO
  36        "SIP WG email: sip@ietf.org
  37
  38            Co-editor: Kevin Lingle
  39                       Cisco Systems, Inc.
  40               postal: 7025 Kit Creek Road
  41                       P.O. Box 14987
  42                       Research Triangle Park, NC 27709
  43                       USA
  44              email:   klingle@cisco.com
  45              phone:   +1 919 476 2029
  46
  47            Co-editor: Joon Maeng
  48                email: jmaeng@austin.rr.com
  49
  50            Co-editor: Jean-Francois Mule
  51                       CableLabs
  52               postal: 858 Coal Creek Circle
  53                       Louisville, CO 80027
  54                       USA
  55                email: jf.mule@cablelabs.com
  56                phone: +1 303 661 9100
  57
  58            Co-editor: Dave Walker
  59                email: drwalker@rogers.com
  60           "
  61     DESCRIPTION
  62        "Session Initiation Protocol (SIP) Server MIB module.  SIP is an
  63         application-layer signaling protocol for creating, modifying,
  64         and terminating multimedia sessions with one or more
  65         participants.  These sessions include Internet multimedia
  66         conferences and Internet telephone calls.  SIP is defined in
  67         RFC 3261 (June 2002).
  68
  69         This MIB is defined for the management of SIP Proxy, Redirect,
  70         and Registrar Servers.
  71
  72
  73
  74         A Proxy Server acts as both a client and a server.  It accepts
  75         requests from other clients, either responding to them or
  76         passing them on to other servers, possibly after modification.
  77
  78         A Redirect Server accepts requests from clients and returns
  79         zero or more addresses to that client.  Unlike a User Agent
  80         Server, it does not accept calls.
  81
  82         A Registrar is a server that accepts REGISTER requests.  A
  83         Registrar is typically co-located with a Proxy or Redirect
  84         Server.
  85
  86         Copyright (C) The IETF Trust (2007).  This version of
  87         this MIB module is part of RFC 4780; see the RFC itself for
  88         full legal notices."
  89     REVISION        "200704200000Z"
  90     DESCRIPTION
  91        "Initial version of the IETF SIP-SERVER-MIB module.  This
  92        version published as part of RFC 4780."
  93   ::= { mib-2 151 }
  94
  95 -- Top-Level Components of this MIB.
  96
  97 sipServerMIBObjects     OBJECT IDENTIFIER ::= { sipServerMIB 1 }
  98 sipServerMIBConformance OBJECT IDENTIFIER ::= { sipServerMIB 2 }
  99
 100 --
 101 -- These groups contain objects common to all SIP servers.
 102 --
 103 sipServerCfg            OBJECT IDENTIFIER ::= { sipServerMIBObjects 1 }
 104
 105 --
 106 -- Common Server Configuration Objects
 107 --
 108 sipServerCfgTable OBJECT-TYPE
 109     SYNTAX      SEQUENCE OF SipServerCfgEntry
 110     MAX-ACCESS  not-accessible
 111     STATUS      current
 112     DESCRIPTION
 113        "This table contains configuration objects applicable to SIP
 114         Redirect and Proxy Servers."
 115     ::= { sipServerCfg 1 }
 116
 117 sipServerCfgEntry OBJECT-TYPE
 118     SYNTAX      SipServerCfgEntry
 119     MAX-ACCESS  not-accessible
 120     STATUS      current
 121     DESCRIPTION
 122
 123
 124        "A row of common configuration.
 125
 126         Each row represents those objects for a particular SIP server
 127         present in this system.  applIndex is used to uniquely identify
 128         these instances of SIP servers and correlate them through
 129         the common framework of the NETWORK-SERVICES-MIB (RFC 2788).
 130         The same value of applIndex used in the corresponding
 131         SIP-COMMON-MIB is used here."
 132     INDEX { applIndex }
 133     ::= { sipServerCfgTable 1 }
 134
 135 SipServerCfgEntry ::=
 136     SEQUENCE {
 137         sipServerCfgHostAddressType       InetAddressType,
 138         sipServerCfgHostAddress           InetAddress
 139     }
 140
 141 sipServerCfgHostAddressType OBJECT-TYPE
 142     SYNTAX      InetAddressType
 143     MAX-ACCESS  read-only
 144
 145     STATUS      current
 146     DESCRIPTION
 147        "The type of Internet address by which the SIP server is
 148         reachable."
 149     REFERENCE
 150        "RFC 3261, Section 19.1.1"
 151     ::= { sipServerCfgEntry 1 }
 152
 153 sipServerCfgHostAddress OBJECT-TYPE
 154     SYNTAX      InetAddress
 155     MAX-ACCESS  read-only
 156     STATUS      current
 157     DESCRIPTION
 158        "This is the host portion of a SIP URI that is assigned to the
 159         SIP server.  It MAY contain a fully qualified domain name or
 160         an IP address.  The length of the value will depend on the type
 161         of address specified.  The type of address given by this object
 162         is controlled by sipServerCfgHostAddressType."
 163     REFERENCE
 164        "RFC 3261, Section 19.1.1"
 165     ::= { sipServerCfgEntry 2 }
 166
 167 --
 168 -- This group contains MIB objects
 169 -- related to SIP Proxy Servers.
 170 --
 171 sipServerProxyCfg      OBJECT IDENTIFIER ::= { sipServerMIBObjects 3 }
 172
 173
 174 sipServerProxyStats    OBJECT IDENTIFIER ::= { sipServerMIBObjects 4 }
 175
 176 --
 177 -- Proxy Server Configuration
 178 --
 179 sipServerProxyCfgTable OBJECT-TYPE
 180     SYNTAX      SEQUENCE OF SipServerProxyCfgEntry
 181     MAX-ACCESS  not-accessible
 182     STATUS      current
 183     DESCRIPTION
 184        "This table contains configuration objects applicable to SIP
 185         Proxy Servers."
 186     ::= { sipServerProxyCfg 1 }
 187
 188 sipServerProxyCfgEntry OBJECT-TYPE
 189     SYNTAX      SipServerProxyCfgEntry
 190     MAX-ACCESS  not-accessible
 191     STATUS      current
 192     DESCRIPTION
 193        "A row of common proxy configuration.
 194
 195         Each row represents those objects for a particular SIP server
 196         present in this system.  applIndex is used to uniquely identify
 197         these instances of SIP servers and correlate them through the
 198         common framework of the NETWORK-SERVICES-MIB (RFC 2788).  The
 199         same value of applIndex used in the corresponding
 200         SIP-COMMON-MIB is used here."
 201     INDEX { applIndex }
 202     ::= { sipServerProxyCfgTable 1 }
 203
 204 SipServerProxyCfgEntry ::=
 205     SEQUENCE {
 206         sipServerCfgProxyStatefulness     INTEGER,
 207         sipServerCfgProxyRecursion        TruthValue,
 208         sipServerCfgProxyRecordRoute      TruthValue,
 209         sipServerCfgProxyAuthMethod       BITS,
 210         sipServerCfgProxyAuthDefaultRealm SnmpAdminString
 211     }
 212
 213 sipServerCfgProxyStatefulness OBJECT-TYPE
 214     SYNTAX      INTEGER {
 215                   stateless(1),
 216                   transactionStateful(2),
 217                   callStateful(3)
 218                 }
 219     MAX-ACCESS  read-only
 220     STATUS      current
 221     DESCRIPTION
 222
 223
 224
 225        "This object reflects the default mode of operation for the
 226         Proxy Server entity.
 227
 228         A stateless proxy is a logical entity that does not maintain
 229         the client or server transaction state machines when it
 230         processes requests.  A stateless proxy forwards every request it
 231         receives downstream and every response it receives upstream.  If
 232         the value of this object is stateless(1), the proxy defaults to
 233         stateless operations.
 234
 235         A transaction stateful proxy, or simply a 'stateful proxy', is
 236         a logical entity that maintains the client and server
 237         transaction state machines during the processing of a request.
 238         A (transaction) stateful proxy is not the same as a call
 239         stateful proxy.  If the value of this object is
 240         transactionStateful(2), the proxy is stateful on a transaction
 241         basis.
 242
 243         A call stateful proxy is a logical entity if it retains state
 244         for a dialog from the initiating INVITE to the terminating BYE
 245         request.  A call stateful proxy is always transaction stateful,
 246         but the converse is not necessarily true.  If the value of this
 247         object is callStateful(3), the proxy is call stateful."
 248
 249     REFERENCE
 250         "RFC 3261, Section 16"
 251     ::= { sipServerProxyCfgEntry 1 }
 252
 253 sipServerCfgProxyRecursion OBJECT-TYPE
 254     SYNTAX      TruthValue
 255     MAX-ACCESS  read-only
 256     STATUS      current
 257     DESCRIPTION
 258        "This object reflects whether or not the Proxy performs a
 259         recursive search on the Contacts provided in 3xx redirects.
 260
 261         If the value of this object is 'true', a recursive search is
 262         performed.  If the value is 'false', no search is performed,
 263         and the 3xx response is sent upstream towards the source of
 264         the request."
 265     REFERENCE
 266        "RFC 3261 Sections 16.5 and 16.6"
 267     ::= { sipServerProxyCfgEntry 2 }
 268
 269 sipServerCfgProxyRecordRoute OBJECT-TYPE
 270     SYNTAX     TruthValue
 271     MAX-ACCESS read-only
 272     STATUS     current
 273
 274
 275     DESCRIPTION
 276        "This object reflects whether or not the proxy adds itself to
 277         the Record-Route header as a default action.  This header is
 278         used to list the proxies that insist on being in the signaling
 279         path for subsequent requests related to the call leg.
 280
 281         If the value of this object is 'true', the proxy adds itself to
 282         the end of the Record-Route header, creating the header if
 283         required.  If the value is 'false', the proxy does not add
 284         itself to the Record-Route header."
 285     REFERENCE
 286        "RFC 3261, Section 20.30"
 287     ::= { sipServerProxyCfgEntry 3 }
 288
 289 --
 290 -- Security
 291 --
 292 sipServerCfgProxyAuthMethod OBJECT-TYPE
 293     SYNTAX      BITS {
 294                   none(0),
 295                   tls(1),
 296                   digest(2)
 297                 }
 298     MAX-ACCESS  read-only
 299     STATUS      current
 300     DESCRIPTION
 301        "This object reflects the authentication methods that MAY be
 302         used to authenticate request originators.
 303
 304         bit 0  no authentication is performed
 305         bit 1  TLS is used
 306         bit 2  HTTP Digest is used."
 307     REFERENCE
 308        "RFC 3261 Sections 22, 23, 26, 26.2.3"
 309     ::= { sipServerProxyCfgEntry 4 }
 310
 311 sipServerCfgProxyAuthDefaultRealm OBJECT-TYPE
 312     SYNTAX      SnmpAdminString
 313     MAX-ACCESS  read-only
 314     STATUS      current
 315     DESCRIPTION
 316        "This object reflects the default realm value used in
 317         Proxy-Authenticate headers.  Note that this MAY need to be
 318         stored per user, in which case, this default value is ignored.
 319        "
 320     REFERENCE
 321        "RFC 3261, Section 22.1"
 322     ::= { sipServerProxyCfgEntry 5 }
 323
 324
 325 --
 326 -- Proxy Server Statistics
 327 --
 328 sipServerProxyStatsTable OBJECT-TYPE
 329     SYNTAX      SEQUENCE OF SipServerProxyStatsEntry
 330     MAX-ACCESS  not-accessible
 331
 332     STATUS      current
 333     DESCRIPTION
 334        "This table contains the statistics objects applicable to all
 335         SIP Proxy Servers in this system."
 336     ::= { sipServerProxyStats 1 }
 337
 338 sipServerProxyStatsEntry OBJECT-TYPE
 339     SYNTAX      SipServerProxyStatsEntry
 340     MAX-ACCESS  not-accessible
 341     STATUS      current
 342     DESCRIPTION
 343        "A row of summary statistics.
 344
 345         Each row represents those objects for a particular SIP server
 346         present in this system.  applIndex is used to uniquely identify
 347         these instances of SIP servers and correlate them through the
 348         common framework of the NETWORK-SERVICES-MIB (RFC 2788).  The
 349         same value of applIndex used in the corresponding
 350         SIP-COMMON-MIB is used here."
 351     INDEX { applIndex }
 352     ::= { sipServerProxyStatsTable 1 }
 353
 354 SipServerProxyStatsEntry ::=
 355     SEQUENCE {
 356         sipServerProxyStatProxyReqFailures Counter32,
 357         sipServerProxyStatsDisconTime      TimeStamp
 358     }
 359
 360 sipServerProxyStatProxyReqFailures OBJECT-TYPE
 361     SYNTAX      Counter32
 362     MAX-ACCESS  read-only
 363     STATUS      current
 364     DESCRIPTION
 365        "This object contains the number of occurrences of unsupported
 366         options being specified in received Proxy-Require headers.
 367         Such occurrences result in a 420 Bad Extension status code
 368         being returned.
 369
 370         Discontinuities in the value of this counter can occur at
 371         re-initialization of the SIP entity or service.  A Management
 372         Station can detect discontinuities in this counter by
 373
 374
 375         monitoring the sipServerProxyStatsDisconTime object in the same
 376         row."
 377     ::= { sipServerProxyStatsEntry 1 }
 378
 379 sipServerProxyStatsDisconTime OBJECT-TYPE
 380  SYNTAX      TimeStamp
 381  MAX-ACCESS  read-only
 382  STATUS      current
 383  DESCRIPTION
 384     "The value of the sysUpTime object when the counters for the server
 385      statistics objects in this row last experienced a discontinuity."
 386  ::= { sipServerProxyStatsEntry 2 }
 387
 388 --
 389 -- This group contains MIB objects related to SIP Registrars.
 390 --
 391 sipServerRegCfg         OBJECT IDENTIFIER ::= { sipServerMIBObjects 5 }
 392 sipServerRegStats       OBJECT IDENTIFIER ::= { sipServerMIBObjects 6 }
 393
 394 --
 395 -- Registrar Configuration
 396 --
 397 sipServerRegCfgTable OBJECT-TYPE
 398     SYNTAX      SEQUENCE OF SipServerRegCfgEntry
 399     MAX-ACCESS  not-accessible
 400     STATUS      current
 401     DESCRIPTION
 402        "This table contains configuration objects applicable to SIP
 403         Registrars."
 404     ::= { sipServerRegCfg 1 }
 405
 406 sipServerRegCfgEntry OBJECT-TYPE
 407     SYNTAX      SipServerRegCfgEntry
 408     MAX-ACCESS  not-accessible
 409     STATUS      current
 410     DESCRIPTION
 411        "A row of common Registrar configuration.
 412
 413         Each row represents those objects for a particular SIP server
 414         present in this system.  applIndex is used to uniquely identify
 415         these instances of SIP servers and correlate them through the
 416         common framework of the NETWORK-SERVICES-MIB (RFC 2788).  The
 417         same value of applIndex used in the corresponding
 418         SIP-COMMON-MIB is used here."
 419     INDEX { applIndex }
 420     ::= { sipServerRegCfgTable 1 }
 421
 422 SipServerRegCfgEntry ::=
 423
 424
 425     SEQUENCE {
 426         sipServerRegMaxContactExpiryDuration  Unsigned32,
 427         sipServerRegMaxUsers                  Unsigned32,
 428         sipServerRegCurrentUsers              Gauge32,
 429         sipServerRegDfltRegActiveInterval     Unsigned32
 430     }
 431
 432 sipServerRegMaxContactExpiryDuration OBJECT-TYPE
 433     SYNTAX      Unsigned32 (0..4294967295)
 434     UNITS      "seconds"
 435     MAX-ACCESS  read-only
 436     STATUS      current
 437     DESCRIPTION
 438        "This object reflects the maximum expiry that may be requested
 439         by a User Agent for a particular Contact.  User Agents can
 440         specify expiry using either an Expiry header in a REGISTER
 441         request, or using an Expires parameter in a Contact header in
 442         a REGISTER request.  If the value requested by the User Agent
 443         is greater than the value of this object, then the contact
 444         information is given the duration specified by this object, and
 445         that duration is indicated to the User Agent in the response."
 446     ::= { sipServerRegCfgEntry 1 }
 447
 448 sipServerRegMaxUsers OBJECT-TYPE
 449     SYNTAX      Unsigned32 (1..4294967295)
 450     MAX-ACCESS  read-only
 451     STATUS      current
 452     DESCRIPTION
 453        "This object reflects the maximum number of users that the
 454         Registrar supports.  The current number of users is reflected
 455         by sipServerRegCurrentUsers."
 456     ::= { sipServerRegCfgEntry 2 }
 457
 458 sipServerRegCurrentUsers OBJECT-TYPE
 459     SYNTAX      Gauge32 (0..4294967295)
 460     MAX-ACCESS  read-only
 461     STATUS      current
 462     DESCRIPTION
 463        "This object reflects the number of users currently registered
 464         with the Registrar."
 465     ::= { sipServerRegCfgEntry 3 }
 466
 467 sipServerRegDfltRegActiveInterval OBJECT-TYPE
 468     SYNTAX      Unsigned32 (1..4294967295)
 469     UNITS      "seconds"
 470     MAX-ACCESS  read-only
 471     STATUS      current
 472     DESCRIPTION
 473
 474
 475        "This object reflects the default time interval the Registrar
 476         considers registrations to be active.  The value is used to
 477         compute the Expires header in the REGISTER response.  If a user
 478         agent requests a time interval shorter than specified by this
 479         object, the Registrar SHOULD honor that request.  If a Contact
 480         entry does not have an 'expires' parameter, the value of the
 481         Expires header field is used instead.  If a Contact entry has no
 482         'expires' parameter and no Expires header field is present,
 483         the value of this object is used as the default value."
 484     REFERENCE
 485        "RFC 3261, Section 10.2"
 486     ::= { sipServerRegCfgEntry 4 }
 487 --
 488 -- Per User Information
 489 --
 490 sipServerRegUserTable OBJECT-TYPE
 491     SYNTAX      SEQUENCE OF SipServerRegUserEntry
 492     MAX-ACCESS  not-accessible
 493     STATUS      current
 494     DESCRIPTION
 495        "This table contains information on all users registered to each
 496         Registrar in this system."
 497     ::= { sipServerRegCfg 2 }
 498
 499 sipServerRegUserEntry OBJECT-TYPE
 500     SYNTAX      SipServerRegUserEntry
 501     MAX-ACCESS  not-accessible
 502     STATUS      current
 503     DESCRIPTION
 504        "This entry contains information for a single user registered to
 505         this Registrar.
 506
 507         Each row represents those objects for a particular SIP server
 508         present in this system.  applIndex is used to uniquely identify
 509         these instances of SIP servers and correlate them through the
 510         common framework of the NETWORK-SERVICES-MIB (RFC 2788).  The
 511         same value of applIndex used in the corresponding
 512         SIP-COMMON-MIB is used here."
 513     INDEX { applIndex, sipServerRegUserIndex }
 514     ::= { sipServerRegUserTable 1 }
 515
 516 SipServerRegUserEntry ::=
 517     SEQUENCE {
 518         sipServerRegUserIndex                  Unsigned32,
 519         sipServerRegUserUri                    SnmpAdminString,
 520         sipServerRegUserAuthenticationFailures Counter32,
 521         sipServerRegUserDisconTime             TimeStamp
 522     }
 523
 524
 525 sipServerRegUserIndex OBJECT-TYPE
 526     SYNTAX      Unsigned32 (1..4294967295)
 527     MAX-ACCESS  not-accessible
 528     STATUS      current
 529     DESCRIPTION
 530        "This object uniquely identifies a conceptual row in the table."
 531     ::= { sipServerRegUserEntry 1 }
 532
 533 sipServerRegUserUri OBJECT-TYPE
 534     SYNTAX      SnmpAdminString
 535     MAX-ACCESS  read-only
 536     STATUS      current
 537     DESCRIPTION
 538        "This object contains the user's address-of-record.  It is the
 539         main form by which the Registrar knows the user.  The format is
 540         typically 'user@domain'.  It is contained in the To header for
 541         all REGISTER requests."
 542     ::= { sipServerRegUserEntry 2 }
 543
 544 sipServerRegUserAuthenticationFailures OBJECT-TYPE
 545     SYNTAX      Counter32
 546     MAX-ACCESS  read-only
 547     STATUS      current
 548     DESCRIPTION
 549        "This object contains a count of the number of times the user
 550         has failed authentication.
 551
 552         Discontinuities in the value of this counter can occur due to
 553         successful user authentications and at re-initialization of
 554         the SIP entity or service.  A Management Station can detect
 555         discontinuities in this counter by monitoring the
 556         sipServerRegUserDisconTime object in the same row."
 557     ::= { sipServerRegUserEntry 3 }
 558
 559 sipServerRegUserDisconTime OBJECT-TYPE
 560     SYNTAX      TimeStamp
 561     MAX-ACCESS  read-only
 562     STATUS      current
 563     DESCRIPTION
 564        "The value of the sysUpTime object when the counters for the
 565         user registration statistics objects in this row last
 566         experienced a discontinuity."
 567     ::= { sipServerRegUserEntry 4 }
 568 --
 569 -- Per Contact Information
 570 --
 571 sipServerRegContactTable OBJECT-TYPE
 572     SYNTAX      SEQUENCE OF SipServerRegContactEntry
 573
 574
 575     MAX-ACCESS  not-accessible
 576     STATUS      current
 577     DESCRIPTION
 578        "This table contains information on every location where a
 579         registered user (specified by sipServerRegUserIndex) wishes to
 580         be found (i.e., the user has provided contact information to
 581         each SIP Registrar in this system)."
 582     ::= { sipServerRegCfg 3 }
 583
 584 sipServerRegContactEntry OBJECT-TYPE
 585     SYNTAX      SipServerRegContactEntry
 586     MAX-ACCESS  not-accessible
 587     STATUS      current
 588     DESCRIPTION
 589        "This entry contains information for a single Contact.  Multiple
 590         contacts may exist for a single user.
 591
 592         Each row represents those objects for a particular SIP server
 593         present in this system.  applIndex is used to uniquely identify
 594         these instances of SIP servers and correlate them through the
 595         common framework of the NETWORK-SERVICES-MIB (RFC 2788).  The
 596         same value of applIndex used in the corresponding
 597         SIP-COMMON-MIB is used here."
 598
 599     INDEX { applIndex,
 600             sipServerRegUserIndex,
 601             sipServerRegContactIndex
 602           }
 603     ::= { sipServerRegContactTable 1 }
 604
 605 SipServerRegContactEntry ::=
 606     SEQUENCE {
 607         sipServerRegContactIndex        Unsigned32,
 608         sipServerRegContactDisplayName  SnmpAdminString,
 609         sipServerRegContactURI          SnmpAdminString,
 610         sipServerRegContactLastUpdated  TimeStamp,
 611         sipServerRegContactExpiry       DateAndTime,
 612         sipServerRegContactPreference   SnmpAdminString
 613     }
 614
 615 sipServerRegContactIndex OBJECT-TYPE
 616     SYNTAX      Unsigned32 (1..4294967295)
 617     MAX-ACCESS  not-accessible
 618     STATUS      current
 619     DESCRIPTION
 620        "Along with the sipServerRegUserIndex, this object uniquely
 621         identifies a conceptual row in the table."
 622     ::= { sipServerRegContactEntry 1 }
 623
 624
 625 sipServerRegContactDisplayName OBJECT-TYPE
 626     SYNTAX      SnmpAdminString
 627     MAX-ACCESS  read-only
 628     STATUS      current
 629     DESCRIPTION
 630        "This object contains the display name for the Contact.  For
 631         example, 'Santa at Home', or 'Santa on his Sled', corresponding
 632         to contact URIs of sip:BigGuy@example.com or
 633         sip:sclaus817@example.com, respectively."
 634     ::= { sipServerRegContactEntry 2 }
 635
 636 sipServerRegContactURI OBJECT-TYPE
 637     SYNTAX      SnmpAdminString
 638     MAX-ACCESS  read-only
 639     STATUS      current
 640     DESCRIPTION
 641        "This object contains either a SIP URI where the user can be
 642         contacted.  This URI is normally returned to a client from a
 643         Redirect Server, or is used as the RequestURI in a SIP request
 644         line for requests forwarded by a proxy."
 645     ::= { sipServerRegContactEntry 3 }
 646
 647 sipServerRegContactLastUpdated OBJECT-TYPE
 648     SYNTAX      TimeStamp
 649     MAX-ACCESS  read-only
 650     STATUS      current
 651     DESCRIPTION
 652        "This object indicates the time when this contact information
 653         was accepted.  If the contact information is updated via a
 654         subsequent REGISTER of the same information, this object is
 655         also updated."
 656     ::= { sipServerRegContactEntry 4 }
 657
 658 sipServerRegContactExpiry OBJECT-TYPE
 659     SYNTAX      DateAndTime
 660     MAX-ACCESS  read-only
 661     STATUS      current
 662     DESCRIPTION
 663        "This object contains the date and time when the contact
 664         information will no longer be valid.  Such times may be
 665         specified by the user at registration (i.e., Expires header or
 666         expiry parameter in the Contact information), or a system
 667         default can be applied."
 668     ::= { sipServerRegContactEntry 5 }
 669
 670 sipServerRegContactPreference OBJECT-TYPE
 671     SYNTAX      SnmpAdminString
 672     MAX-ACCESS  read-only
 673
 674
 675
 676     STATUS      current
 677     DESCRIPTION
 678        "This object indicates a relative preference for the particular
 679         Contact header field value compared to other bindings for this
 680         address-of-record.  A registering user may provide this
 681         preference as a 'qvalue' parameter in the Contact header.
 682
 683         The format of this item is a decimal number between 0 and 1
 684         (for example 0.9).  Higher values indicate locations preferred
 685         by the user."
 686     REFERENCE
 687        "RFC 3261, Section 10.2.1.2, 16.6, and 20.10"
 688     ::= { sipServerRegContactEntry 6 }
 689
 690 --
 691 -- Registrar Statistics
 692 --
 693 sipServerRegStatsTable OBJECT-TYPE
 694     SYNTAX      SEQUENCE OF SipServerRegStatsEntry
 695     MAX-ACCESS  not-accessible
 696     STATUS      current
 697     DESCRIPTION
 698        "This table contains the summary statistics objects applicable
 699         to all SIP Registrars in this system."
 700     ::= { sipServerRegStats 1 }
 701
 702 sipServerRegStatsEntry OBJECT-TYPE
 703     SYNTAX      SipServerRegStatsEntry
 704     MAX-ACCESS  not-accessible
 705     STATUS      current
 706     DESCRIPTION
 707        "A row of summary statistics.
 708
 709         Each row represents those objects for a particular SIP server
 710         present in this system.  applIndex is used to uniquely identify
 711         these instances of SIP servers and correlate them through the
 712         common framework of the NETWORK-SERVICES-MIB (RFC 2788).  The
 713         same value of applIndex used in the corresponding
 714         SIP-COMMON-MIB is used here."
 715     INDEX { applIndex }
 716     ::= { sipServerRegStatsTable 1 }
 717
 718 SipServerRegStatsEntry ::=
 719     SEQUENCE {
 720         sipServerRegStatsAcceptedRegs     Counter32,
 721         sipServerRegStatsRejectedRegs     Counter32,
 722         sipServerRegStatsDisconTime       TimeStamp
 723     }
 724
 725
 726 sipServerRegStatsAcceptedRegs OBJECT-TYPE
 727     SYNTAX      Counter32
 728     MAX-ACCESS  read-only
 729     STATUS      current
 730     DESCRIPTION
 731        "This object contains a count of the number of REGISTER requests
 732         that have been accepted (status code 200) by the Registrar.
 733         This includes additions of new contact information, refreshing
 734         contact information, as well as requests for deletion of
 735         contact information.
 736
 737         Discontinuities in the value of this counter can occur at
 738         re-initialization of the SIP entity or service.  A Management
 739         Station can detect discontinuities in this counter by
 740         monitoring the sipServerRegStatsDisconTime object in the same
 741         row."
 742     ::= { sipServerRegStatsEntry 1 }
 743
 744 sipServerRegStatsRejectedRegs OBJECT-TYPE
 745     SYNTAX      Counter32
 746     MAX-ACCESS  read-only
 747     STATUS      current
 748     DESCRIPTION
 749        "This object contains a count of the number REGISTER requests
 750         that have been rejected by the Registrar.
 751
 752         Discontinuities in the value of this counter can occur at
 753         re-initialization of the SIP entity or service.  A Management
 754         Station can detect discontinuities in this counter by
 755         monitoring the sipServerRegStatsDisconTime object in the same
 756         row."
 757   ::= { sipServerRegStatsEntry 2 }
 758
 759 sipServerRegStatsDisconTime OBJECT-TYPE
 760     SYNTAX      TimeStamp
 761     MAX-ACCESS  read-only
 762     STATUS      current
 763     DESCRIPTION
 764        "The value of the sysUpTime object when the counters for the
 765         registrar statistics objects in this row last experienced a
 766         discontinuity."
 767  ::= { sipServerRegStatsEntry 3 }
 768
 769 --
 770 -- Conformance
 771 --
 772 sipServerMIBCompliances
 773          OBJECT IDENTIFIER ::= { sipServerMIBConformance 1 }
 774
 775
 776 sipServerMIBGroups
 777          OBJECT IDENTIFIER ::= { sipServerMIBConformance 2 }
 778
 779 --
 780 -- Compliance Statements
 781 --
 782 sipServerProxyServerCompliance MODULE-COMPLIANCE
 783     STATUS      current
 784     DESCRIPTION
 785        "The compliance statement for SIP entities acting as Proxy
 786         Servers."
 787     MODULE -- this module
 788         MANDATORY-GROUPS { sipServerConfigGroup,
 789                            sipServerProxyConfigGroup,
 790                            sipServerProxyStatsGroup
 791                          }
 792     ::= { sipServerMIBCompliances 1 }
 793
 794 sipRedirectServerCompliance MODULE-COMPLIANCE
 795     STATUS      current
 796     DESCRIPTION
 797        "The compliance statement for SIP entities acting as Redirect
 798         Servers."
 799     MODULE -- this module
 800         MANDATORY-GROUPS { sipServerConfigGroup }
 801     ::= { sipServerMIBCompliances 2 }
 802
 803 sipServerRegistrarServerCompliance MODULE-COMPLIANCE
 804     STATUS      current
 805     DESCRIPTION
 806        "The compliance statement for SIP entities acting as
 807         Registrars."
 808     MODULE -- this module
 809         MANDATORY-GROUPS { sipServerConfigGroup,
 810                            sipServerRegistrarConfigGroup,
 811                            sipServerRegistrarStatsGroup }
 812     GROUP sipServerRegistrarUsersGroup
 813     DESCRIPTION
 814        "This is an optional group."
 815     ::= { sipServerMIBCompliances 3 }
 816
 817 --
 818 -- Units of Conformance
 819 --
 820 sipServerConfigGroup OBJECT-GROUP
 821     OBJECTS {
 822             sipServerCfgHostAddressType,
 823             sipServerCfgHostAddress
 824
 825
 826     }
 827     STATUS      current
 828     DESCRIPTION
 829        "A collection of objects providing configuration common to SIP
 830         Proxy and Redirect servers."
 831     ::= { sipServerMIBGroups 1 }
 832
 833 sipServerProxyConfigGroup OBJECT-GROUP
 834     OBJECTS {
 835             sipServerCfgProxyStatefulness,
 836             sipServerCfgProxyRecursion,
 837             sipServerCfgProxyRecordRoute,
 838             sipServerCfgProxyAuthMethod,
 839             sipServerCfgProxyAuthDefaultRealm
 840     }
 841     STATUS      current
 842     DESCRIPTION
 843        "A collection of objects providing configuration for SIP Proxy
 844         servers."
 845     ::= { sipServerMIBGroups 2 }
 846
 847 sipServerProxyStatsGroup OBJECT-GROUP
 848     OBJECTS {
 849             sipServerProxyStatProxyReqFailures,
 850             sipServerProxyStatsDisconTime
 851     }
 852     STATUS      current
 853     DESCRIPTION
 854        "A collection of objects providing statistics for SIP Proxy
 855         servers."
 856     ::= { sipServerMIBGroups 3 }
 857
 858 sipServerRegistrarConfigGroup OBJECT-GROUP
 859     OBJECTS {
 860             sipServerRegMaxContactExpiryDuration,
 861             sipServerRegMaxUsers,
 862             sipServerRegCurrentUsers,
 863             sipServerRegDfltRegActiveInterval
 864     }
 865     STATUS      current
 866     DESCRIPTION
 867        "A collection of objects providing configuration for SIP
 868         Registrars."
 869     ::= { sipServerMIBGroups 4 }
 870
 871 sipServerRegistrarStatsGroup OBJECT-GROUP
 872     OBJECTS {
 873             sipServerRegStatsAcceptedRegs,
 874
 875
 876             sipServerRegStatsRejectedRegs,
 877             sipServerRegStatsDisconTime
 878     }
 879     STATUS      current
 880     DESCRIPTION
 881        "A collection of objects providing statistics for SIP
 882         Registrars."
 883     ::= { sipServerMIBGroups 5 }
 884
 885 sipServerRegistrarUsersGroup OBJECT-GROUP
 886     OBJECTS {
 887             sipServerRegUserUri,
 888             sipServerRegUserAuthenticationFailures,
 889             sipServerRegUserDisconTime,
 890             sipServerRegContactDisplayName,
 891             sipServerRegContactURI,
 892             sipServerRegContactLastUpdated,
 893             sipServerRegContactExpiry,
 894             sipServerRegContactPreference
 895     }
 896     STATUS      current
 897     DESCRIPTION
 898        "A collection of objects related to registered users."
 899     ::= { sipServerMIBGroups 6 }
 900
 901 END