snmp_mib_archive/CISCO-WAN-MG-MIB.my
Heston Snodgrass 89bf4b016e initial commit
2016-12-15 15:03:18 -07:00

1436 lines
50 KiB
Plaintext

-- *****************************************************************
-- CISCO-WAN-MG-MIB.my: CISCO Media Gateway MIB file
--
-- January 2004, George Ogagan
-- May 2005, Rashmi Purandare
--
-- Copyright (c) 1999, 2000, 2001, 2002, 2003, 2004, 2005 by
-- Cisco Systems, Inc.
-- All rights reserved.
--
-- *****************************************************************
-- $Endlog$
--
CISCO-WAN-MG-MIB DEFINITIONS ::= BEGIN
IMPORTS
MODULE-IDENTITY,
OBJECT-TYPE,
Integer32,
Unsigned32,
IpAddress FROM SNMPv2-SMI
TruthValue,
RowStatus FROM SNMPv2-TC
SnmpAdminString FROM SNMP-FRAMEWORK-MIB
MODULE-COMPLIANCE,
OBJECT-GROUP FROM SNMPv2-CONF
ciscoWan FROM CISCOWAN-SMI;
ciscoWanMgMIB MODULE-IDENTITY
LAST-UPDATED "200505270000Z"
ORGANIZATION "Cisco Systems, Inc."
CONTACT-INFO
" Cisco Systems
Customer Service
Postal: 170 W Tasman Drive
San Jose, CA 95134
USA
Tel: +1 800 553-NETS
E-mail: cs-wanatm@cisco.com"
DESCRIPTION
"The MIB module for managing Media Gateways (MGs).
Terms used:
MG: Media Gateway
MGC: Media Gateway Controller
MGCP: Media Gateway Control Protocol
NE: Notified Entity
RSIP: Restart In Progress (MGCP standard message)"
REVISION "200505270000Z"
DESCRIPTION
"Added mgEndpointExtTable.
"
REVISION "200401200000Z"
DESCRIPTION
"Update descriptions in MIB."
REVISION "200206140000Z"
DESCRIPTION
"Imported Unsigned32 from SNMPv2-SMI instead
of CISCO-TC."
REVISION "200105250000Z"
DESCRIPTION
"deprecated following objects:
mgcAssociationState,
mgcAssociationStateControl,
mgcUnassociationPolicy,
mgcCommLossUnassociationTimeout.
mgcProtocolTable,
mgcProtocolEntry and mgcProtocolRowStatus."
REVISION "200007191500Z"
DESCRIPTION
"Create new table mediaGatewayDomainName.
Deprecated mgcDnsResolution in mgcTable.
Added mgcDnsResolutionFlag to mgcResolutionTable."
REVISION "200003270000Z"
DESCRIPTION
"Added DEFVAL clause for mgEndpointCreationPolicy."
REVISION "199911270000Z"
DESCRIPTION
"Initial Version of the MIB."
::= { ciscoWan 10 }
ciscoWanMgMIBObjects
OBJECT IDENTIFIER ::= { ciscoWanMgMIB 1 }
mediaGateway
OBJECT IDENTIFIER ::= { ciscoWanMgMIBObjects 1 }
mediaGatewayController
OBJECT IDENTIFIER ::= { ciscoWanMgMIBObjects 2 }
mediaGatewayEndpoint
OBJECT IDENTIFIER ::= { ciscoWanMgMIBObjects 3 }
mediaGatewayLine
OBJECT IDENTIFIER ::= { ciscoWanMgMIBObjects 4 }
mediaGatewayControllerResolution
OBJECT IDENTIFIER ::= { ciscoWanMgMIBObjects 5 }
mediaGatewayDomainName
OBJECT IDENTIFIER ::= { ciscoWanMgMIBObjects 6 }
--
-- Media Gateway Group.
--
mgName OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (1..64))
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"Denotes name of the MG, as it is identified
by media gateway controllers. This corresponds
to a domain name under which the Media Gateway
could also be registered in a DNS."
::= { mediaGateway 1 }
mgAdministrativeState OBJECT-TYPE
SYNTAX INTEGER {
inService (1),
commandedOutOfService (2),
pendingOutOfService (3)
}
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the current admin state of
the Media Gateway.
The possible admin states are:
'inService' - The MG is ready to provide service.
In this state, the MG will respond
to connection control requests, emit autonomous
messages to MGCs as applicable, etc.
'commandedOutOfService' - The MG does not provide
service and all resources have been released.
In this state, the MG will not
respond to any connection control requests or
emit autonomous messages.
'pendingOutOfService' - This is a transitional state prior
to going 'commandedOutOfService'. In this state
the MG provides service but does not accept new
service requests (i.e. creation of connections)
will transition to 'commandedOutOfService'
according to 'mgShutdownGraceTime'."
DEFVAL { commandedOutOfService }
::= { mediaGateway 2 }
mgAdministrativeStateControl OBJECT-TYPE
SYNTAX INTEGER {
inService (1),
forcefulOutOfService (2),
gracefulOutOfService (3)
}
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This control object is used to change the service state
of the MG from 'inService' to 'commandedOutOfService' and
from 'commandedOutOfService' to 'inService'. The resulting
service state of the gateway is represented by
'mgAdministrativeState'.
If set, this object triggers the following:
'inService': Transition 'mgAdministrativeState' to
'inService'. In the course, the MG's
MGCs may get notified of this transition,
e.g. in the case of MGCP through emission
of RSIPs to registered call agents
according to policy.
'forcefulOutOfService': Take the gateway out-of-service
forcefully. This releases any resources at
the MG. In the course, the MGCs may get notified
of this transition, e.g. in the case of MGCP
through emission of RSIPs to registered call agents
according to policy.
'gracefulOutOfService': Take the gateway out-of-service
gracefully. If there are no resources existing,
'mgAdministrative' transitions to
'commandedOutOfService' immediately. If resources
exist, 'mgAdministrativeState' transitions to
'pendingOutOfService' thus initiating a graceful
shutdown. In the course, the MGs MGCs may get
notified of this transition, e.g. in the case of
MGCP through emission of RSIPs to registered call
agents according to policy."
DEFVAL { forcefulOutOfService }
::= { mediaGateway 3 }
mgShutdownGraceTime OBJECT-TYPE
SYNTAX Integer32 (-1..65535)
UNITS "seconds"
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object indicates the time in seconds after which an
MG will transition from 'gracefulOutOfService' to
'forcefulOutOfService'. A value of -1 indicates that
the MG allows for draining, i.e. will automatically
transition after the last resource in use has been
released. Otherwise, it essentially indicates the amount
of time an MGC has to perform any cleanup, e.g. deletion
of connections etc."
::= { mediaGateway 4 }
--
-- Media Gateway Supported Protocol Table.
--
mgSupportedProtocolTable OBJECT-TYPE
SYNTAX SEQUENCE OF MgSupportedProtocolEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This is a table which identifies the protocols, along
with their revisions that the media gateway supports
for purposes of communication with an MGC. The table
is created by the agent at system startup and cannot
changed."
::= { mediaGateway 7 }
mgSupportedProtocolEntry OBJECT-TYPE
SYNTAX MgSupportedProtocolEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Represents an individual table entry in
mgSupportedProtocolTable."
INDEX { mgProtocolNumber }
::= { mgSupportedProtocolTable 1 }
MgSupportedProtocolEntry ::=
SEQUENCE {
mgProtocolNumber Integer32,
mgProtocolName SnmpAdminString
}
mgProtocolNumber OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Serves as index to this table."
::= { mgSupportedProtocolEntry 1 }
mgProtocolName OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (1..64))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"A control protocol and its revision supported by the
call gateway. For example: 'MGCP 0.1 11/9/99'
The protocol can be one of the control protocols like
MGCP or it can be a signaling backhaul protocol or
it can be resource co-ordination protocol like SRCP."
::= { mgSupportedProtocolEntry 2 }
--
-- Media Gateway Controller Group
--
maxConcurrentMgcs OBJECT-TYPE
SYNTAX Unsigned32 (0..65535)
UNITS "controllers"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object identifies the maximum number of MGCs
the MG can have."
::= { mediaGatewayController 3 }
--
-- Media Gateway Controller Table
--
mgcTable OBJECT-TYPE
SYNTAX SEQUENCE OF MgcEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This is a table which contains information about the
individual MGCs."
::= { mediaGatewayController 1 }
mgcEntry OBJECT-TYPE
SYNTAX MgcEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Represents an individual table entry in
mgcTable."
INDEX { mgcNumber }
::= { mgcTable 1 }
MgcEntry ::=
SEQUENCE {
mgcNumber Integer32,
mgcName SnmpAdminString,
mgcDnsResolution TruthValue,
mgcAssociationState INTEGER,
mgcAssociationStateControl INTEGER,
mgcUnassociationPolicy INTEGER,
mgcCommLossUnassociationTimeout Integer32,
mgcRowStatus RowStatus
}
mgcNumber OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Serves as index to this table."
::= { mgcEntry 1 }
mgcName OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (1..64))
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"Denotes the name of the media gateway controller.
This corresponds to a domain name under which the
MGC could also be registered in a DNS.
Once the row has become active, this value may not
be modified."
::= { mgcEntry 2 }
mgcDnsResolution OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-only
STATUS deprecated
DESCRIPTION
"Indicates how the MG resolves the IP address of the MGC.
'true(1)' - the resolution is done using an external
DNS server.
'false(2)' - the resolution is done using
mgcResolutionTable."
DEFVAL { false }
::= { mgcEntry 3 }
mgcAssociationState OBJECT-TYPE
SYNTAX INTEGER {
mgcUnassociated (1),
mgcAssociated (2),
mgcAssociatedCommLoss (3)
}
MAX-ACCESS read-only
STATUS deprecated
DESCRIPTION
"Represents the state of the association between the MG
and the MGC. The possible values are:
'mgcUnassociated' : MG and MGC are not associated.
For example, in the case where MGCP
is the coordination protocol, it means
no subscription to autonomous messages
such as RSIP but control requests would
be answered.
'mgcAssociated' : MG and MGC are associated. E.g. in the
case where MGC is the coordination
protocol, it means MGC is subscribed
to autonomous messages such as RSIP.
'mgcAssociatedCommLoss' : Associated but MGC unreachable.
This object is being moved to the
mgcRedundancyGrpParamTable. This object is deprecated
because the association state is defined per MGC
redundancy group, rather than per MGC."
::= { mgcEntry 4 }
mgcAssociationStateControl OBJECT-TYPE
SYNTAX INTEGER {
mgcUnassociate (1),
mgcAssociate (2),
mgcClear (3)
}
MAX-ACCESS read-create
STATUS deprecated
DESCRIPTION
"Used to control the association state, as represented by
mgcAssociationState. The possible value for a set operation
on this object are:
'mgcUnassociate': Transition from any state to
'mgcUnassociated'. If registered, MG
will initiate deregistration.
'mgcAssociate' : Transition to 'mgcAssociated'. If
applicable, MG will register with MGC.
If MGCP is the coordination protocol,
MG will send RSIP.
If MG cannot establish communication,
it will subsequently transition into
'mgcAssociatedCommLoss' for the
'mgcAssociationState' object.
If MG is already associated with MGC, no
transition will take place and
mgcAssociationState shall not change.
'mgcClear' : No action will be taken. This means that the
Media Gateway will not initiate any
association/unassociation.
This object is being moved to the mgcRedundancyGrpParamTable.
This object is deprecated because the association state
control is defined per MGC redundancy group, rather
than per MGC."
DEFVAL { mgcUnassociate }
::= { mgcEntry 5 }
mgcUnassociationPolicy OBJECT-TYPE
SYNTAX INTEGER {
mgcNoAction(1),
mgcRelease (2)
}
MAX-ACCESS read-create
STATUS deprecated
DESCRIPTION
"Indicates what MG will do when mgcAssociationState transitions
to unassociated.
'mgcNoAction' : indicates that MG will take no further
action. In particular, no resources will
be released nor connections be flushed.
'mgcRelease' : indicates that upon unassociation, the
MG will release all resources and flush
all connections.
This object may not always be configurable, i.e. be read
only in some agent implementations. In these cases,
mgcNoAction shall be supported as the default value."
DEFVAL { mgcNoAction }
::= { mgcEntry 6 }
mgcCommLossUnassociationTimeout OBJECT-TYPE
SYNTAX Integer32 (-1..65535)
UNITS "seconds"
MAX-ACCESS read-create
STATUS deprecated
DESCRIPTION
"Indicates how long, in seconds, upon detection of
a communication loss, subscriptions to autonomous
notifications (such as notification requests and RSIPs
in the case of MGCP) remain valid and communications will
be reattempted for an MGC in 'mgcAssociatedCommLoss' state.
A value of -1 indicates that the MGC may remain in
'mgcAssociatedCommLoss' state indefinitely. A value of 0
indicates that the MGC transitions into 'mgcUnassociated'
state immediately.
This object may not always be configurable, i.e. be read
only in some agent implementations. An MG implementation
may not support differentiation of the timeout between
associations. In such an event, any modification to the
value for one MGC will take effect globally."
DEFVAL { -1 }
::= { mgcEntry 7 }
mgcRowStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"Controls the creation and deletion of a table entry.
An entry may be created using the 'createAndGo' option.
When the row is successfully created, the RowStatus would
be set to 'active' by the agent. An entry may be deleted
by setting the RowStatus to 'destroy'. Other options such as
`createAndWait', 'notInService', 'notReady' will not be used.
For creating the row, a value for mgcName must be provided.
This mgcName should be already added in mgDomainName table
and at least 1 IP should associated to this mgcName.
To all other objects, defaults defined by the agent
implementation may apply.
Deletion of a row with mgcAssociationState other than
unassociated shall be rejected."
::= { mgcEntry 8 }
-- *********************************************************************
-- Media Gateway Controller Protocol Table
-- *********************************************************************
mgcProtocolTable OBJECT-TYPE
SYNTAX SEQUENCE OF MgcProtocolEntry
MAX-ACCESS not-accessible
STATUS deprecated
DESCRIPTION
"This table contains information about which protocols are
being used in a particular association between the gateway
and the MGCs.
Because there may be a number of different protocols in use
for a particular control association between the gateway
and an MGC, this information is kept in a separate table
rather than being included in mgcTable. In effect, it
constitutes a relationship between mgcTable and
mgSupportedProtocolTable.
With support for multiple MGC redundancy groups, the protocols
will be defined per MGC redundancy group rather than per MGC.
A new table mgcRedundancyGrpProtocolTable is introduced."
::= { mediaGatewayController 2 }
mgcProtocolEntry OBJECT-TYPE
SYNTAX MgcProtocolEntry
MAX-ACCESS not-accessible
STATUS deprecated
DESCRIPTION
"Represents an individual table entry in
mgcProtocolTable.
mgcNumber references the media gateway controller,
constituting a foreign key into mgcTable and adapting
the value of mgcNumber of that MGC.
mgProtocolNumber references the protocol, reflecting the
mgProtocolNumber from the mgSupportedProtocolTable.
When active, it is expected that mgcNumber and
mgcProtocolNumber contain valid values that maintain
referential integrity, i.e. constitute valid foreign keys
into mgcTable and mgSupportedProtocolTable respectively.
The attempt to create a row that would violate referential
integrity shall be rejected.
With support for multiple MGC redundancy groups, the
protocols will be defined per MGC redundancy group rather
than per MGC."
INDEX { mgcNumber, mgProtocolNumber }
::= { mgcProtocolTable 1 }
MgcProtocolEntry ::=
SEQUENCE {
mgcProtocolRowStatus RowStatus
}
mgcProtocolRowStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS deprecated
DESCRIPTION
"Controls the creation and deletion of a table entry.
An entry may be created using the 'createAndGo' option.
When the row is successfully created, the RowStatus would
be set to 'active' by the agent. An entry may be deleted
by setting the RowStatus to 'destroy'. Other options such as
`createAndWait', 'notInService', 'notReady' will not be used.
With support for multiple MGC redundancy groups, the protocols
will be defined per MGC redundancy group rather than per MGC."
::= { mgcProtocolEntry 1 }
-- *****************************************************************
-- Endpoint Group
--
-- This group represents the endpoints supported by the media gateway.
-- *****************************************************************
mgEndpointCreationPolicy OBJECT-TYPE
SYNTAX INTEGER {
dynamic (1),
strictDynamic (2),
static (3)
}
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"Identifies whether the MG creates endpoints for
connections involving single channels (e.g. DS0s)
dynamically upon receipt of a create connection
request in the control protocol, or whether the
endpoints have to be configured statically. This
does not apply for endpoints involving several
channels (such as nx64) which will in general be
configured statically.
'dynamic': Endpoint created dynamically if not
already existing.
'strictDynamic': Endpoint created dynamically;
connection requests must not
refer to preexisting endpoint.
'static': Endpoint statically provisioned.
This object will in general not be configurable,
i.e. be read only in most agent implementations."
DEFVAL { static }
::= { mediaGatewayEndpoint 2 }
-- *****************************************************************
-- Endpoint Table
-- *****************************************************************
mgEndpointTable OBJECT-TYPE
SYNTAX SEQUENCE OF MgEndpointEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table contains information about the individual
endpoints."
::= { mediaGatewayEndpoint 1 }
mgEndpointEntry OBJECT-TYPE
SYNTAX MgEndpointEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Represents an individual table entry in
mgEndpointTable."
INDEX { mgEndpointNumber }
::= { mgEndpointTable 1 }
MgEndpointEntry ::=
SEQUENCE {
mgEndpointNumber Integer32,
mgEndpointLineNumber Integer32,
mgEndpointName SnmpAdminString,
mgEndpointSpeed Unsigned32,
mgEndpointState INTEGER,
mgEndpointChannelMap Integer32,
mgEndpointRowStatus RowStatus
}
mgEndpointNumber OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Identifies endpoint as it is known by the NE. The
endpoint number is unique for the entire MG
and ranges from 1 to the maximum number of endpoints
that the MG can support."
::= { mgEndpointEntry 1 }
mgEndpointLineNumber OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"Identifies the DS1 line. Generally, this will
correspond to the ifIndex of the physical
interface terminating the line.
Once the row has become active, this value may not be
changed."
::= { mgEndpointEntry 2 }
mgEndpointName OBJECT-TYPE
SYNTAX SnmpAdminString
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"Identifies endpoint as it is known by the MGC.
If MG and MGC use a mutually agreed upon convention,
this may be supplied by the agent, i.e. be read-only."
::= { mgEndpointEntry 3 }
mgEndpointSpeed OBJECT-TYPE
SYNTAX Unsigned32 (0..65535)
UNITS "Kbps"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Indicates the endpoint's bandwidth, in Kbps. Typically,
this will be 64 times the number of channels terminated
by the endpoint."
::= { mgEndpointEntry 4 }
mgEndpointState OBJECT-TYPE
SYNTAX INTEGER {
mgEndpointActive (1),
mgEndpointFailed (2),
mgEndpointDegraded (3)
}
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Indicates the state of the endpoint.
'mgEndpointActive' - the endpoint is in service and
operational.
'mgEndpointFailed' - the endpoint is in service but
not operational, e.g. because a line that
the endpoint belongs to is in a state of
service affecting alarm.
'mgEndpointDegraded' - the endpoint is in service
but not fully
operational, e.g. in cases with endpoints with
channels on multiple lines, when one of the lines
is in a state of service affecting alarm
If MGCP is used as the control protocol, the following
transitions will generally trigger an RSIP command:
from 'mgEndpointActive'/'mgEndpointDegraded' to
'mgEndpointFailed' or from 'mgEndpointFailed' to
'mgEndpointDegraded'/'mgEndpointActive'. Transitions
between 'mgEndpointActive' and 'mgEndpointDegraded' will
generally not trigger emission of RSIP."
::= { mgEndpointEntry 5 }
mgEndpointChannelMap OBJECT-TYPE
SYNTAX Integer32 (0..2147483647)
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"Bit map of DS0s used by the endpoint. Bit positions set to
'1' represent DS0s used by the endpoint. The Bit position
corresponds to the DS0 number.
Once the row has become active, this value may not be
changed."
::= { mgEndpointEntry 6 }
mgEndpointRowStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"Controls the creation and deletion of a table entry.
An entry may be created using the 'createAndGo' option.
When the row is successfully created, the RowStatus would
be set to 'active' by the agent thereby creating an endpoint.
An endpoint may be deleted by setting the RowStatus to
'destroy'. Other options such as `createAndWait',
'notInService', 'notReady' will not be used.
On creation, values for mgEndpointLineNumber and
mgEndpointChannelMap have to be supplied."
::= { mgEndpointEntry 7 }
-- *************************************************************
-- Line Group
-- *************************************************************
lineAssignmentTable OBJECT-TYPE
SYNTAX SEQUENCE OF LineAssignmentEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table contains information about each line in the
media gateway."
::= { mediaGatewayLine 1 }
lineAssignmentEntry OBJECT-TYPE
SYNTAX LineAssignmentEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Represents an individual table entry in
lineAssignmentTable."
INDEX { lineNumber }
::= { lineAssignmentTable 1 }
LineAssignmentEntry ::=
SEQUENCE {
lineNumber Integer32,
channelAssignment Integer32,
lineName SnmpAdminString
}
lineNumber OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Identifies the DS1 line. Generally, this will
correspond to the ifIndex of the physical interface
terminating the line."
::= { lineAssignmentEntry 1 }
channelAssignment OBJECT-TYPE
SYNTAX Integer32 (0..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Each bit that is set represents that the corresponding DS0
is in use, either because it has been assigned to an endpoint
or because it constitutes a signaling channel that is not
available for assignment to an endpoint."
::= { lineAssignmentEntry 2 }
lineName OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (1..64))
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"Line name as identified by the MGC, if applicable. The
default line name is 'LINE'. If MG uses a common convention,
this may be supplied by the agent, i.e. be read-only."
::= { lineAssignmentEntry 3 }
-- *****************************************************************
-- MGC Resolution Group
-- *****************************************************************
mgcResolutionTable OBJECT-TYPE
SYNTAX SEQUENCE OF MgcResolutionEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table provides the name to IP address mapping
for each of the MGCs, external DNS server, tftp server
and announcement server. It also stores the IP addresses
of external resolved domain name.
Several addresses may be associated with a single name."
::= { mediaGatewayControllerResolution 1 }
mgcResolutionEntry OBJECT-TYPE
SYNTAX MgcResolutionEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Represents an individual table entry in
mgcResolutionTable."
INDEX { mgcResolutionIndex }
::= { mgcResolutionTable 1 }
MgcResolutionEntry ::=
SEQUENCE {
mgcResolutionIndex Integer32,
mgcResolutionName SnmpAdminString,
mgcResolutionIpAddress IpAddress,
mgcResolutionCommState INTEGER,
mgcResolutionPreference Integer32,
mgcResolutionRowStatus RowStatus,
mgcDnsResolutionFlag INTEGER
}
mgcResolutionIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Serves as index to this table.
The table will be divided into two, index 1 to 88 will
be used by the user and index 89 to 176 will be used
by the VDNS to fill in the externally resolved IP address."
::= { mgcResolutionEntry 1 }
mgcResolutionName OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (1..64))
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"Denotes the name of the entity (MGC and/or NE) whose
address is to be resolved. Once the row has become
active, this value may not be changed."
::= { mgcResolutionEntry 2 }
mgcResolutionIpAddress OBJECT-TYPE
SYNTAX IpAddress
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"Denotes the IP address of the entity. Once the row has
become active, this value may not be changed. To change
the IP address, an entry will have to be removed and a
new entry will have to be added."
::= { mgcResolutionEntry 3 }
mgcResolutionCommState OBJECT-TYPE
SYNTAX INTEGER {
csActive (1),
csInactive (2)
}
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Indicates whether the address is the one currently
applied for communications with the system of that
name.
'csActive' - name resolves to that IP address
'csInactive' - IP address currently not in use
On creation of the row, this value will be 'csInactive',
although it may transition immediately to active,
triggering the notification of 'mgcCommStateActive'
specified in CISCO-VISM-TRAPS-MIB."
DEFVAL { csInactive}
::= { mgcResolutionEntry 4 }
mgcResolutionPreference OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object can be used by the MG in the selection
of an IP address if multiple IP addresses are
available for the same name.
This object cannot be modified after this entry is created.
It has to be unique among various IP addresses of a same
domain name.
In which case the IP address associated with
mgcResolutionPreference 1 would be selected over the IP
address associated with mgcResolutionPreference 2."
::= { mgcResolutionEntry 5 }
mgcResolutionRowStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"Controls the creation and deletion of a table entry.
An entry may be created using the 'createAndGo' option.
mgcResolutionIndex, mgcResolutionName,
mgcResolutionIpAddress, and mgcResolutionPreference
should be provided when creating an entry.
mgcResolutionIndex can be 1 - 88. Entries with
index 89 - 176 will be implicitly added when VDNS
resolves IP addresses of domain servers. Usually maximum 8
IP addresses can be added to one mgcName.
For external DNS server only 3 IP addresses with the highest
will be used.
Before creating an entry in this table one entry should
already been created in mgDomainNameTable with the same
name as mgcResolutionName.
When the row is successfully created, the RowStatus would
be set to 'active' by the agent.
An entry may be deleted by setting the RowStatus to
'destroy'. Only mgcResolutionIndex should be provided
to delete an entry. The last IP within 1 - 88 should
not be deleted if the mgcResolutionName is still configured
for MGC, tftp server, external DNS server, PRI backhaul
session group or announcement server and there is no
external resolved IP (entry 89 - 176) for this domain name.
Other options such as `createAndWait', 'notInService',
'notReady' will not be used."
::= { mgcResolutionEntry 6 }
mgcDnsResolutionFlag OBJECT-TYPE
SYNTAX INTEGER{
internal (1),
external (2)
}
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"All entries statically configured by the customer
(i.e. all entries in the top half of the table)
will have the flag set to 'internal'. All IP
addresses obtained due to external resolution of
the domain name (that is, entries in the bottom
half of the table) will have this flag set to
'external'."
::= { mgcResolutionEntry 7 }
-- *****************************************************************
-- MG Domain Name Group
-- *****************************************************************
mgDomainNameTable OBJECT-TYPE
SYNTAX SEQUENCE OF MgDomainNameEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table provides the domain names that are
configured by users. The domain names could refer
to Call Agents, tftp server for CAS file download,
external DNS server or announcement server."
::= { mediaGatewayDomainName 1 }
mgDomainNameEntry OBJECT-TYPE
SYNTAX MgDomainNameEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Represents an individual table entry in mgDomainNameTable."
INDEX { mgDomainNameIndex }
::= { mgDomainNameTable 1 }
MgDomainNameEntry ::=
SEQUENCE {
mgDomainNameIndex Integer32,
mgDomainName SnmpAdminString,
mgDnsResolutionType INTEGER,
mgDomainNameRowStatus RowStatus
}
mgDomainNameIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This object serves as index to this table."
::= { mgDomainNameEntry 1 }
mgDomainName OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (1..64))
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object denotes the domain name of MGCs,
tftp server, external DNS server or announcement
server. Once the row has become active, this value may
not be changed."
::= { mgDomainNameEntry 2 }
mgDnsResolutionType OBJECT-TYPE
SYNTAX INTEGER {
internalOnly (1),
externalOnly (2),
internalFirst (3),
externalFirst (4)
}
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object determines the kind of DNS resolution to
be applied for a particular domain name.
'internalOnly' means that the gateway will not try to
resolve the IP address for this domain name using
external DNS. The IP address/es for this domain name
will be obtained from the first half of mgcResolutionTable,
which are added by the user.
'externalOnly' means the IP address for this domain name
will be resolved externally using external DNS.
'internalFirst' means the first preference will be given
to statically provisioned IP address/es, followed the IP
address/es resolved using external DNS.
'externalFirst' means the first preference will be given
to IP addresses resolved using external DNS followed by
statically provisioned IP addresses.
This object can be modified when mgDomainNameRowStatus
is active except that if the mgDomainName refers to
external DNS server then this object cannot be changed.
The request to change from 'internalOnly' to other types
will be rejected if external DNS server is 'NULL'. The
external DNS server can be set to 'NULL' through
the object vismExtDnsServerDn in CISCO-VISM-MODULE-MIB.
When user change this object to 'internalOnly' then all
the externally resolved IP addresses should be implicitly
deleted from mgcResolutionTable."
DEFVAL{ internalOnly }
::= { mgDomainNameEntry 3 }
mgDomainNameRowStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"Controls the creation and deletion and of a table entry.
An entry may be created using the 'createAndGo' option.
User can only set mgDnsResolutionType to 'internalOnly'.
The request to set an entry with mgDnsResolutionType of
'externalOnly', 'internalFirst' or 'externalFirst' would
be rejected if the external DNS server is 'NULL'.
When the row is successfully created, the RowStatus would
be set to 'active' by the agent.
An entry may be deleted by setting the RowStatus to
'destroy'. The deletion of an entry will be rejected
if there is still reference to this domain name.
For example, it cannot be deleted if it is configured as
MGC, tftp server, external DNS server or announcement server.
Also user added IPs should already been deleted. After delete
the domain name externally resolved IPs are purged implicitly.
The request to change from 'internalOnly' to other types
will be rejected if external DNS server is 'NULL'.
Other options such as `createAndWait', 'notInService',
'notReady' will not be used."
::= { mgDomainNameEntry 4 }
mgEndpointExtTable OBJECT-TYPE
SYNTAX SEQUENCE OF MgEndpointExtEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table extends the mgEndpointTable.
Objects that do not directly describe the endpoint
but extend the rules to configure the mgEndpointTable
can be added to this table.
Each table entry describes an instance of an endpoint
on a media gateway."
::= { mediaGatewayEndpoint 3 }
mgEndpointExtEntry OBJECT-TYPE
SYNTAX MgEndpointExtEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Each entry represents a media gateway endpoint
interface."
AUGMENTS { mgEndpointEntry }
::= { mgEndpointExtTable 1 }
MgEndpointExtEntry::= SEQUENCE {
mgEndpointRepetition Unsigned32
}
mgEndpointRepetition OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object is used to create multiple rows in the
mgEndpointTable as specified in the SNMP PDU,
starting from the row specified by the index of
the instance for the number of rows specified in
this object.
The repetition operation will start from the
mgEndpointNumber, mgEndpointLineNumber and
mgEndpointChannelMap that is specified in the PDU
and will add rows for the number specified in this
object. If for a given mgEndpointLineNumber all the
endpoints channels are exhausted, it will proceed
to the next mgEndpointLineNumber. This will continue
until the number of repetitions specified in this object
is exhausted or the number of DS1s and endpoints is
exhausted, whichever comes first.
The agent will need to be able to populate the objects
in the mgEndpointTable with the appropriate values as new
rows are created.
"
DEFVAL { 1 }
::= { mgEndpointExtEntry 1 }
-- ***************************************************************
-- Media gateway control notification
-- ***************************************************************
-- ***************************************************************
-- Conformance
-- ***************************************************************
mgMIBConformance OBJECT IDENTIFIER ::= { ciscoWanMgMIB 3 }
mgMIBCompliances OBJECT IDENTIFIER ::= { mgMIBConformance 1 }
mgMIBGroups OBJECT IDENTIFIER ::= { mgMIBConformance 2 }
--
-- Conformance and compliance statements
-- ************************************************************
-- This group will not be used as mgcDnsResolution object type
-- is deprecated from MGC table, mgcDnsResolutionFlag object
-- is added in DNS table and also introduced a new table
-- mgDomainTable.
mgMIBCompliance MODULE-COMPLIANCE
STATUS deprecated -- replaced by mgMIBCompliance1
DESCRIPTION
"The compliance statement for the SNMP entities
which implement MGMIB."
MODULE -- this module
MANDATORY-GROUPS { mediaGatewayGroup,
mediaGatewayControllerGroup,
mediaGatewayEndpointGroup,
mediaGatewayLineGroup
}
GROUP mediaGatewayControllerResolutionGroup
DESCRIPTION
"The Media Gateway Controller Resolution Group is mandatory for
gateways which do not support IP address resolution by DNS."
::= { mgMIBCompliances 1 }
mgMIBCompliance1 MODULE-COMPLIANCE
STATUS deprecated -- replaced by mgMIBCompliance2
DESCRIPTION
"The compliance statement for the SNMP entities
which implement MGMIB."
MODULE -- this module
MANDATORY-GROUPS { mediaGatewayGroup,
mediaGatewayControllerGroup1,
mediaGatewayEndpointGroup,
mediaGatewayLineGroup,
mediaGatewayDomainNameGroup
}
GROUP mediaGatewayControllerResolutionGroup1
DESCRIPTION
"The Media Gateway Controller Resolution Group is mandatory for
gateways which do not support IP address resolution by DNS."
::= { mgMIBCompliances 2 }
mgMIBCompliance2 MODULE-COMPLIANCE
STATUS deprecated
DESCRIPTION
"The compliance statement for the SNMP entities
which implement MGMIB."
MODULE -- this module
MANDATORY-GROUPS { mediaGatewayGroup,
mediaGatewayControllerGroup2,
mediaGatewayEndpointGroup,
mediaGatewayLineGroup,
mediaGatewayDomainNameGroup
}
GROUP mediaGatewayControllerResolutionGroup1
DESCRIPTION
"The Media Gateway Controller Resolution Group is mandatory for
gateways which do not support IP address resolution by DNS."
OBJECT mgEndpointName
MIN-ACCESS read-only
DESCRIPTION
"Object may be created by the agent with a
value that cannot be changed."
::= { mgMIBCompliances 3 }
mgMIBCompliance3 MODULE-COMPLIANCE
STATUS current
DESCRIPTION
"The compliance statement for the SNMP entities
which implement MGMIB."
MODULE -- this module
MANDATORY-GROUPS { mediaGatewayGroup,
mediaGatewayControllerGroup2,
mediaGatewayEndpointGroup,
mediaGatewayLineGroup,
mediaGatewayDomainNameGroup
}
GROUP mediaGatewayControllerResolutionGroup1
DESCRIPTION
"The Media Gateway Controller Resolution Group is mandatory for
gateways which do not support IP address resolution by DNS."
OBJECT mgEndpointName
MIN-ACCESS read-only
DESCRIPTION
"Read-create access is not required for this object."
GROUP mediaGatewayEndptRepetitionGroup
DESCRIPTION
"The Media Gateway End point extension feature group.
This group is mandatory for the managed system that
supports the repetition operation of mgEndpointTable."
::= { mgMIBCompliances 4 }
--
-- units of conformance
--
-- MIB Groups
--
mediaGatewayGroup OBJECT-GROUP
OBJECTS {
mgName,
mgAdministrativeState,
mgAdministrativeStateControl,
mgShutdownGraceTime,
mgProtocolName
}
STATUS current
DESCRIPTION
"This group contains objects that apply to the media gateway as
a whole, such as global parameters and state."
::= { mgMIBGroups 1 }
mediaGatewayControllerGroup OBJECT-GROUP
OBJECTS {
maxConcurrentMgcs,
mgcName,
mgcDnsResolution,
mgcAssociationState,
mgcAssociationStateControl,
mgcUnassociationPolicy,
mgcCommLossUnassociationTimeout,
mgcRowStatus,
mgcProtocolRowStatus
}
STATUS deprecated -- replaced by mediaGatewayControllerGroup1
DESCRIPTION
"This group contains objects that describe the Media Gateway
Controllers with which the Media gateway communicates."
::= { mgMIBGroups 2 }
mediaGatewayEndpointGroup OBJECT-GROUP
OBJECTS {
mgEndpointCreationPolicy,
mgEndpointName,
mgEndpointLineNumber,
mgEndpointSpeed,
mgEndpointState,
mgEndpointChannelMap,
mgEndpointRowStatus
}
STATUS current
DESCRIPTION
"This group contains objects describing the media gateway's
endpoints."
::= { mgMIBGroups 3 }
mediaGatewayLineGroup OBJECT-GROUP
OBJECTS {
channelAssignment,
lineName
}
STATUS current
DESCRIPTION
"This group contains objects which relate lines to endpoints.
These objects complement the information contained in a line
MIB."
::= { mgMIBGroups 4 }
mediaGatewayControllerResolutionGroup OBJECT-GROUP
OBJECTS {
mgcResolutionName,
mgcResolutionIpAddress,
mgcResolutionCommState,
mgcResolutionPreference,
mgcResolutionRowStatus
}
STATUS deprecated -- replaced by
-- mediaGatewayControllerResolutionGroup1
DESCRIPTION
"This group contains information to resolve names to IP
addresses in the absence of DNS support."
::= { mgMIBGroups 5 }
mediaGatewayControllerGroup1 OBJECT-GROUP
OBJECTS {
maxConcurrentMgcs,
mgcName,
mgcAssociationState,
mgcAssociationStateControl,
mgcUnassociationPolicy,
mgcCommLossUnassociationTimeout,
mgcRowStatus,
mgcProtocolRowStatus
}
STATUS deprecated -- replaced by mediaGatewayControllerGroup2
DESCRIPTION
"This group contains objects that describe the MGCs with
which the MG communicates."
::= { mgMIBGroups 6 }
mediaGatewayControllerResolutionGroup1 OBJECT-GROUP
OBJECTS {
mgcResolutionName,
mgcResolutionIpAddress,
mgcResolutionCommState,
mgcResolutionPreference,
mgcResolutionRowStatus,
mgcDnsResolutionFlag
}
STATUS current
DESCRIPTION
"This group contains information to resolve names to IP
addresses both in the absence of DNS support and with
DNS support."
::= { mgMIBGroups 7 }
mediaGatewayDomainNameGroup OBJECT-GROUP
OBJECTS {
mgDomainName,
mgDnsResolutionType,
mgDomainNameRowStatus
}
STATUS current
DESCRIPTION
" This group contains domain names and information about how
these domain names will be resolved."
::= { mgMIBGroups 8 }
mediaGatewayControllerGroup2 OBJECT-GROUP
OBJECTS {
maxConcurrentMgcs,
mgcName,
mgcRowStatus
}
STATUS current
DESCRIPTION
"This group contains objects that describe the Media Gateway
Controllers with which the Media gateway communicates."
::= { mgMIBGroups 9 }
mediaGatewayEndptRepetitionGroup OBJECT-GROUP
OBJECTS {
mgEndpointRepetition
}
STATUS current
DESCRIPTION
"This group contains repetition objects describing the
media gateway's endpoints as defined in the
mgEndpointExtTable."
::= { mgMIBGroups 10 }
END