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 server’s 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. |