Setting EMS_HOME

For Service Performance Manager, you must set the EMS_HOME and create EMS queues and factories. Based on the location of the EMS server and the SPM server, you must manually set the EMS_HOME.

These steps depend on:

  • The installation order of TIBCO Enterprise Message Service and TIBCO Service Performance Manager
  • Whether they share the same TIBCO_HOME or use a different TIBCO_HOME
  • Whether they are installed on the same machine or on different machines
The following table covers the scenarios and corresponding steps.
Setup Details Installation Order Steps
Single machine with the same TIBCO_HOME
  1. TIBCO Enterprise Message Service
  2. TIBCO Service Performance Manager
No manual steps needed
Single machine with the same TIBCO_HOME

Single machine with different TIBCO_HOME

  1. TIBCO Service Performance Manager
  2. TIBCO Enterprise Message Service

Any order

Set EMS_HOME to the TIBCO Enterprise Message Service installation directory in the following files.

For the SPM server:

  • TIBCO_HOME/spm/2.3/bin/setems4spm.bat
  • TIBCO_HOME/spm/2.3/bin/tibspm.tra
  • TIBCO_HOME/spm/2.3/bin/tibspmddlgenerator.tra
  • TIBCO_HOME/spm/2.3/bin/tibspmexamples.tra
  • TIBCO_HOME/spm/2.3/bin/tibspmpassword.tra
For the SPM dashboard:
  • TIBCO_HOME/amxdashboard/3.4/amxdashboard/startspmdashboard.bat
  • TIBCO_HOME/amxdashboard/3.4/amxdashboard/tomcat/bin/setenv.bat
  • TIBCO_HOME/amxdashboard/3.4/amxdashboard/tomcat/bin/service.bat
  • TIBCO_HOME/amxdashboard/3.4/setup/install.properties
Different machines where TIBCO Enterprise Message Service is installed on machine 1 and TIBCO Service Performance Manager on machine 2  
  • Perform the following steps:
    1. Copy the following files from TIBCO_HOME/spm/2.3/bin of machine 2 to EMS_HOME/lib of machine 1: setems4spm.bat and setems4spm.scr
    2. Execute setems4spm.bat.
  • Ensure that the folder structure for EMS client libraries on local machine points to EMS_HOME/lib.
  • Copy the folder structure EMS_HOME/lib from machine 1 to machine 2 and place it at the same level as TIBCO_HOME/spm/2.3.
  • Verify the following files are present under EMS_HOME/lib on machine 2: jms.jar, tibjms.jar, slf4j*.jar, tibcrypt.jar
    Note: You must replace jms.jar with jms-2.0.jar if you plan to use EMS v8.0+.
  • Update all TRA and bat files to set EMS_HOME = TIBCO_HOME/spm/2.3
  • Set the EMS_HOME in the following files.

    For the SPM server:

    • TIBCO_HOME/spm/2.3/bin/setems4spm.bat
    • TIBCO_HOME/spm/2.3/bin/tibspm.tra
    • TIBCO_HOME/spm/2.3/bin/tibspmddlgenerator.tra
    • TIBCO_HOME/spm/2.3/bin/tibspmexamples.tra
    • TIBCO_HOME/spm/2.3/bin/tibspmpassword.tra
    For the SPM dashboard:
    • TIBCO_HOME/amxdashboard/3.4/amxdashboard/startspmdashboard.bat
    • TIBCO_HOME/amxdashboard/3.4/amxdashboard/tomcat/bin/setenv.bat
    • TIBCO_HOME/amxdashboard/3.4/amxdashboard/tomcat/bin/service.bat
    • TIBCO_HOME/amxdashboard/3.4/setup/install.properties