Skip to content

Commit 316d6ba

Browse files
Remove page aliases
1 parent 4aac3f9 commit 316d6ba

File tree

9 files changed

+15
-28
lines changed

9 files changed

+15
-28
lines changed

modules/ROOT/pages/index.adoc

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,18 @@
11
= About Starlight for JMS
22
:navtitle: Starlight for JMS
33
:page-tag: starlight-jms,planner,dev,admin,pulsar,jms
4-
:page-aliases: docs@starlight-jms::index.adoc,
54

65
Starlight for JMS is the first highly compliant JMS implementation designed to run on a modern streaming platform. It allows enterprises to take advantage of the scalability and resiliency of a modern streaming platform to run their existing JMS applications. Because Apache Pulsar™ is open-source and cloud-native, Starlight for JMS enables enterprises to move their JMS applications to run on-premises and in any cloud environment.
76

87
== Key Features
98

109
Starlight for JMS key features include:
1110

12-
* *Blazing fast JMS performance*: Achieve 1 million JMS messages per second with 99 percentile publish to acknowledge latency of less than 10 ms.
11+
* *Blazing fast JMS performance*: Achieve 1 million JMS messages per second with 99 percentile publish to acknowledge latency of less than 10 ms.
1312
* *Drop-in replacement for existing JMS applications*: Supports JMS/Jakarta 2.0 and is backwards compatible with JMS 1.1. 100% pass rate on JMS compliance test for supported features.
1413
* *Horizontally scalable JMS*: Apache Pulsar is a horizontally scaled distributed streaming platform. You can scale up or down without operational hassles. Pulsar separates compute from storage, which means you can scale those dimensions independently, as required. Pulsar supports offloading old data to object storage for practically infinite storage capacity.
15-
* *Reduced total cost of ownership*: Because Apache Pulsar is natively multi-tenant and high performance, you can consolidate JMS applications spread across multiple legacy JMS brokers onto a single Apache Pulsar installation. And since Pulsar is easily horizontally scaled, you don’t need to overprovision.
16-
* *Future proof*: Apache Pulsar can support traditional messaging workloads, but it can also support modern streaming use cases such as log collection, microservices integration, event streaming, event sourcing. New workloads can run alongside Legacy JMS applications.
14+
* *Reduced total cost of ownership*: Because Apache Pulsar is natively multi-tenant and high performance, you can consolidate JMS applications spread across multiple legacy JMS brokers onto a single Apache Pulsar installation. And since Pulsar is easily horizontally scaled, you don’t need to overprovision.
15+
* *Future proof*: Apache Pulsar can support traditional messaging workloads, but it can also support modern streaming use cases such as log collection, microservices integration, event streaming, event sourcing. New workloads can run alongside Legacy JMS applications.
1716
* *Open source to avoid lock in*: Starlight for JMS and Apache Pulsar are 100% open source. You can run on-premise, in any cloud provider, or in Kubernetes.
1817
* *Adds message replay to JMS*: Apache Pulsar natively supports message retention and replay. This allows applications using Fast JMS for Apache Pulsar to travel back in time and replay previously consumed messages to recover from misconfiguration issues, recover from bugs in application code, and test new applications against real data.
1918

modules/ROOT/pages/pulsar-jms-faq.adoc

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,4 @@
11
= Starlight for JMS FAQs
2-
32
:page-tag: starlight-jms,planner,dev,admin,pulsar,jms
43

54
Answers to the (arguably) most common Starlight for JMS questions.

modules/examples/pages/pulsar-jms-batch-ack.adoc

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,4 @@
11
= Batch index acknowledgement
2-
:page-aliases: docs@starlight-jms::pulsar-jms-batch-ack.adoc
32

43
Starlight for JMS improves acknowledgement of batched messages by supporting the tracking of 'ack' status by *batch index*. +
54

modules/examples/pages/pulsar-jms-implementation.adoc

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,5 @@
11
= Starlight for JMS implementation details
2-
32
:page-tag: starlight-jms,dev,pulsar,jms
4-
:page-aliases: docs@starlight-jms::pulsar-jms-implementation.adoc
53

64
A discussion of design and implementation decisions made to support JMS requirements.
75

modules/examples/pages/pulsar-jms-server-side-filters.adoc

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,4 @@
11
= Enabling server-side filters
2-
:page-aliases: docs@starlight-jms::pulsar-jms-server-side-filters.adoc
32

43
Starlight for JMS offers *server-side filtering*, which executes JMS filtering features on the Pulsar Broker instead of the Client. +
54
Previously, filtering was implemented with `jms.enableClientSideEmulation=true` on the Client side, which meant the Client application received all messages, even if they didn't match the filter. This caused inefficient network, CPU, and memory usage.
@@ -20,7 +19,7 @@ The `.nar` file filter is packaged with Luna Streaming *2.10.03+* and also avail
2019
+
2120
[NOTE]
2221
====
23-
The path for the .nar is relative to your Pulsar directory.
22+
The path for the .nar is relative to your Pulsar directory.
2423
====
2524
For more, see xref:jms-migration:pulsar-jms-quickstart-sa.adoc[Standalone quick start].
2625

@@ -61,7 +60,7 @@ In this case, the server-side filter applies both to JMS queues and JMS topics.
6160

