Configure an instance to use JMS

Use this procedure to prepare your system to use Java Messaging Service (JMS) with a custom Orchestration JMS activity.

Before you begin

Role required: admin

About this task

Ensure that the MID Server has the correct JMS connection factories for your organization. Configure those values in the mid.property.jms.command.allowed_factory_names property, found in MID Server > Properties. The default values for this property can be changed to any value or comma separated list of values that the 3rd party JMS provider advertises.

Procedure

  1. Navigate to MID Server > JAR Files.
  2. Click New.
  3. Upload the JMS driver jar file, using the procedures in Synchronize a JAR file to MID Servers.
    The JMS driver jar file should be available as part of JMS Provider installation. Few JMS vendors make them available as a separate product. Refer to the JMS Provider documentation to determine which JMS client driver jar files are required by the client applications to connect to the JMS Provider. For example, If you are trying to connect to ActiveMQ V5.10, (JMS Provider), you need the activemq-all-5.10.1.jar file.
  4. Navigate to Orchestration > Definition > JMS Connection Factory.
  5. Click New.
  6. Complete the form using the fields from the table.
    Table 1. JMS connection factory
    Field Description
    Name Unique name of this connection factory.
    Initial Context Factory Name of the JNDI class that is used to create the InitialContext. Using this Initial Context Factory, various JMS objects, such as JMS Connection, are created. For example, to connect to ActiveMQ V5.10, (JMS Provider), the value in this field would be org.apache.activemq.jndi.ActiveMQInitialContextFactory
    Provider URL Location of the running JMS Provider installation. The information in this URL tells JNDI how to find and access the JMS Provider. An example value for connecting to ActiveMQ V5.1, is tcp://ipAddressOrHostName:61616
  7. Click Submit.
  8. Navigate to Orchestration > Credentials.
  9. Click New.
  10. In the list of credential types, select JMS Credentials.
  11. Provide the user name and password the MID should use to communicate with the JMS provider.
    For more information, see JMS credentials.
  12. Click Submit.
    You are now ready to create a custom JMS activity.