Managing Solace JNDI Objects

Java Messaging Service (JMS) provides a common way for an enterprise’s Java applications to create, send, receive, and read messages. The Solace Messaging Platform supports the JMS 1.1 standard.

Java messaging applications can use the Solace implementation of the JMS Application Programming Interface (API) connect to a Solace router.

The Solace router can provide JNDI service, which allows JMS clients to perform JNDI lookups and object binding. It also acts as a JMS broker, to access the messaging capabilities of the Solace Messaging Platform. The Solace router acts as the JMS broker for the JMS client. As such, it provides access control, message routing, selecting, and filtering.

The Solace router provides an internal JNDI store for provisioned Connection Factory, Topic, and Queue objects that clients can access through JNDI lookups.

The Solace Guaranteed Messaging feature provides a message spooling mechanism to support the persistent store notion of JMS queues (when using a point-to-point messaging model) and subscription names (when using a publish‑subscribe messaging model).

  • Physical queues can be provisioned on a router through the queue Message Spool VPN CONFIG command (refer to Configuring Queues).
  • Topic endpoints can be provisioned on a router through the topic‑endpoint Message Spool VPN CONFIG command (refer to Configuring Topic Endpoints). These topic endpoints must have the same name as the subscription name that they represent.

Note:  To use Guaranteed Messaging with JMS messaging, a Solace appliance must have an ADB installed with Guaranteed Messaging and message spooling enabled. For configuration information, refer to Managing Guaranteed Messaging.

This section describes:

  • the tasks associated with configuring standard object properties and property lists in the JNDI store on a Solace router
  • the Command Line Interface (CLI) commands used to manage administered objects in the JNDI store on a Solace router

Note:  The Solace Messaging Platform also supports JNDI lookups of administered objects maintained in an LDAP-based JNDI store on a remote host. However, this section only provides information on how to work with the JNDI store on a Solace router.

Solace Messaging API for JMS is JNDI‑compliant and accepts the standard JMS objects Connection Factory, Topic, and Queue.

Standard JMS object properties and property lists can be configured in the JNDI store on the Solace router. Through the JMS API, JNDI provides a standard way of accessing naming and directory services on the Solace router that allows clients to discover and lookup data and objects through a common name.

Starting/Stopping JNDI Access

By default JNDI access is not enabled on Solace appliances, but it is enabled on VMRs.

  • To enable JNDI access for clients, enter the following CONFIG command:

    solace(configure/jndi)# no shutdown

  • To stop JNDI access for clients , enter the following CONFIG command:

    solace(configure/jndi)# shutdown