Graphical Administration Tool for TIBCO® EMS

Graphical Administration Tool for TIBCO(R) EMS (GEMS) is a graphical user interface utility for TIBCO(R) Enterprise Message Service. It can be used by JMS developers as a general purpose testing tool and by administrative support staff as a management and monitoring tool.

    Compatible Products

    TIBCO Enterprise Message Service™

    Provider

    TIBCO Software

    License

    TIBCO Component Exchange License

    Overview

    GEMS provides the following main features:

    • Server Monitoring. Server state and main statistics are automticaly updated, warning and error limits may be configured. Server generated events are also captured.
    • Server Management. Including, general server configuration, JMS destinations, JNDI factories, users/groups, permissions, bridges, routes etc.
    • JMS support. Messages may be sent/received, queues may be browsed and message contents inspected. Selectors and filters may be specified.
    • JMS Message Monitoring. Messages may be monitored (snooped) as they pass through the server. Request and reply messages can be correlated to provide service response times.
    • JMS Message Management. Eg; purging messages, copy messages from a queue to another queue on a different server.
    • Charting. Server statistics may be charted in real time, data may be saved to CSV files for export to other tools such as Excel.
    • Logging. Server statistics may be logged automatically when warning or error limits are breached.
    • Security. SSL connectivity, view only mode.
    • Customisable display and look and feel.
    • Support for Managing and Monitoring TIBCO SubStation.
    • Support for Monitoring TIBCO EMS Appliance.
    • Support for Migrating to TIBCO EMS Appliance.

    License Details

    Release(s)

    Release 5.1

    Published: August 2017

    Version 5.1
    -----------
    - Added support for new EMS 8.4 server properties:
        - get/setLargeDestCount
        - get/setLargeDestSize
        - getAdminConnectionCount
        - getClientConnectionCount
        - isAlwaysExitOnDiskErrorEnabled
        - isSSLRequireRouteCertOnly
    - Destination PendingMsgCount/Size fields are highlighted in red if they reach MaxMsgs/Bytes or Server’s large destination limits (whichever is the smaller).
    - Added ability to send previously saved messages, available from Queues and Topics menu.
    - Added right click menu on tree view with option for connecting/disconnecting all servers in folder.
    - Client side trace can now be enabled on a client connection from the Server menu.
    - Now prompts to save config changes on close.
    - Server Info panel now highlights if EMS server has config changes that require restart.
    - Stores can now be sorted e.g. by file size etc.
    - JSON Editor validation now checks for transport bridge duplicates.
    - Copying browsed queue messages or all queue messages now preserve message expiration.
    - Added MaxMonitorEvents property in gems.props:
        - Limits the number of message events for Destination monitor and browser dialogs.

    Note: EMS 8.4 no longer ships with tibcrypt.jar; any previously saved GEMS servers.xml file with encrypted passwords will not be decrypted with EMS 8.4 client.
    To migrate GEMS encrypted passwords first run GEMS 5.1 with EMS 8.3 client and resave the GEMS config to servers.xml, then upgrade to EMS 8.4 client, restart GEMS with the new servers.xml and passwords will be decrypted correctly.
     

    Software: GEMS v5.1 Zip
    Review (1)
    5
    tvillars_gmail 6:17am 09/01/2016

    Been using GEMS since 3.x and it is definitely my go to tool for monitoring and administrating EMS.  I also recommended it for the non-technical (aka testers and managers) as it can be configured for viewonly mode so they can't mess anything up but still see all the pending message counts, receiver counts, route status, etc.

    The tool has been continuously enhanced and they are responsive to fixing obvious problems such as a sorting issue on user names in queue permissions that I personally reported and was promptly fixed.

     

     

    Graphical Administration Tool for TIBCO® EMS (GEMS)

    Introduction

    Gems is a graphical user interface utility for TIBCO® Enterprise Message Service (EMS). It can be used by JMS developers as a general purpose testing tool and by administrative support staff as a management and monitoring tool.

    Gems provides the following main features:

    • Server Monitoring. Server state and main statistics are automticaly updated, warning and error limits may be configured. Server generated events are also captured.
    • Server Management. Including, general server configuration, JMS destinations, JNDI factories, users/groups, permissions, bridges, routes etc.
    • JMS support. Messages may be sent/received, queues may be browsed and message contents inspected. Selectors and filters may be specified.
    • JMS Message Monitoring. Messages may be monitored (snooped) as they pass through the server. Request and reply messages can be correlated to provide service response times.
    • JMS Message Management. Eg; purging messages, copy messages from a queue to another queue on a different server.
    • Charting. Server statistics may be charted in real time, data may be saved to CSV files for export to other tools such as Excel.
    • Logging. Server statistics may be logged automatically when warning or error limits are breached.
    • Security. SSL connectivity, view only mode.
    • Customisable display and look and feel.
    • Support for Managing and Monitoring TIBCO SubStation.
    • Support for Monitoring TIBCO EMS Appliance.
    • Support for Migrating to TIBCO EMS Appliance.

     

    What's New

    As of August 2017 version 5.1 is available.  Version 5.1 includes:
    -----------
    - Added support for new EMS 8.4 server properties:
        - get/setLargeDestCount
        - get/setLargeDestSize
        - getAdminConnectionCount
        - getClientConnectionCount
        - isAlwaysExitOnDiskErrorEnabled
        - isSSLRequireRouteCertOnly
    - Destination PendingMsgCount/Size fields are highlighted in red if they reach MaxMsgs/Bytes or Server’s large destination limits (whichever is the smaller).
    - Added ability to send previously saved messages, available from Queues and Topics menu.
    - Added right click menu on tree view with option for connecting/disconnecting all servers in folder.
    - Client side trace can now be enabled on a client connection from the Server menu.
    - Now prompts to save config changes on close.
    - Server Info panel now highlights if EMS server has config changes that require restart.
    - Stores can now be sorted e.g. by file size etc.
    - JSON Editor validation now checks for transport bridge duplicates.
    - Copying browsed queue messages or all queue messages now preserve message expiration.
    - Added MaxMonitorEvents property in gems.props:
        - Limits the number of message events for Destination monitor and browser dialogs.

    Note: EMS 8.4 no longer ships with tibcrypt.jar; any previously saved GEMS servers.xml file with encrypted passwords will not be decrypted with EMS 8.4 client.
    To migrate GEMS encrypted passwords first run GEMS 5.1 with EMS 8.3 client and resave the GEMS config to servers.xml, then upgrade to EMS 8.4 client, restart GEMS with the new servers.xml and passwords will be decrypted correctly.

    Requirements

    Gems is written in Java and compiled using jdk1.6. Thus a Java run-time environment is needed and this should be at least version 1.6 or greater. To use the example executable rungems.cmd the Java JRE bin directory must be in the system path.

    Gems supports TIBCO EMS version 5.0 or later. In order to run Gems the TIBCO EMS client jar files must be installed and  included on the CLASSPATH.

    Note: To use Gems with TIBCO EMS version 8.0 client or later requires JRE 1.7

    To use the charting features the JFreeChart libraries jcommon-1.0.23.jar and jfreechart-1.0.19.jar must be downloaded from http://www.jfree.org/jfreechart

     

    Installation

    The Gems installation is distributed as a standard ZIP file, that can be downloaded from;

    https://community.tibco.com/modules/graphical-administration-tool-tibcor-ems

    Installation of Gems is a simple a matter of unzipping Gems<version>.zip file to a local directory. This ZIP file includes all classes required to run Gems, except for the EMS client and JFreeChart JAR files.

    Copy JFreeChart libraries jcommon-1.0.23.jar and jfreechart-1.0.19.jar to the Gems lib folder.

    An example executable rungems.cmd is provided for running Gems. If necessary edit the CMD file to set the correct path to the EMS installation directory.

     

    Running Gems

    Run Gems by launching rungems.cmd

    If your TIBCO home directory is not \tibco then you will need to edit rungems.cmd appropriately. For example if your TIBCO home directory is C:\tibhome then set the TIBEMS_ROOT variable to the EMS install directory under the TIBCO home directory:

    set TIBEMS_ROOT=C:\tibhome\ems\8.1

    To run, Gems requires the following:

    The TIBCO EMS client jar files

    Java JRE 1.7.0 or higher

    Ensure the java executable is available in your path, or edit the rungems.cmd file and set the path appropriately.

    More information is contained in the html documentation provided once installation is complete.

     

    Support

    THIS TOOL IS NOT AN OFFICIAL PRODUCT OF TIBCO.
    TIBCO IS NOT RESPONSIBLE FOR ANY LOSS OR ISSUE RESULTING FROM THE USE OF THIS TOOL.

    Only the author may provide non-immediate or non-complete support.

    Please, send any requests, comments, suggestions, issues to the author:

    Richard Lawrence (rlawrenc@tibco.com)

    View the Wiki Page