328 lines
12 KiB
Plaintext
328 lines
12 KiB
Plaintext
-- ****************************************************************************
|
|
-- ****************************************************************************
|
|
--
|
|
-- Copyright(c) 2004 Mediatrix Telecom, Inc.
|
|
--
|
|
-- NOTICE:
|
|
-- This document contains information that is confidential and proprietary
|
|
-- to Mediatrix Telecom, Inc.
|
|
--
|
|
-- Mediatrix Telecom, Inc. reserves all rights to this document as well as
|
|
-- to the Intellectual Property of the document and the technology and
|
|
-- know-how that it includes and represents.
|
|
--
|
|
-- This publication cannot be reproduced, neither in whole nor in part in
|
|
-- any form whatsoever without written prior approval by
|
|
-- Mediatrix Telecom, Inc.
|
|
--
|
|
-- Mediatrix Telecom, Inc. reserves the right to revise this publication
|
|
-- and make changes at any time and without the obligation to notify any
|
|
-- person and/or entity of such revisions and/or changes.
|
|
--
|
|
-- ****************************************************************************
|
|
-- ****************************************************************************
|
|
|
|
MX-STUN-MIB
|
|
DEFINITIONS ::= BEGIN
|
|
|
|
IMPORTS
|
|
MODULE-IDENTITY,
|
|
OBJECT-TYPE,
|
|
Unsigned32
|
|
FROM SNMPv2-SMI
|
|
MODULE-COMPLIANCE,
|
|
OBJECT-GROUP
|
|
FROM SNMPv2-CONF
|
|
MxEnableState,
|
|
MxIpHostName,
|
|
MxIpPort
|
|
FROM MX-TC
|
|
mediatrixConfig,
|
|
ipAddressStatus,
|
|
ipAddressConfig
|
|
FROM MX-SMI;
|
|
|
|
stunMIB MODULE-IDENTITY
|
|
LAST-UPDATED "200412100000Z"
|
|
ORGANIZATION "Mediatrix Telecom, Inc."
|
|
CONTACT-INFO "Mediatrix Telecom, Inc.
|
|
4229, Garlock Street
|
|
Sherbrooke (Quebec)
|
|
Canada
|
|
Phone: (819) 829-8749
|
|
"
|
|
DESCRIPTION "This MIB provides information to configure the STUN client
|
|
of the unit."
|
|
-- ************************************************************************
|
|
-- Revision history
|
|
-- ************************************************************************
|
|
REVISION "200412100000Z"
|
|
DESCRIPTION "Addition of the following MIB variables: stunQueryTimeout,
|
|
stunKeepAliveInterval, stunNatBindingQueryInterval.
|
|
|
|
Replace variable stunEstimatedNatBindingDuration by
|
|
stunQueryCacheDuration."
|
|
REVISION "200411160000Z"
|
|
DESCRIPTION "Addition of stunIndex and stunStaticIndex"
|
|
REVISION "200411090000Z"
|
|
DESCRIPTION "Creation"
|
|
::= { mediatrixConfig 200 }
|
|
|
|
stunMIBObjects OBJECT IDENTIFIER ::= { stunMIB 1 }
|
|
stunConformance OBJECT IDENTIFIER ::= { stunMIB 2 }
|
|
|
|
-- ************************************************************************
|
|
-- Enable/Disable Stun functionality
|
|
-- ************************************************************************
|
|
stunEnable OBJECT-TYPE
|
|
SYNTAX MxEnableState
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION "Enables/Disables the STUN client."
|
|
DEFVAL { disable }
|
|
::= { stunMIBObjects 50 }
|
|
|
|
stunQueryCacheDuration OBJECT-TYPE
|
|
SYNTAX Unsigned32 (0..3600)
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION "Indicates the amount of time the unit should keep a STUN
|
|
query result in its internal cache.
|
|
|
|
Keeping a query in a cache helps reduce the amount of
|
|
unnecessary STUN queries.
|
|
|
|
When set to 0, the cache is disabled. The unit will do a
|
|
STUN query each time a socket needs to be used.
|
|
|
|
This value is expressed in seconds (s).
|
|
"
|
|
DEFVAL { 0 }
|
|
::= { stunMIBObjects 100}
|
|
|
|
stunQueryTimeout OBJECT-TYPE
|
|
SYNTAX Unsigned32 (500..10000)
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION "Indicates the maximum amount of time the unit should
|
|
wait for an answer to a STUN query sent to a STUN
|
|
server.
|
|
|
|
This variable only applies when stunEnable is set
|
|
to enable.
|
|
|
|
Caution is advised in setting long timeouts.
|
|
In the advent of an unresponsive STUN server, the
|
|
unit may end up waiting a long time before it
|
|
determines that a call cannot be made due to the
|
|
STUN server failure.
|
|
|
|
This value is expressed in milliseconds (ms).
|
|
"
|
|
DEFVAL { 1000 }
|
|
::= { stunMIBObjects 150}
|
|
|
|
stunKeepAliveInterval OBJECT-TYPE
|
|
SYNTAX Unsigned32 (0..120)
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION "Indicates the interval at which blank keepalive
|
|
messages are sent by the unit to keep a firewall
|
|
hole opened.
|
|
|
|
Keepalive messages are used by both the signaling
|
|
protocol socket and the RTP socket to keep those
|
|
connections opened through a firewall.
|
|
|
|
When set to 0, no keep alive packet is sent.
|
|
|
|
This value is expressed in seconds (s).
|
|
"
|
|
DEFVAL { 30 }
|
|
::= { stunMIBObjects 200}
|
|
|
|
stunNatBindingQueryInterval OBJECT-TYPE
|
|
SYNTAX Unsigned32 (2..600)
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION "Indicates the frequency at which a unit should
|
|
do NAT binding discovery for its signaling protocol
|
|
socket.
|
|
|
|
This is only used with units that do not register
|
|
their ports.
|
|
|
|
Units that register their ports do their NAT binding
|
|
discovery just before registering.
|
|
|
|
This value is expressed in seconds (s).
|
|
"
|
|
DEFVAL { 300 }
|
|
::= { stunMIBObjects 250}
|
|
|
|
|
|
-- Add the STUN IP addresses specifics parameters
|
|
|
|
ipAddressStatusStun OBJECT IDENTIFIER ::= { ipAddressStatus 200 }
|
|
ipAddressConfigStun OBJECT IDENTIFIER ::= { ipAddressConfig 200 }
|
|
|
|
-- Add the STUN status information
|
|
|
|
-- ************************************************************************
|
|
-- IP Address Status Stun server Table
|
|
-- ************************************************************************
|
|
stunTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF StunEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION "A table of STUN servers."
|
|
::= { ipAddressStatusStun 50 }
|
|
|
|
stunEntry OBJECT-TYPE
|
|
SYNTAX StunEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION "A row in the stunTable used to specify a STUN server."
|
|
INDEX {
|
|
stunIndex
|
|
}
|
|
::= { stunTable 50 }
|
|
|
|
StunEntry ::= SEQUENCE
|
|
{
|
|
stunIndex Unsigned32,
|
|
stunHost MxIpHostName,
|
|
stunPort MxIpPort,
|
|
}
|
|
|
|
stunIndex OBJECT-TYPE
|
|
SYNTAX Unsigned32 (1..1)
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION "STUN index for this row."
|
|
::= { stunEntry 10 }
|
|
|
|
stunHost OBJECT-TYPE
|
|
SYNTAX MxIpHostName
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION "STUN server IP address or domain name."
|
|
DEFVAL { "192.168.0.10" }
|
|
::= { stunEntry 50 }
|
|
|
|
stunPort OBJECT-TYPE
|
|
SYNTAX MxIpPort
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION "STUN server IP port number."
|
|
DEFVAL { 3478 }
|
|
::= { stunEntry 100 }
|
|
|
|
-- Add the STUN configuration information
|
|
|
|
ipAddressConfigStunStatic OBJECT IDENTIFIER ::= { ipAddressConfigStun 50 }
|
|
|
|
-- Add the static parameters
|
|
|
|
-- ************************************************************************
|
|
-- IP Address Config Stun server Table
|
|
-- ************************************************************************
|
|
stunStaticTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF StunStaticEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION "A table of STUN servers."
|
|
::= { ipAddressConfigStunStatic 50 }
|
|
|
|
stunStaticEntry OBJECT-TYPE
|
|
SYNTAX StunStaticEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION "A row in the stunStaticTable used to specify a STUN server."
|
|
INDEX {
|
|
stunStaticIndex
|
|
}
|
|
::= { stunStaticTable 50 }
|
|
|
|
StunStaticEntry ::= SEQUENCE
|
|
{
|
|
stunStaticIndex Unsigned32,
|
|
stunStaticHost MxIpHostName,
|
|
stunStaticPort MxIpPort,
|
|
}
|
|
|
|
stunStaticIndex OBJECT-TYPE
|
|
SYNTAX Unsigned32 (1..1)
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION "STUN index for this row."
|
|
::= { stunStaticEntry 10 }
|
|
|
|
stunStaticHost OBJECT-TYPE
|
|
SYNTAX MxIpHostName
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION "Static STUN server IP address or domain name."
|
|
DEFVAL { "192.168.0.10" }
|
|
::= { stunStaticEntry 50 }
|
|
|
|
stunStaticPort OBJECT-TYPE
|
|
SYNTAX MxIpPort
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION "Static STUN server IP port number."
|
|
DEFVAL { 3478 }
|
|
::= { stunStaticEntry 100 }
|
|
|
|
|
|
-- ************************************************************************
|
|
-- Conformance information
|
|
-- ************************************************************************
|
|
stunCompliances OBJECT IDENTIFIER ::= { stunConformance 1 }
|
|
|
|
stunComplVer1 MODULE-COMPLIANCE
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Minimal parameters definitions to support STUN."
|
|
MODULE -- This Module
|
|
MANDATORY-GROUPS {
|
|
stunBasicGroupVer1,
|
|
stunServerGroupVer1
|
|
}
|
|
::= { stunCompliances 1 }
|
|
|
|
-- ************************************************************************
|
|
-- MIB variable grouping
|
|
-- ************************************************************************
|
|
stunGroups OBJECT IDENTIFIER ::= { stunConformance 2 }
|
|
|
|
stunBasicGroupVer1 OBJECT-GROUP
|
|
OBJECTS {
|
|
stunEnable,
|
|
stunQueryCacheDuration,
|
|
stunQueryTimeout,
|
|
stunKeepAliveInterval,
|
|
stunNatBindingQueryInterval
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This group holds the minimal set of objects to configure the STUN
|
|
service."
|
|
::= { stunGroups 1 }
|
|
|
|
stunServerGroupVer1 OBJECT-GROUP
|
|
OBJECTS {
|
|
stunHost,
|
|
stunPort,
|
|
stunStaticHost,
|
|
stunStaticPort
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This group holds the minimal set of objects that defines
|
|
STUN server."
|
|
::= { stunGroups 2 }
|
|
|
|
END
|
|
|