Install and Configure Unified RTMT
Install Unified RTMT
Note |
|
Before you begin
-
The current Unified RTMT requires JRE to run. Verify that the system has JRE installed (Java 1.8).
-
Download the CiscoRTMTPlugin.zip file for installation.
-
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
Red Hat Linux installation with KDE or GNOME client installed on Linux machines.
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 on Linux or Microsoft Windows operating system, download the CiscoRTMTPlugin.zip from the Download link for the Cisco Unified Real-Time Monitoring Tool - Windows and Linux Tool.
|
||||||||
Step 4 |
Download the CiscoRTMTPlugin.zip to the preferred location on your client machine. |
||||||||
Step 5 |
To install the Windows version,
|
||||||||
Step 6 |
To install the Linux version,
|
Note |
You can add desktop shortcut icons to the home directory for the run.bat or the run.sh files. See Create shortcut to launch Unified RTMT (Optional).
|
Create shortcut to launch Unified RTMT (Optional)
You can add desktop shortcut icons to the home directory for the run.bat
(Windows) or the run.sh
(Linux) version files.
Procedure
Step 1 |
To install the Windows version,
|
Step 2 |
To install the Linux version,
|
Upgrade RTMT
Tip |
To ensure compatibility, we recommend 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.
Note |
Before you upgrade to a newer version of RTMT, we recommend that you delete the previous or older versions of the unzipped CiscoRTMTPlugin.zip folder. |
To upgrade RTMT, see Install Unified RTMT.
Launch Unified RTMT
Before you begin
For single sign-on in Windows 10 and above, run Unified RTMT as an administrator.
Note |
Ensure that the required hostnames for the Unified Communications Manager clusters are reachable from your local machine for the Unified 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>
If there is a latest version of the tzupdater.jar file available, download the tzupdater.jar files to the JRE_HOME/bin directory used by Unified RTMT before launching Unified RTMT. It's 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 extract the CiscoRTMTPlugin.zip folder, open the folder and double-click the |
||
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.
|
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 won't 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.
Launch Unified RTMT using certificate based authentication—Windows
Before you begin
-
Oracle JDK (1.8)/OpenJDK (1.8) with JFX module should be installed
-
Client certificates should be imported into the Windows systems keystore before launching the Unified RTMT application
Procedure
Step 1 |
Press Windows+R and type mmc to launch the Microsoft Management Console. |
Step 2 |
Navigate to the File Menu and select Add/Remove Snap-In option. |
Step 3 |
Add the Certificates option from the Available Snap-in drop-down list. |
Step 4 |
Choose “My user account” and finish the task by clicking the OK button. |
Step 5 |
Select Certificates (Current user) > Personal from the Certificates Tree. |
Step 6 |
Right-click on the certificate screen to import the user certificate into the system keystore. |
Step 7 |
Launch Unified RTMT using the When Unified RTMT displays the User Identification Request pop-up window, you must select a valid user certificate from the drop-down list. |
Launch Unified RTMT using certificate based authentication—Linux
Before you begin
-
OpenSSL 3.0 version should be installed
-
Oracle JDK (1.8)/OpenJDK (1.8) with JFX module rpm installed
-
User keystore and passphrase should be generated with the
genkeystore.sh
file before launching Unified RTMT.
Procedure
Step 1 |
Upload the user certificate to a directory on the Linux server. |
Step 2 |
Navigate to the Enter the client certificate's absolute path |
Step 3 |
After the user certificate is successfully exported into the new keystore, relaunch Unified RTMT to start using this keystore. |
Step 4 |
Launch Unified RTMT using the When Unified RTMT displays the User Identification Request pop-up window, you must select a valid user certificate from the drop-down list. |
Note |
To import another certificate into the Unified RTMT User Keystore, ensure that you rerun the genkeystore.sh script and relaunch Unified RTMT for the changes to reflect.
|
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 the following entities:
-
A Unified Communications Manager product on one node.
-
An IM and Presence Service on one node.
-
A Unity Connection product 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 Unified CM, IM and Presence Service, and Unity Connection that are installed on different nodes.
You can install multiple versions of Unified Communications Manager Unified RTMT on a single computer. You can also launch multiple instances of the same Unified RTMT from the downloaded zip file.
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. |