This document describes how to monitor the Cisco Unity Connection and Cisco Unified Communications Manager servers using Cisco Unified Real- Time Monitoring Tool (RTMT). It covers the Installation and configuration of the RTMT along with the procedures to configure the System Alerts.
Cisco Unified Real-Time Monitoring Tool (RTMT)
The Cisco Unified Real-Time Monitoring Tool (RTMT), which runs as a client-side application, uses HTTPS and TCP to monitor system performance, device status, device discovery, CTI applications, and voice messaging ports. RTMT can connect directly to devices via HTTPS to troubleshoot system problems.
RTMT allows you to perform the following tasks:
Monitor a set of predefined management objects that monitor the health of the system.
Generate various alerts, in the form of e-mails, for objects when values go over/below user- configured thresholds.
Collect and view traces in various default viewers that exist in RTMT.
View syslog messages in SysLog Viewer.
Work with performance-monitoring counters
When CUCMs are using MGCP gateways instead of H.323 gateways blocking calls based on ANI or Calling Number becomes difficult or not possible in older Cisco Unified Communications Manager (CUCM) versions which is below 8.x
Installing and Configuring Cisco Unified Real-Time Monitoring Tool
You can install Cisco Unified Real-Time Monitoring Tool (RTMT), which works for resolutions 800*600 and above, on a computer that is running Windows 98, Windows XP, Windows 2000, Windows Vista, or Linux with KDE and/or Gnome client.
Note: RTMT requires at least 128 MB in memory to run on a Windows OS platform.
To install the tool, perform the following procedure:
Note : While installing RTMT on a Windows Vista platform, you will see a User Account Control pop-up message that says, "An unidentified program wants to access your computer." Click Allow to continue working with RTMT.
Step 1: Go to the Plug-ins window of the administration interface for your configuration:
Table 1 RTMT Plug-in
From Cisco Unity Connection Administration, choose System Settings > Plugins.
Cisco Unified Communications Manager
From Cisco Unified Communications Manager Administration, choose Applications > Plugins.
Step 2: Click the Find button.
Step 3: To install the RTMT tool on a client that is running the Microsoft Windows operating system, click the Download link for the Cisco Unified CM Real-Time Monitoring Tool-Windows.
To install the RTMT tool on a client that is running the Linux operating system, click the Download link for the Cisco Unified CM Real-Time Monitoring Tool-Linux.
Step 4:Download the executable to the preferred location on your client.
Step 5: To install the Windows version, double-click the RTMT icon that displays on the desktop or locate the directory where you downloaded the file and run the RTMT installation file.The extraction process begins.
Step 6: To install the Linux version, ensure that the file has execute privileges; for example, enter the following command, which is case sensitive: chmod +x CcmServRtmtPlugin.bin
Step 7: After the RTMT welcome window displays, click Next.
Step 8: To accept the license agreement, click I accept the terms of the license agreement; then, click Next.
Step 9:Choose the location where you want to install RTMT. If you do not want to use the default location, click Browse and navigate to a different location. Click Next.
Step 10: To begin the installation, click Next.
The Setup Status window displays. Do not click Cancel.
Step 11: To complete the installation, click Finish.
Performance Objects and Counters for Cisco Unity Connection
Following are the Cisco Unity Connection-related objects and counters that can be monitored through RTMT
CUC Data Store
CUC Data Store: Databases
CUC Message Store
CUC Message Store: Databases
CUC Personal Call Transfer Rules
CUC Phone System
CUC Phone System: Ports
CUC Sessions: Calendar Access
CUC Sessions: E-mail Access
CUC Sessions: IMAP Server
CUC Sessions: RSS
CUC Sessions: SMTP Server
CUC Sessions: TRaP
CUC Sessions: TTS
CUC Sessions: Voice
CUC Sessions: VUI
CUC Sessions: Web
CUC Sessions: Web Calendar Access
CUC Sessions: Web E-mail Access
Using RTMT for Alerts
The system generate alert messages to notify administrator when a predefined condition is met, such as when an activated service goes from up to down. The system can send alerts as e-mail/epage.
RTMT, which supports alert defining, setting, and viewing, contains preconfigured and user-defined alerts. Although you can perform configuration tasks for both types, you cannot delete preconfigured alerts (whereas you can add and delete user-defined alerts).
The Alert menu comprises the following menu options:
• Alert Central-This option comprises the history and current status of every alert in the system.
Note You can also access Alert Central by clicking the Alert Central icon in the hierarchy tree in the system drawer.
• Set Alert/Properties-This menu option allows you to set alerts and alert properties.
• Remove Alert-This menu category allows you to remove an alert.
• Enable Alert-With this menu category, you can enable alerts.
• Disable Alert-You can disable an alert with this category.
• Suspend cluster/node Alerts-This menu category allows you to temporarily suspend alerts on a particular server or on an entire cluster (if applicable).
• Clear Alerts-This menu category allows you to reset an alert (change the color of an alert item to black) to signal that an alert has been handled.
After an alert has been raised, its color will automatically change in RTMT and will stay that way until you manually clear the alert.
• Clear All Alerts-This menu category allows you to clear all alerts.
• Alert Detail-This menu category provides detailed information on alert events.
• Config Email Server-In this category, you can configure your e-mail server to enable alerts.
Note To configure RTMT to send alerts via e-mail, you must configure DNS.
• Config Alert Action-This category allows you to set actions to take for specific alerts; you can configure the actions to send the alerts to desired e-mail recipients.
In RTMT, you configure alert notification for perform counter value thresholds and set alert properties for the alert, such as the threshold, duration, frequency, and so on.
You can locate Alert Central under the Tools hierarchy tree in the quick launch. Alert Central provides both the current status and the history of all the alerts in the system.
System Alerts - Cisco Unity Connection
System alerts - Cisco Unity Connection
The following list comprises the preconfigured system alerts.
ServerDown (Unified CM clusters only)
Cisco Unity Connection Alerts
The following list comprises the preconfigured Cisco Unity Connection alerts. These alerts apply only to Cisco Unity Connection and Cisco Unified Communications Manager Business Edition.
Perform the following procedure to configure e-mail information for alert notification.
To configure RTMT to send alerts via e-mail, you must configure DNS. For information on configuring the primary and secondary DNS IP addresses and the domain name in Cisco Unified Communications Manager Server Configuration, see the DHCP Server Configuration chapter in the Cisco Unified Communications Manager Administration Guide.
Step 1: Choose System > Tools > Alert > Config Email Server. The Mail Server Configuration window displays.
Step 2: Enter the address of the mail server in the Mail Server field.
Step 3: Enter the port number of the mail server in the Port field.
Step 4: To add recipients, click Add in the Recipients section. The Input box displays.
Step 5: Enter the address of the intended recipient in the Enter e-mail/epage address field. Repeat Step 5 as necessary to enter all intended e-mail recipients.
Step 6: (Optional) Enter a message that will be sent with the alert in the Default Message field.
Step 7: Click OK.
Port Monitor Overview
The RTMT Port Monitor lets you monitor the activity of each Cisco Unity Connection voice messaging port in real time. This information can help you determine whether they system has too many or too few ports.
This tool can display the following information for each port:
Table 2 Port Monitor Parameters
Port Monitor Parameter
Port Name: The display name of the port in Cisco Unity Connection Administration.
Caller: For incoming calls, the phone number of the caller.
Called: For incoming calls, the phone number that was dialed.
Reason: If applicable, the reason why the call was redirected.
Redir: The extension that redirected the call. If the call was redirected by more than one extension, this field shows the extension prior to the last extension.
Last Redir: The last extension that redirected the call.
Application Status: The name of the conversation that Cisco Unity Connection is playing for the caller. When the port is not handling a call, the status specifies "Idle."
Display Status: The action that the conversation is currently performing. When the port is not handling a call, the status specifies "Idle."
Conversation Status: Specific details about the action that the conversation is performing. When the port is not handling a call, the status specifies "Idle."
Cisco Unified Communications Manager Alerts
The following list comprises the preconfigured CUCM alerts.
For alert descriptions and default configurations, refer