Installation and configuration

Installation and configuration

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:

Install RTMT

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.

    Default installation paths are:

    1. Windows—C:\Program Files\Cisco\Unified Serviceability\JRtmt
    2. Linux—/opt/ Cisco/Unified Serviceability/JRtmt
    Step 10   To begin the installation, click Next.

    The Setup Status window displays.

    Important:

    Do not click Cancel.

    Step 11   To complete the installation, click Finish.

    Related Information

    Uninstall RTMT


    Tip


    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.


    Related Information

    Launch RTMT


    Caution


    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:
      1. From your Windows desktop, double-click the Real-Time Monitoring Tool icon.
      2. Choose Start > All Programs > Cisco > Unified Serviceability > Real-Time Monitoring Tool. The Real-Time Monitoring Tool Login window displays.
      Step 2   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.

      Related Information

      RTMT Navigation

      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.

      See the Additional information.

      Configuration profiles

      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.


      Default configuration profile

      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.
            Step 2   Click the profile that you want to delete.
            Step 3   Click Delete.
            Step 4   Click Close.

            Related Information

            Additional information