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 Red Hat Linux with KDE
and/or Gnome client.
Note
RTMT requires at least 128 MB in memory to run on a Windows OS
platform.
Note
RTMT requires at least 300 MB of disk space to run on a
Windows/Linux OS platform.
This chapter contains information on the following topics:
A single copy of RTMT that is installed on your computer lets
you monitor one server or one cluster at a time. For example, you can monitor
either of the following entities:
A Unified CCX product on
one server.
A server on a cluster to
monitor the health of the cluster.
To monitor a product on a different server, you must first
log off the server before you can log on to the other server.
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.
Note
For accessing Unified Analysis Manager, install the RTMT Client from
Cisco Unified Communications Manager on a separate Client box.
Consider the following limitations, before you install RTMT:
On a client machine, you
can install RTMT client downloaded from only one product type - Unified CCX or
Unified CM. Installing RTMT client from different product types on the
same client machine is not supported.
The current RTMT download
may not support earlier releases of Unified CCX. Some releases of Unified CCX
may require different versions of RTMT to be installed on your computer (one
version per Unified CCX release). Verify that the RTMT version that you install
is compatible with the Unified CCX that you are monitoring. If the RTMT version
that you are using is not compatible with the server that you want to monitor,
the system prompts you to download the compatible version.
Your computer stores the
user preferences, such as the IP address and RTMT frame size, from the RTMT
client that last exits.
To install the tool, perform the following procedure:
Procedure
Step 1
Go to the Plug-ins window of the administration interface for your
configuration by choosing
Applications or
System Settings > Plugins from the Cisco Unified
Contact Center Express Administration Web interface.
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 CCX
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 CCX
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.
When you use RTMT, it saves user preferences and the module jar
files (the cache) locally on the client machine. When you uninstall RTMT, you
choose whether to delete or save the cache.
On a Windows client, you uninstall RTMT through
Add/Remove Programs under the Control Panel.
(Choose
Start > Settings > Control Panel > Add/Remove Programs.)
To uninstall RTMT on a Red Hat Linux with KDE and/or Gnome
client, choose
Start > Accessories > Uninstall Real-time Monitoring tool from the task bar.
Note
When you uninstall RTMT on a Windows Vista machine, the following User Account Control pop-up message displays:
"An unidentified program wants to access your computer." Click
Allow to continue working with RTMT.
You must configure a second server as the failover collector in
Cisco Unified CCX Serviceability Administration, so RTMT can continue to
retrieve information if the primary collector fails. Otherwise, RTMT cannot
retrieve information if the primary collector has failed.
Note
While using RTMT on a Windows Vista machine, 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.
Note
While using RTMT on Windows 7 Client machine, launch RTMT using Run As Administrator option.
Procedure
Step 1
After you install the plug-in, perform one of the following tasks:
From your Windows desktop, double-click the
Real-Time Monitoring Tool icon.
In the Host IP Address field, enter either the IP address or host
name of the server or (if applicable) first server in a cluster.
Step 3
Enter the port that the application will use to listen to the
server. The default setting equals 8443.
Note
The Trace and Log Central tool in RTMT uses the port number that
you specify to communicate with all the nodes in a cluster. If your system uses
port mapping and all Unified CCX nodes do not map to the same port number, then
some RTMT tools can not connect to those nodes. The tools that will fail to
connect include Trace and Log Central, Job Status, SyslogViewer, Perfmon Log
Viewer, and FTP/SFTP Configuration.
Step 4
Check the
Secure Connection check box.
Step 5
Click
OK.
RTMT displays another window prompting for user name and password. Enter the details as given in the following steps
Step 6
In the User Name field, enter the Application Username for the
application.
Note
Use the Application User credentials (provided during the
Unified CCX installation) for logging in to RTMT. In case you forget the
Application User credentials, use the CLI commands utils
reset_application_ui_administrator_name and utils
reset_application_ui_administrator_password to reset the
credentials. For more information about these CLI commands, see the “Gathering
Configuration Information for Installation” section of the Installation Guide
for Cisco Unified Contact Center Express and Cisco Unified IP IVR available
here:
http://www.cisco.com/en/US/products/sw/custcosw/ps1846/prod_installation_guides_list.html
Step 7
In the Password field, enter the Administrator user password that
you established for the username.
Note
If the authentication fails or if the server is unreachable, the
tool prompts you to reenter the server and authentication details, or you can
click the Cancel button to exit the application. After the authentication
succeeds, RTMT launches the monitoring module from local cache or from a remote
server, when the local cache does not contain a monitoring module that matches
the backend version.
Step 8
When prompted, add the certificate store by clicking
Yes.
Real-Time Monitoring Tool starts.
The RTMT window comprises the following main components:
Menu Bar, which includes some or all of the following menu
options, depending on your configuration:
File—Allows you to save, restore, and delete existing RTMT
profiles, monitor Java Heap Memory Usage, go to the Serviceability Report
Archive window in Cisco Unified Serviceability, log off, or exit RTMT.
System—Allows you to monitor system summary, monitor server
resources, work with performance counters, work with alerts, collect traces,
and view syslog messages.
Edit—Allows you to configure categories (for table format
view), set the polling rate for devices and performance monitoring counters,
hide the quick launch channel, and edit the trace setting for RTMT.
Window—Allows you to close a single RTMT window or all RTMT
windows.
Application—Allows you to browse the applicable web pages for
Cisco Unified Serviceability.
Help—Allows you to access RTMT documentation online help or to
view the RTMT version.
Quick Launch Channel—Pane on the left side of RTMT window with
tabs that you can click to display information on the server or information on
the applications. The tab contains groups of icons that you can click to
monitor various objects.
Monitor pane—Pane where monitoring results display.
You can use RTMT to connect to a server or to any server in a
Unified CCX cluster (if applicable). After you log in to a server, RTMT
launches the monitoring module from the local cache or from a remote server
when the local cache does not contain a monitoring module that matches the
backend version.
RTMT includes a default configuration that is called Default.
The first time that you use RTMT, it uses the Default profile and displays the
system summary page in the monitor pane.
You can configure RTMT to display the information that
interests you, such as different performance counters for different features,
in the monitor pane of RTMT and save the framework of your configuration in a
profile. You can then restore the profile at a later time during the same
session or the next time that you log in to RTMT. By creating multiple
profiles, so each profile displays unique information, you can quickly display
different information by switching profiles.
Note
If you are running the RTMT client and monitoring performance
counters during a Unified CCX upgrade, the performance counters will not update
during and after the upgrade. To continue monitoring performance counters
accurately after the Unified CCX upgrade completes, you must either reload the
RTMT profile or restart the RTMT client.
When you initially load RTMT, the system includes a default profile that is called Default. The first time that you use RTMT, it will use the Default profile and display the system summary page in the monitor pane.
Add configuration profiles
With RTMT, you can customize your monitoring window by
monitoring different performance counters, then create your own configuration
profiles, so you can restore these monitoring windows in a single step rather
than opening each window again. You can switch between different profiles
during the same RTMT session or use the configuration profile in subsequent
RTMT sessions.
The following procedure describes how to create a profile.
Procedure
Step 1
Choose
System > Profile.
The Preferences dialog box displays.
Step 2
Click
Save.
The Save Current Configuration dialog box displays.
Step 3
In the Configuration name field, enter a name for this particular
configuration profile.
Step 4
In the Configuration description field, enter a description of
this particular configuration profile.
Note
You can enter whatever you want for the configuration profile
name and description.
Note
Profiles apply to all servers within a cluster, but the profile
cannot be saved and applied to a different cluster.
The system creates the new configuration profile.
Restore profiles
Perform the following procedure to restore a profile that
you configured:
Procedure
Step 1
Choose
System > Profile.
The Preferences dialog box displays.
Step 2
Click the profile that you want to restore.
Step 3
Click
Restore.
All windows with precanned settings and/or performance monitoring
counters for the restored configuration open.
Delete configuration profiles
Perform the following procedure to delete a profile that you
configured:
Procedure
Step 1
Choose
System > Profile.
The Preferences dialog box displays.