Supported Vendors and Configurations for JMS 1.1

To use third party JMS software in Sterling B2B Integrator, you must configure each vendor's software.

When using third party JMS software in Sterling B2B Integrator, use the following table to configure each vendor's software. The configuration of third party JMS software also involves the following:
  • You need to download and install the correct software jars for each vendor. For more information, see the Installing JMS Jar Files procedure later in this topic.
  • You can view JMS pools created in Sterling B2B Integrator using the JConsole tool. For more information, see the Running JConsole procedure later in this topic.
    Important: Running JConsole is not mandatory for any JMS vendor.
JMS Vendor (Supported Versions) JNDI NON-JNDI SSL JDK Supported for SSL

ActiveMQ

 Yes Yes Yes IBM, Oracle

WebLogic (9.2, 10.1)

 Yes No Yes Oracle

TIBCO EMS (4.4.1, 5.1.4)

 Yes Yes Yes Oracle

JBOSS

 Yes No No IBM, Oracle

SonicMQ

Yes Yes No IBM, Oracle

WebSphereMQ (v6.0 or later)

 Yes No Yes IBM, Oracle

Installing JMS Jar Files

Do the following to install a JMS jar file:
  1. From the computer where the JMS server is installed, copy the jar file to a directory on your local server.
    For example:
    • The jar file for WebSphere MQ is com.ibm.mq.jar.
    • For ActiveMQ, copy jar files from <ActiveMQ Install Directory>/lib and <ActiveMQ Install Directory>/lib/optional folder to your local computer directory. Remove the slf4j-apiand jcl-over-slf4j and log4j jar files.
  2. From the directory on your local server, copy the jar file to a directory on the host computer where Sterling B2B Integrator is installed.
  3. Stop Sterling B2B Integrator.
  4. From the bin directory of the Sterling B2B Integrator installation directory, run one of the following commands. Use the JMS server version number and path to the host computer directory where you copied the jar file.
    • (UNIX or Linux) install3rdParty.sh ibm 5_3 - j directory/JMS jar file (JMS server as WebSphere MQ)
    • (UNIX or Linux) install3rdParty.sh activemq 5_15 - j directory/JMS jar file (JMS server as ActiveMQ)
    • (Windows) install3rdParty.cmd ibm 5_3 - j directory/JMS jar file (JMS server as WebSphere MQ)
    • (Windows) install3rdParty.cmd activemq 5_15 - j directory/JMS jar file (JMS server as ActiveMQ)
  5. For ActiveMQ, remove the slf4j, log4j and jcl jar files as it conflicts with the Sterling B2B Integrator version of these jar files.
  6. For Active MQ, install the individual module jar files and not the activemq-all jar version.
  7. Restart Sterling B2B Integrator.

Running JConsole

The JConsole tool uses the JMX_PORT property in the sandbox.cfg file to view the pools created in Sterling B2B Integrator. To view pools on cluster nodes, you must configure JMX_PORT for each node where you want to view pool details.

Do the following to run the JConsole tool:
  1. Stop Sterling B2B Integrator.
  2. Open the properties directory of the installation directory of Sterling B2B Integrator.
  3. Open the sandbox.cfg file and add the following line:
    JMX_PORT=Any free port
  4. Save and close the sandbox.cfg file.
  5. Navigate to the bin directory for your JDK file.

    For example, C:\Program Files\Java\jdk1.6.0_14\bin.

  6. Double-click the jconsole.exe file.

    The JConsole screen is displayed.

  7. Click Remote Process.
  8. Enter the following text:

    SI install host:JMX_PORT user name/Password:admin/Password

  9. Click Connect.

    The Java X Console is displayed.