Configuring TIBCO Enterprise Message Service (Optional)

To use the ESB channel or JMS transport for TIBCO API Exchange Gateway, configure the EMS server.

Task A Update TIBCO Enterprise Message Service Libraries

1. Open the ASG_HOME/bin/asg-engine.tra file for editing. Set the tibco.env.EMS_HOME property to the TIBCO Enterprise Message Service installation home.

   For example,

   tibco.env.EMS_HOME=c:/tibco/ems/5.1

2. Copy the jms.jar and tibjms.jar files from TIBCO Enterprise Message Service installation (EMS_HOME/lib) to ASG_HOME/lib/ext/tpcl

Task B Enable the ESB Channels in the CDD file

3. Open the ASG_HOME/bin/asg_core.cdd file for editing in a text editor.
4. Search the following property.

   <property-group comment="" name="Channel">

   <property name="be.channel.deactivate" value="/DefaultImplementation/Channels/SouthboundEsb0Channel,/DefaultImplementation/Channels/SouthboundEsb1Channel,/DefaultImplementation/Channels/SouthboundEsb2Channel,/DefaultImplementation/Channels/North_ESBChannel,/DefaultImplementation/Channels/North_HTTPChannel,/ASG/Channels/SOAPJMSChannel_North,/ASG/Channels/SOAPJMSChannel_South,/ASG/Channels/modAS_Channel,/Common/Channel/PSMChannel,/Common/Channel/CentralLoggerJMS"/>

5. Copy the property be.channel.deactivate to be.channel.deactivate.backup as follows:

   <property name="be.channel.deactivate.backup" value="/DefaultImplementation/Channels/SouthboundEsb0Channel,/DefaultImplementation/Channels/SouthboundEsb1Channel,/DefaultImplementation/Channels/SouthboundEsb2Channel,/DefaultImplementation/Channels/North_ESBChannel,/DefaultImplementation/Channels/North_HTTPChannel,/ASG/Channels/SOAPJMSChannel_North,/ASG/Channels/SOAPJMSChannel_South,/ASG/Channels/modAS_Channel,/Common/Channel/PSMChannel,/Common/Channel/CentralLoggerJMS"/>

6. Enable the ESB channels as follows:
   1. To enable the northbound ESB channel, remove /DefaultImplementation/Channels/North_ESBChannel from the value of the be.channel.deactivate property. The modified value of the property is as follows:

      <property name="be.channel.deactivate" value="/DefaultImplementation/Channels/SouthboundEsb0Channel,/DefaultImplementation/Channels/SouthboundEsb1Channel,/DefaultImplementation/Channels/SouthboundEsb2Channel,/DefaultImplementation/Channels/North_HTTPChannel,/ASG/Channels/SOAPJMSChannel_North,/ASG/Channels/SOAPJMSChannel_South,/ASG/Channels/modAS_Channel,/Common/Channel/PSMChannel,/Common/Channel/CentralLoggerJMS"/>

   2. To enable the southbound ESB channels, remove the /DefaultImplementation/Channels/SouthboundEsb0Channel,/DefaultImplementation/Channels/SouthboundEsb1Channel, ,/DefaultImplementation/Channels/SouthboundEsb2Channel from the value of the be.channel.deactivate property. The modified value of the property is as follows:

      <property name="be.channel.deactivate" value="/DefaultImplementation/Channels/North_ESBChannel,/DefaultImplementation/Channels/North_HTTPChannel,/ASG/Channels/SOAPJMSChannel_North,/ASG/Channels/SOAPJMSChannel_South,/ASG/Channels/modAS_Channel,/Common/Channel/PSMChannel,/Common/Channel/CentralLoggerJMS"/>

7. Save the changes to the file.

Task C Create Users on JMS Server

8. Ask your JMS server administrator to create a regular user (not an administrator). The Core Engine uses this user to connect to the JMS server when the JMS transport is used at the facade and target side. The administrator should grant the following privileges to this user:
   • Send
   • Receive
   • Browse

   This user is specified by the runtime property in the ASG_CONFIG_HOME/asg.properties file. Refer to Engine Runtime Properties in TIBCO API Exchange Gateway User’s Guide.

Task D Create Queues on EMS Server

9. Make sure that TIBCO Enterprise Message Service is running.
10. Create the following queues in the TIBCO EMS server. For example, using tibemsadmintool:

       create queue asg.out.request
       create queue asg.out.request.reply.0.0
       create queue asg.out.request.reply.0.1
       create queue asg.out.request.reply.0.2
       create queue asg.in.request
       create queue asg.in.request.reply.0
       create queue asg.soap.in.request
       create queue asg.soap.in.request.reply.0
       create queue asg.soap.forward
       create queue asg.soap.forward.reply.0

    Note: The default configuration assumes that TIBCO Enterprise Message Service is running on the localhost and port 7222. Depending on the host and port where the EMS server runs, edit the EMS server configuration parameters in the ASG_CONFIG_HOME/asg.properties file.