6261
[NOTE]
6362
====
64-
If you set `jms.selector` on the subscription **and** set a message selector on the JMS client, the conditions on the subscription **and** the JMS client will both be fulfilled.
63+
If you set `jms.selector` on the subscription **and** set a message selector on the JMS client, the conditions on the subscription **and** the JMS client will both be fulfilled.
6564
====
6665

6766
== Limitations

modules/jms-migration/pages/pulsar-jms-install.adoc

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,6 @@
11
= Installing Starlight for JMS
2-
32
:page-tag: starlight-jms,install,dev,admin,pulsar,jms,java,maven
4-
:page-aliases: docs@starlight-jms::pulsar-jms-install.adoc
3+
54
== Compatibility
65

76
Wire protocol changes introduced in *Pulsar 2.9* can cause compatibility issues when using *Transactions*. +

modules/jms-migration/pages/pulsar-jms-quickstart-sa.adoc

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,5 @@
11
= Starlight for JMS standalone quick start
2-
32
:page-tag: starlight-jms,dev,quickstart,pulsar,java,jms
4-
:page-aliases: docs@starlight-jms::pulsar-jms-quickstart-sa.adoc
53

64
This quick start will get you up and running with a simple command-line Java JMS client that can talk to a local Apache Pulsar™ installation. The client:
75

modules/reference/pages/pulsar-jms-mappings.adoc

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,5 @@
11
= Mapping Pulsar concepts to JMS specifications
2-
32
:page-tag: starlight-jms,planner,dev,admin,pulsar,jms
4-
:page-aliases: docs@starlight-jms::pulsar-jms-mappings.adoc
53

64
JMS specifications are built upon the concepts of *Topics* and *Queues*, but Apache Pulsar™ has only a general concept of *Topics* that can model both of those two domains.
75

@@ -137,7 +135,7 @@ Or modify the Pulsar broker's `broker.conf` file:
137135
allowAutoSubscriptionCreation=false
138136
----
139137

140-
If both `allowAutoSubscriptionCreation` and `jms.precreateQueueSubscription` are set to `false`, automatic subscription creation is completely disabled.
138+
If both `allowAutoSubscriptionCreation` and `jms.precreateQueueSubscription` are set to `false`, automatic subscription creation is completely disabled.
141139

142140
[#consumer-mappings]
143141
== Mappings between JMS consumer modes and Pulsar
@@ -153,7 +151,7 @@ There are five consumer mode session objects in JMS. This section describes how
153151
[#auto-ack]
154152
=== Session.AUTO_ACKNOWLEDGE
155153

156-
This mode maps to the Pulsar `acknowledgeMessage` API.
154+
This mode maps to the Pulsar `acknowledgeMessage` API.
157155

158156
By default, acknowledgements in Pulsar are asynchronous and best effort, enabling duplicates to always be displayed on the Consumer.
159157

@@ -195,7 +193,7 @@ public class JMSExample {
195193
public void onMessage(Message message) {
196194
try {
197195
System.out.println("received " + message.getBody(String.class));
198-
196+
199197
} catch (Exception err) {
200198
err.printStackTrace();
201199
}
@@ -223,7 +221,7 @@ public class JMSExample {
223221
[#dups-ok]
224222
=== Session.DUPS_OK_ACKNOWLEDGE
225223

226-
This mode maps to `Consumer.acknowledgeAsync()` without waiting for the `CompleteableFuture` returned by the method to complete.
224+
This mode maps to `Consumer.acknowledgeAsync()` without waiting for the `CompleteableFuture` returned by the method to complete.
227225

228226
Starlight for JMS logs an error in case there is something wrong, but the application will continue running and is not aware of the failure.
229227

@@ -265,7 +263,7 @@ public class JMSExample {
265263
public void onMessage(Message message) {
266264
try {
267265
System.out.println("received " + message.getBody(String.class));
268-
266+
269267
} catch (Exception err) {
270268
err.printStackTrace();
271269
}

modules/reference/pages/pulsar-jms-reference.adoc

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,5 @@
11
= Starlight for JMS configuration reference
2-
32
:page-tag: starlight-jms,dev,admin,manage,pulsar,jms
4-
:page-aliases: docs@starlight-jms::pulsar-jms-reference.adoc
53

64
A complete configuration reference for Starlight for JMS.
75

@@ -29,7 +27,7 @@ factory.close();
2927

3028
Configuration information can be passed when a `JMSContext` or `Session` is created with `JMSContext.createContext` or `Session.createSession`.
3129

32-
Create a `PulsarConnectionFactory` with `initialContext` for configuration.
30+
Create a `PulsarConnectionFactory` with `initialContext` for configuration.
3331

3432
[source,language-java]
3533
----
@@ -68,18 +66,18 @@ Other entries are ignored.
6866
[width="100%",cols="3,1,1,2,4"]
6967

7068
|===
71-
| Configuration Entry | Required | Type | Default value | Notes
69+
| Configuration Entry | Required | Type | Default value | Notes
7270

7371
| `ackTimeout`
7472
| no
7573
| long
7674
| Disabled
77-
| Set timeout for unacked messages. Must be >1 second.
75+
| Set timeout for unacked messages. Must be >1 second.
7876

7977
| `ackTimeoutMillis`
8078
| no
8179
| long
82-
|
80+
|
8381
| Same as `ackTimeout`, but expressed in milliseconds
8482

8583
| `brokerServiceUrl`

0 commit comments

Comments
 (0)