Installing Starlight for JMS
Wire protocol changes introduced in Pulsar 2.9 can cause compatibility issues when using Transactions.
To avoid issues, DataStax recommends using:
Pulsar JMS 1.x if your server is Pulsar 2.8.x or Luna Streaming 2.8.x
Pulsar JMS 2.x if your server is Pulsar 2.9.x, 2.10.x or Luna Streaming 2.10.x (or above)
Install Starlight for JMS by adding the following dependency to your Java Maven project
pom.xml. Remember to choose the most recent version.
<dependency> <artifactId>pulsar-jms</artifactId> <groupId>com.datastax.oss</groupId> <version>XXXX</version> </dependency>
That file contains only Starlight for JMS code and transitively imports the Apache Pulsar™ client and the Jakarta JMS 2.0 specifications JAR.
You can also use a "fat" JAR that includes all dependencies:
<dependency> <artifactId>pulsar-jms-all</artifactId> <groupId>com.datastax.oss</groupId> <version>XXXX</version> </dependency>
Starlight for JMS standalone quick start: Create a simple command line Java JMS client that connects to a local Pulsar installation.
Getting started with Starlight for JMS: Create a simple command line Java JMS client that connects to an Astra Streaming instance.
Mapping Pulsar concepts to JMS specifications: Understand Pulsar concepts in the context of JMS.
Starlight for JMS implementation details: Understand key implementation details for Starlight for JMS.
Starlight for JMS FAQs: Frequently asked questions about Starlight for JMS.
Starlight for JMS configuration reference: Starlight for JMS configuration reference.