Cisco Unity SNMP Extension Agent & CISCO-UNITY-MIB.my
Previous Topic  Next Topic 

The main feature of the Remote Serviceability Kit is the Cisco Unity SNMP extension Agent. This extension agent implements the objects contained in the CISCO-UNITY-MIB. You can find a copy of the CISCO-UNITY-MIB in the MIBs subdirectory of the RSKConfigurationWizard\Distributables directory (default location is \CommServer\Utilities\RSKConfigurationWizard\Distributables\Mibs). You can read the description of each of the objects directly from the CISCO-UNITY-MIB.my file using a text editor. The tables below give a brief description of each object and table contained in the MIB.

ciscoUnityTable 

This table lists out all of the Unity servers and information about those servers. The information that this table is based on rarely changes.

Column Name

Description

ciscoUnityIndex

An arbitrary index into the Unity Server table.

ciscoUnityName

The host name of the Unity server.

ciscoUnityVersion

The version number of the Unity server software. If you have multiple Unity servers only the version number of the server your NMS is talking to will display. Currently there is no way to get the Unity version information from another Unity server.

 

ciscoUnityPortTable 

This table provides details on the ports of the local Unity server and their configurations. The information that this table is based on rarely changes.

Column Name

Description

ciscoUnityPortIndex

Arbitrary index into the Port table

ciscoUnityPortNumber

The Unity voice messaging port number.

ciscoUnityPortIntegration

The phone system integration to which this port belongs. This could be Cisco CallManager or a traditional PBX.

ciscoUnityPortExtension

The extension for the port as assigned on the phone system.

ciscoUnityPortEnabled

This indicates whether this port is enabled on the local Unity server.

ciscoUnityPortAnswerCalls

This indicates whether this port is designated to answer incoming calls.

ciscoUnityPortMessageNotif

This indicates whether this port is designated for notifying subscribers of messages.

ciscoUnityPortDialoutMWI

This indicates whether this port is designated for turning MWIs on and off.

ciscoUnityPortAMISDelivery

This indicates whether this port is designated for making outbound AMIS calls to deliver voice messages from Unity subscribers to users on another voice messaging system.

ciscoUnityPortTRAPConnection

This indicates whether this port is designated for use by subscribers as a Telephone Recording And Playback (TRAP) device in Unity web applications and e-mail clients.

General Unity Usage Info 

Scalar objects related to capacity and utilization. While Unity is running, much of this information is constantly changing. You can use these objects to watch port usage of your Unity servers to detect possible port capacity issues with your voice mail servers.

Object Name

Description

ciscoUnityServerState

The current state of Unity: Stopped, Starting, Running, or Stopping

ciscoUnityPorts

The total number of ports on the local Unity server.

ciscoUnityPortsActive

The total number of ports that are currently active with calls.

ciscoUnityPortsInbound

The total number of ports that are designated to answer incoming calls.

ciscoUnityPortsInboundActive

The number of inbound ports that are currently active with calls. *

ciscoUnityPortsOutbound

The total number of ports that are designated for outbound calls (includes message notification, MWI dialout, AMIS delivery, or TRAP Connections).

ciscoUnityPortsOutboundActive

The number of outbound ports that are currently active with calls..*

* Currently there is no way to tell the reason a port is active only that it is not idle. For example, there is not a way to tell that port 5 is active because it is performing message notification or that port 2 is active because an outside caller was forwarded to it by the phone system to take a message. What this means is that the objects, ciscoUnityPortsInboundActive and ciscoUnityPortsOutboundActive, do not indicate the number of inbound or outbound calls on the system but rather indicate the number of inbound or outbound designated ports that are currently active. It is entirely possible that the system has only one call active but that both ciscoUnityPortsInboundActive and ciscoUnityPortsOutboundActive have a value of 1. This would happen anytime a port has both inbound and outbound capabilities and is active.

What these two objects allow the administrator to do is to watch their servers port usage over time to better adjust the number of inbound vs. outbound ports. For example: If ciscoUnityPortsInboundActive ever equals ciscoUnityPortsInbound then that indicates that the server has no more ports available for answering calls. The same thing applies to ciscoUnityPortsOutboundActive equaling ciscoUnityPortsOutbound, which indicates that the server has no more ports available for outbound calls.

unityMonitoredEvent Trap 

This is a generic trap that contains information from the Windows Event Log concerning an event the Event Monitoring Service (EMS) is configured to monitor. Although this Trap is part of the CISCO-UNITY-MIB and the Cisco Unity SNMP extension agent the EMS is actually responsible for trigging this Trap. You must have configured a SNMP Trap recipient and a monitored event in the EMS before this Trap will be triggered.

Object Name

Description

 

ciscoUnityEventType

The type of event log message: error, warning or informational

ciscoUnityEventSource

The software that logged the event, which can be either a program name, a component of the system, or a component of a large program.

ciscoUnityEventCategory

A classification of the event by the event source.

ciscoUnityEventId

A number identifying the particular event type. The EventID and EventSource can be used to troubleshoot system problems.

ciscoUnityEventDate

The date and time the event occurred.

ciscoUnityEventUser

The user name of the user on whose behalf the event occurred. This name is the client ID if the event was actually caused by a server process, or the primary ID if impersonation is not taking place.

ciscoUnityEventComputer

The name of the computer where the event occurred.

ciscoUnityEventDescription

The event description indicates what happened or the significance of the event.

ciscoUnityEventEMSNotes

The contents of the notes field as entered into the EMS for this monitored event.