This guide assumes that:
This tutorial requires access to Solace PubSub+ event broker and requires that you know several connectivity properties about your event broker. Specifically you need to know the following:
This is the address clients use when connecting to the event broker to send and receive messages. (Format:
The event broker Message VPN that this client should connect to.
The client username. (See Notes below)
The client password. (See Notes below)
There are several ways you can get access to Solace messaging and find these required properties.
-DSolace_JMS_Browser_Timeout_In_MS=1000to the Java command.
Step 1. Open the Applications directory in Finder. Right-click on the HermesJMS icon and select "Show Package Contents".
Step 2. Go into the Contents subdirectory.
Step 3. Double-click to edit the Info.plist file with the (optionally installed) Apple Xcode editor. Add the string
-DSolace_JMS_Browser_Timeout_In_MS=1000 to the Java->VMOptions with a space between the existing options and the new String. Save the change.
Step 1. Right-click on jms/sessions tree node in the "Sessions" area and select New.../New session... Call it "SolaceSession". Make sure to uncheck
Use Consumer and Transacted.
Step 2. You will be presented with a Preferences dialog which contains 4 tabs. Select the Providers tab.
Step 3. Add a new Classpath group, by right clicking on "Classpath Groups" and selecting Add Group from the popup menu. Type "SolaceJMS" in the Classpath group name text field and hit OK.
Step 4. Now, add all of the jars in the lib directory of the Solace JMS distribution package, and hit "OK". A confirmation dialog will be presented (see below). Hit "Don't scan" to proceed.
Step 5. Hit "Apply" to save the configuration.
Step 6. Switch to the Sessions tab to start configuring the ConnectionFactory.
Step 7. Select the following settings in the drop-down menu for the Connection Factory.
Step 8. Add the following properties for the Connection Factory:
JNDI name of the connection factory you want to use
Step 9. Hit "OK" to finish creating the new Hermes JMS session.
a) Right-click on jms/sessions/SolaceSession tree node in the "Sessions" area and select New.../Add queue...
b) Input the following properties:
JNDI name of the queue that you wish to connect to
Any desired display name. For simplicity, this example will keep it as the same as the JNDI name.
c) Hit "OK" to finish creating the new Hermes JMS queue.
a) To browse the message in the queue added in the previous setup, simply double click on it in the tree on the left hand side. If the queue contains messages they will be displayed in a queue tab as shown below
a) Using your preferred text editor, create a new file to pass additional user properties to HermesJMS. For this example, the name of the properties file will be "solace.jms.properties".
b) Insert the following two lines of text into your file. Note that the text should be modified to point to the location of your trust store, and must also contain the password of your trust store.
c) Edit the Hermes JMS session in Start HemesJMS to have the session connect securely over SSL. Right-click on jms/sessions/SolaceSession tree node in the "Sessions" area and select Edit...
d) Edit the providerURL property to connect to
e) Add "userPropertiesFile" property to the connection factory. This value of this property must be the full file name of the solace.jms.properties file that was created earlier in step (a).
a) "Configure Hermes JMS session to connect securely over SSL" must be done prior to enabling client certificate authentication.
b) Edit the solace.jms.properties custom user property file to specify additional properties, modifying them to point to your actual files, and passwords as necessary.
Solace_JMS_SSL_TrustStore=C:\\JMS\\HermesJMS\\truststore.jks Solace_JMS_SSL_TrustStorePassword=myTrustStorePassword Solace_JMS_Authentication_Scheme=AUTHENTICATION_SCHEME_CLIENT_CERTIFICATE Solace_JMS_SSL_KeyStore=C:\\JMS\\HermesJMS\\keystore.jks Solace_JMS_SSL_KeyStorePassword=myKeyStorePassword Solace_JMS_SSL_PrivateKeyAlias=myPrivateKeyAlias Solace_JMS_SSL_PrivateKeyPassword=myPrivateKeyPassword
Here is a brief summary of the properties used, but you should refer to the Solace JMS API guide for full details.
The trust store to use.
The trust store password for the trust store provided for the SSL Trust Store property.
This property specifies the authentication scheme to be used.
This property specifies the keystore to use in the URL or path format. The keystore holds the client's private key and certificate required to authenticate a client during the TLS/SSL handshake.
This property specifies keystore password to use. This password allows JMS to verify the integrity of the keystore.
This property specifies which private key in the keystore to use for authentication. This property is necessary when a keystore with multiple private key entries is used.
This property specifies the password for the private key in the keystore.