How do I configure the E4JMS plugin for Tibco EMS setup

The E4JMS plug-ins are designed to monitor the JMS implementation by TIBCO. It is not suitable for monitoring the JMS implementations from other vendors.

These plug-ins requires Java JRE installed on the host that runs the NetProbe. 

1. Create the E4JMS samplers if they don't exist yet. Copy the XML from the link below. The samplers are for both stand-alone Tibco server and Tibco server with Primary/backup.

                E4JMS-Sampler.xml

2. Create Type that will hold the samplers

 3. Create the following variable with their value. If the login doesn't require a password, put a value "none" for emspasswd

•  For primary server:

• For backup server, create variables 'emshost2', 'emsport2'. Access credential for Backup server is usually the same with the primary.

4. If the manage entity appears grey in AC and has no view, the netprobe startup script should be corrected to path to the correct JRE and libraries. The needed Tibco libraries should also be uploaded to the netprobe installation directory where you can find the file 'geneos-plugins.jar'. Below are the needed Tibco libraries:

• jms.jar
• tibjms.jar
• tibjmsadmin.jar

5. Once you uploaded the needed Tibco libraries, check if there is JRE installed in the netprobe server and get the path. It's easier to install the standard Java JRE since the JRE installed in most servers is not complete. 

NOTE: if the netprobe is running 64-bit, JRE should also be in 64-bit vice versa. The netprobe needs to create a Java virtual machine within which to load and run the e4jms plug-in. To do this it needs to be able to locate the prerequisite libraries: libjvm.so/jvm.dll which can be found in the Java Runtime installation directory.

6. Edit the start_netprobe script as follows. The red part are those to be customised to your installation.

# Any of these options may also be overwritten in the local configuration
#
netprobe_home=/opt/itrs/netprobe
emsjars=${netprobe_home}/prod              # path to where geneos-plugin.jar and other Tibco libraries were located.
jrehome=/opt/myuser/java64/jre1.7.0_65    # the jre installation directory
geneos=${netprobe_home}/prod              # netprobe binaries

# Set up the path for the netprobe
#

JAVA_HOME=$jrehome                          # need to be added if not in the script
export JAVA_HOME

PATH=${netprobe_home}/prod:${netprobe_home}/scripts:${jrehome}/bin:/sbin:/usr/bin:/bin:/usr/ucb:/usr/local/bin:$PATH
export PATH

# Add '${jrehome}/lib/amd64/server' for 64-bit. '${jrehome}/lib/i386/client' for 32-bit or to where libjvm.so/jvm.dll is located

LD_LIBRARY_PATH=${netprobe_home}/prod:${jrehome}/lib/i386/client:${jrehome}/lib/amd64/server:/usr/lib:$LD_LIBRARY_PATH
export LD_LIBRARY_PATH

GENEOS_JARS=$geneos
export GENEOS_JARS
GENEOS_LIBS=$geneos
export GENEOS_LIBS

 

7. Once all are set, you need to restart the netprobe manually.

Additional useful information:

• Check EMS server config. Login to ems server. Execute ps command to view ems process details including config. Use ps -ef (or ps -e -o args for RMS shortened output). View config file (filename usually tibemsd.conf).
• Check port used. Go to the following line:
  listen                  = tcp://9084
• Check ems users config file. Go following line.
  users                   = e.g /ems/6.1/conf/shared/users.conf

• View users.conf file. At the bottom part of the file, you will see this part:
  # for Monitoring

• <ems user>:<ems pass>:description

Please refer to the Geneos Compatibility Matrix for supported Tibco EMS and Java JRE versions.