Install and Configure Unified RTMT
Install Unified RTMT
Before you begin
-
Unified RTMT requires at least 128 MB in memory to run on a Windows OS platform; the tool requires at least 300 MB of disk space to run on a Windows/Linux OS platform.
Note
The Linux Unified RTMT plugin CcmServRtmtPlugin.bin can be installed on RHEL 5, RHEL 6, or higher Linux machines. If you want to install it on a RHEL 4 machine, ensure that the glibc (OS library) version is 2.4.x or higher. If the glibc version is 2.3.x or earlier, the underlying JRE install fails.
- The current Unified RTMT download supports earlier releases of Unified Communications Manager or Cisco Unity Connection. Some releases of Unified Communications Manager may require different versions of Unified RTMT to be installed on your computer (one version per Unified Communications Manager release). Verify that the Unified RTMT version that you install is compatible with the product that you are monitoring. If the Unified 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 Unified RTMT frame size, based on the last instance of Unified RTMT that you run.
Note |
Only the administrators with Standard Audit Users and Standard CCM Super Users privileges have access to Unified RTMT features. If an application user without these privileges logs into Unified RTMT, some of the features such as Call Control Discovery (CCD) and Service Advertisement Framework (SAF) will not work as expected. |
Note |
On a Linux workstation, run RTMT with root access. Otherwise, when you initially install RTMT, the application will not start. |
-
The current Unified RTMT requires JRE to run. Verify that the system has JRE installed (Java 1.8).
Procedure
Step 1 |
Go to the Plug-ins window of the administration interface for your configuration:
|
||||||||
Step 2 |
Click Find. |
||||||||
Step 3 |
To install Unified RTMT on a client that is running the Microsoft Windows operating system, click the Download link for the Real-Time Monitoring Tool - Windows. To install Unified RTMT on a client that is running the Linux operating system, click the Download link for the 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 Unified RTMT icon that appears on the desktop or locate the directory where you downloaded the file and run the Unified 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 Unified RTMT welcome window appears, 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 absolute path of Java Virtual Machine executable from your system (java.exe from the JRE installed directory, that is latest version 1.8) as prompted in the installation screen of Unified RTMT. |
||||||||
Step 10 |
Choose the location where you want to install Unified RTMT. If you do not want to use the default location, click Browse and navigate to a different location. Click Next. |
||||||||
Step 11 |
To begin the installation, click Next. The Setup Status window appears. |
||||||||
Step 12 |
To complete the installation, click Finish. |
Upgrade RTMT
Tip |
To ensure compatibility, Cisco recommends that you upgrade RTMT after you complete the upgrade on all servers in the cluster. |
Note |
When an IM and Presence Service node is configured as the primary collector for the Cisco AMC service and an upgrade is performed,
we see the following error in Unified RTMT:
|
RTMT saves user preferences and downloaded module jar files locally on the client machine. The system saves user-created profiles in the database, so you can access these items in Unified RTMT after you upgrade the tool.
Before you begin
Before you upgrade to a newer version of RTMT, we recommend that you uninstall the previous version.
Procedure
Step 1 |
From Unified Communications Manager Administration, choose . |
Step 2 |
Click Find. |
Step 3 |
Perform one of the following actions:
|
Step 4 |
Download the installation file to your preferred location. |
Step 5 |
Locate and run the installation file. |
Step 6 |
In the RTMT welcome window, click Next. |
Step 7 |
Because you cannot change the installation location for upgrades, click Next. |
Step 8 |
In the Maintenance Complete window, click Finish. |
Launch Unified RTMT
Before you begin
Note |
If your Root or Intermediate CA Certificate uses the RSASSA-PSS signature algorithm, do not sign the Tomcat certificate with this CA; otherwise, RTMT will not launch. This is because the TLS versions through 1.2 does not support the RSASSA-PSS Signature Algorithm and a bug is opened against Java to add this support in a future TLS version. |
Note |
Ensure that all of the required hostnames for the Unified Communications Manager clusters are reachable from your local machine for the RTMT functionalities to work properly. |
This requires adding the hostnames to the host file on the local machine. For example:
-
For Unified RTMT running on Windows OS platform, use the following format to update the host file located at C:\Windows\System32\drivers\etc\hosts: <ServerIP> <Hostname> <FQDN>
-
For Unified RTMT running on Linux OS platform, use the following format to update the host file located at
->/etc/hosts: <ServerIP> <Hostname> <FQDN>
Download tzupdater.jar files to the JRE_HOME/bin directory used by Unified RTMT before launching Unified RTMT for the first time. It is required to update the time zone of your system’s JRE used by Unified RTMT to that of the server that Unified RTMT tries to connect.
Procedure
Step 1 |
After you, install the plug-in, open Unified RTMT. |
||
Step 2 |
If you choose to synchronize the time zone, perform the following steps. |
||
Step 3 |
In the Host IP Address field, enter either the IP address or hostname of the node or (if applicable) the node in a cluster. |
||
Step 4 |
Click OK.
|
||
Step 5 |
In the User Name field, enter the Administrator username for the application. |
||
Step 6 |
In the Password field, enter the Administrator user password that you established for the username.
|
||
Step 7 |
When prompted, add the certificate store by clicking Yes. Unified RTMT starts.
|
What to do next
You can create a user with a profile that is limited only to Unified RTMT usage. The user will have full access to Unified RTMT but will not have permission to administer a node.
You can create a Unified RTMT user by adding a new application user in the administration interface and adding the user to the predefined Standard RealtimeAndTraceCollection group.
For complete instructions for adding users and user groups, see the Administration Guide for Cisco Unified Communications Manager and Cisco Unified Communications Manager System Guide.
Run a Program as an Administrator
Follow this procedure to run a program as an administrator in Windows 10 and later.
Note |
To use SSO with Unified RTMT on Windows, run Unified RTMT as an administrator. |
Before you begin
Be aware of the following behavior:
-
If you're using single sign-on (SSO), allow time for Unified RTMT to load.
-
For the time zone synchronization prompt, selecting Yes causes Unified RTMT to close itself. After this happens, you must manually restart the program as an administrator.
Procedure
Step 1 |
Locate the program shortcut. |
Step 2 |
Right-click the shortcut. |
Step 3 |
Perform one of the following actions:
|
Multiple installations of Unified RTMT
A single copy of Unified RTMT that is installed on your computer lets you monitor more than one server or more than one cluster at a time. For example, you can monitor all of the following entities:
-
A Unified Communications Manager product on one node
-
An Intercompany Media Engine (IME) product on one node.
-
An IM and Presence Service on one node.
-
A node on a cluster to monitor the health of the cluster.
To monitor a product on a different node, you must use a new instance of Unified RTMT that is installed.
Multiple copies of Unified RTMT that are installed on your computer let you simultaneously monitor multiple IM and Presence Services that are installed on different nodes.
When you install multiple copies of Unified RTMT on a single computer, you must install Unified RTMT in different folders. Cisco recommends that you install no more than four copies of Unified RTMT on a computer.
Because installing another copy of Unified RTMT overwrites the shortcut icon, you should complete the following tasks:
-
Create another icon by creating a shortcut to jrtmt.exe in the folder with the previous installation.
-
Rename the icon accordingly.
If the installation detects another version in the selected folder, a message displays. To continue the installation, install the version in a different folder.
Note |
Your computer stores the user preferences, such as the IP address and Unified RTMT frame size, from the Unified RTMT client that last exits. |