Install and Configure Unified RTMT
Install Unified RTMT
Before you begin
Before you install Unified RTMT, consider the following:
-
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.
- On a client machine, you can install Unified RTMT downloaded from only one product type. Installing the Unified RTMT client from different product types on the same client machine is not supported.
-
The current Unified RTMT download may not support 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 Unified Communications Manager 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.
- To enable the single sign-on feature, see the "Single Sign-On" chapter in Cisco Unified Communications Manager Features and Services Guide.
- To enable the SSO feature on Unified RTMT, modify the Windows registry as follows:
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Lsa\Kerberos\Value Name: allowtgtsessionkey Value Type: REG_DWORD Value: 0x01
-
Windows 7 and above: To use SSO, right-click Unified RTMT and select Run as administrator.
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. |
Note |
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 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 10 |
To begin the installation, click Next. The Setup Status window appears. |
||||||||
Step 11 |
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. |
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, Cisco recommends 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
For single sign-on in Windows 8.1, run Unified RTMT as an administrator.
For single sign-on in Windows 8.1 or Windows 10, run Unified RTMT as an administrator.
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>
Procedure
Step 1 |
After you install the plug-in, open Unified RTMT. If you have a Windows 8.1 client and you want to use the single sign-on feature, right click the Unified RTMT shortcut on your desktop or start menu and click Run as Administrator. If you have a Windows 8.1 or Windows 10 client and you want to use the single sign-on feature, right click the Unified RTMT shortcut on your desktop or start menu and click Run as Administrator. Please allow some time for the application to load and relaunch it if you choose to synchronize the time zone.
|
||
Step 2 |
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 3 |
Click OK.
|
||
Step 4 |
In the User Name field, enter the Administrator username for the application. |
||
Step 5 |
In the Password field, enter the Administrator user password that you established for the username.
|
||
Step 6 |
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 Cisco Unified Communications Manager Administration Guide and .
Run a Program as an Administrator
Follow this procedure to run a program as an administrator in Windows 7 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 only one server or one cluster at a time. For example, you can monitor either of the following entities:
-
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 first sign off the node before you can sign on to the other node.
Note |
Beware of the following limitations: To monitor clusters that are running different versions of the IM and Presence service simultaneously, you must install multiple versions of Unified RTMT (one version per IM and Presence release). If you install multiple versions of the plug-in, you can install the versions on the same client as long as the version exist in different folders. If the installation detects another version in the folder, a message displays. To continue the installation, install the version in a different folder. |
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. |