Install the JMS Interface
This topic provides a high-level overview on how to add JMS support to the gateway. It assumes that the target middleware system has been correctly installed and configured and that you are familiar with the JMS specifications.
This topic provides a high-level overview on how to add JMS support to the
Layer7 API Gateway. It assumes that the target middleware system has been correctly installed and configured and that you are familiar with the JMS specifications.
The Gateway can work with various message-oriented middleware (MOM) systems, including:
- TIBCO EMS
- IBM MQ
- MQ Native
- JMS over MQ
- webMethods Broker
- WebLogic JMS
- WebSphere JMS
For the supported versions, see "Message Queuing Products" in Requirements and Compatibility.
The MOM systems are accessed through the JMS interface. To enable JMS destinations on the Gateway, you must install the appropriate client libraries first.
Contact your middleware system provider for the client libraries. Due to licensing issues, these libraries are not included with the
Layer7 API Gateway.
Required Client Libraries
For IBM MQ v7.1.x, the following libraries are required:
JMS using MQ
If a .bindings file is being used to configure a JMS destination, ensure these files are also included:
providerutil.jar. These files may be obtained from the IBM MQ client.
For IBM MQ 8.0, the following libraries are required:
Technical Note:When configuring for IBM MQ 8.0, if any "TLS_ECDHE_ECDSA" cipher suite is used, the IBM MQ 8 server certificate must be encrypted using the ECDSA algorithm. If using the IBM Key Management to generate a certificate, use the SHA512withECDSA algorithm to generate the certificate.
For TIBCO EMS, the following libraries are required:
To use an SSL connection with the EMS server, ensure these libraries are in the CLASSPATH:
These JAR files are included with the TIBCO Enterprise Message Service installation.
Installing the Client Libraries
To install the client libraries:
- Access the Gateway main menu.
- Copy the appropriate client libraries using SCP to the following directory:/home/ssgconfig
- Move the client libraries:from:/home/ssgconfigto:/opt/SecureSpan/Gateway/runtime/lib/extAnd then change the permissions and owner:# chmod 644 /opt/SecureSpan/Gateway/runtime/lib/ext/*.jar# chown layer7.layer7 /opt/SecureSpan/Gateway/runtime/lib/ext/*.jar
- (Perform this step only for IBM MQ 8.0 with an SSL connection)Update thesystem.propertiesfile:
- Open this file in a text editor:/opt/SecureSpan/Gateway/node/default/etc/conf/system.properties
- Add these lines to the properties file:com.ibm.mq.cfg.useIBMCipherMappings=falsecom.ibm.mq.cfg.preferTLS=true
- Save and exit the file.
- Restart the Gateway:# service ssg restart
Configuring the JMS Destinations
The JMS interface is enabled when the Gateway is restarted. You can now: