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.0

    Published: July 2016

    Version 5.0
    -----------
    - Added Todays and Historical Charts to view stats from Server Info CSV log files.
    - Added ability to copy a queue's messages to another destination (or server), select "Copy All Messages.." from Queues menu.
    - Server Info logging is now enabled by default
    - Added icons to tree view
    - Added Queue and Topic store filter on Connection tab or servers.xml
    - Added ability to filter displayed queues, topics for a specified store:
        - A queueStoreFilter/topicStoreFilter can be set (in servers.xml or on Connection tab) only destinations that are assigned to the store are displayed.
    - Queues display now sorts by PendingMsgCount by default
    - Queues and Topics sub-trees now hidden (can be overriden using HideTreeDests property in gems.props)
    - Message import now copies JMSType and JMSCorrelationID
    - Server totals are now shown by default in the Server Monitor display.
    - Server Warning and Error limits are now enabled by default.
    - Added "New Listen Port" option to Create menu in JSON Config Editor.

    Previous version notes available in the README

    Software: GEMS v5.0 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.

     

    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.

    View the Wiki Page