This is an automated email from the ASF dual-hosted git repository.
robbie pushed a commit to branch development
in repository https://gitbox.apache.org/repos/asf/activemq-artemis-examples.git
The following commit(s) were added to refs/heads/development by this push:
new db7be91 clarify various readmes, e.g add note about preparing the
distribution at root in case people skip to the subdir
db7be91 is described below
commit db7be91a3b189b35fa31f4d124ef7379090d6f50
Author: Robbie Gemmell <[email protected]>
AuthorDate: Mon Jun 17 17:56:08 2024 +0100
clarify various readmes, e.g add note about preparing the distribution at
root in case people skip to the subdir
---
.../amqp-federation-multicast-fanout/readme.md | 2 ++
.../amqp-federation-multicast-hub-spoke/readme.md | 2 ++
.../amqp-federation-multicast-ring/readme.md | 2 ++
.../amqp-federation-over-ssl/readme.md | 2 ++
.../amqp-federation-queue-dual-federation/readme.md | 2 ++
.../amqp-federation-queue-multiple-brokers/readme.md | 2 ++
.../amqp-federation-queue-priority/readme.md | 2 ++
.../broker-connection/amqp-federation/readme.md | 2 ++
.../amqp-receiving-messages/readme.md | 2 ++
.../amqp-sending-messages-multicast/readme.md | 2 ++
.../broker-connection/amqp-sending-messages/readme.md | 2 ++
.../broker-connection/amqp-sending-overssl/readme.md | 2 ++
.../broker-connection/disaster-recovery/readme.md | 2 ++
.../clustered/client-side-load-balancing/readme.md | 2 ++
.../clustered/clustered-durable-subscription/readme.md | 2 ++
.../features/clustered/clustered-grouping/readme.md | 2 ++
.../features/clustered/clustered-jgroups/readme.md | 2 ++
examples/features/clustered/clustered-queue/readme.md | 2 ++
.../clustered/clustered-static-discovery-uri/readme.md | 2 ++
.../clustered/clustered-static-discovery/readme.md | 2 ++
.../clustered/clustered-static-oneway/readme.md | 2 ++
.../features/clustered/clustered-topic-uri/readme.md | 2 ++
examples/features/clustered/clustered-topic/readme.md | 2 ++
.../clustered/queue-message-redistribution/readme.md | 2 ++
.../features/clustered/symmetric-cluster/readme.md | 2 ++
.../connection-router/evenly-redirect/readme.md | 3 ++-
.../connection-router/symmetric-redirect/readme.md | 2 ++
.../connection-router/symmetric-simple/readme.md | 2 ++
.../federation/federated-address-divert/readme.md | 2 ++
.../federated-address-downstream-upstream/readme.md | 2 ++
.../federation/federated-address-downstream/readme.md | 2 ++
.../features/federation/federated-address/readme.md | 2 ++
.../federated-queue-downstream-upstream/readme.md | 2 ++
.../federation/federated-queue-downstream/readme.md | 2 ++
examples/features/federation/federated-queue/readme.md | 2 ++
.../features/ha/application-layer-failover/readme.md | 2 ++
.../features/ha/client-side-failoverlistener/readme.md | 2 ++
.../ha/colocated-failover-scale-down/readme.md | 2 ++
examples/features/ha/colocated-failover/readme.md | 2 ++
.../features/ha/non-transaction-failover/readme.md | 2 ++
.../features/ha/replicated-failback-static/readme.md | 2 ++
examples/features/ha/replicated-failback/readme.md | 2 ++
.../features/ha/replicated-multiple-failover/readme.md | 2 ++
.../ha/zookeeper-single-pair-failback/readme.md | 2 ++
examples/features/perf/soak/readme.md | 2 ++
examples/features/standard/auto-closeable/readme.md | 2 ++
.../features/standard/broker-msg-auth-plugin/readme.md | 2 ++
examples/features/standard/broker-plugin/readme.md | 2 ++
examples/features/standard/browser/readme.md | 2 ++
examples/features/standard/camel/readme.md | 2 ++
examples/features/standard/cdi/readme.md | 4 ++++
examples/features/standard/client-kickoff/readme.md | 2 ++
.../features/standard/completion-listener/readme.md | 2 ++
.../features/standard/consumer-rate-limit/readme.md | 2 ++
examples/features/standard/context/readme.md | 2 ++
examples/features/standard/core-bridge/readme.md | 2 ++
examples/features/standard/database/readme.md | 2 ++
examples/features/standard/dead-letter/readme.md | 2 ++
.../features/standard/delayed-redelivery/readme.md | 2 ++
examples/features/standard/divert/readme.md | 2 ++
.../features/standard/durable-subscription/readme.md | 2 ++
examples/features/standard/embedded-simple/readme.md | 2 ++
examples/features/standard/embedded/readme.md | 2 ++
examples/features/standard/exclusive-queue/readme.md | 2 ++
examples/features/standard/expiry/readme.md | 2 ++
examples/features/standard/http-transport/readme.md | 2 ++
examples/features/standard/interceptor-amqp/readme.md | 2 ++
.../features/standard/interceptor-client/readme.md | 2 ++
examples/features/standard/interceptor-mqtt/readme.md | 2 ++
examples/features/standard/interceptor/readme.md | 2 ++
examples/features/standard/jms-bridge/readme.md | 2 ++
examples/features/standard/jmx-ssl/readme.md | 2 ++
examples/features/standard/jmx/readme.md | 2 ++
examples/features/standard/large-message/readme.md | 2 ++
examples/features/standard/last-value-queue/readme.md | 2 ++
.../standard/management-notifications/readme.md | 2 ++
examples/features/standard/management/readme.md | 4 ++++
examples/features/standard/message-counters/readme.md | 2 ++
examples/features/standard/message-group/readme.md | 2 ++
examples/features/standard/message-group2/readme.md | 2 ++
examples/features/standard/message-priority/readme.md | 2 ++
examples/features/standard/netty-openssl/readme.md | 2 ++
.../features/standard/no-consumer-buffering/readme.md | 2 ++
examples/features/standard/opentelemetry/readme.md | 2 ++
examples/features/standard/paging/readme.md | 2 ++
examples/features/standard/pre-acknowledge/readme.md | 2 ++
.../features/standard/producer-rate-limit/readme.md | 2 ++
examples/features/standard/queue-jakarta/readme.md | 2 ++
examples/features/standard/queue-requestor/readme.md | 2 ++
examples/features/standard/queue-selector/readme.md | 2 ++
examples/features/standard/queue/readme.md | 2 ++
examples/features/standard/reattach-node/readme.md | 2 ++
examples/features/standard/request-reply/readme.md | 2 ++
examples/features/standard/scheduled-message/readme.md | 2 ++
examples/features/standard/security-keycloak/readme.md | 2 ++
examples/features/standard/security-ldap/readme.md | 2 ++
examples/features/standard/security-manager/readme.md | 2 ++
examples/features/standard/security/readme.md | 2 ++
.../features/standard/send-acknowledgements/readme.md | 2 ++
examples/features/standard/shared-consumer/readme.md | 2 ++
examples/features/standard/slow-consumer/readme.md | 2 ++
.../standard/spring-boot-integration/readme.md | 4 ++--
.../features/standard/spring-integration/readme.md | 2 ++
.../features/standard/ssl-enabled-crl-mqtt/readme.md | 2 ++
.../standard/ssl-enabled-dual-authentication/readme.md | 2 ++
examples/features/standard/ssl-enabled/readme.md | 2 ++
examples/features/standard/static-selector/readme.md | 2 ++
examples/features/standard/temp-queue/readme.md | 2 ++
examples/features/standard/topic-hierarchies/readme.md | 2 ++
examples/features/standard/topic-selector1/readme.md | 2 ++
examples/features/standard/topic-selector2/readme.md | 2 ++
examples/features/standard/topic/readme.md | 2 ++
examples/features/standard/transactional/readme.md | 2 ++
examples/features/standard/xa-heuristic/readme.md | 2 ++
examples/features/standard/xa-receive/readme.md | 2 ++
examples/features/standard/xa-send/readme.md | 2 ++
.../inter-broker-bridge/artemis-jms-bridge/readme.md | 6 +++---
examples/protocols/amqp/queue/readme.md | 18 ++++++------------
examples/protocols/amqp/sasl-scram/readme.md | 6 ++++--
examples/protocols/mqtt/clustered-queue-mqtt/readme.md | 2 ++
examples/protocols/mqtt/publish-subscribe/readme.md | 4 ++++
examples/protocols/openwire/chat/readme.md | 2 ++
examples/protocols/openwire/message-listener/readme.md | 2 ++
examples/protocols/openwire/message-recovery/readme.md | 4 ++++
examples/protocols/openwire/queue/readme.md | 2 ++
.../protocols/openwire/virtual-topic-mapping/readme.md | 2 ++
.../stomp/stomp-dual-authentication/readme.md | 2 ++
.../stomp/stomp-embedded-interceptor/readme.md | 2 ++
examples/protocols/stomp/stomp-jms/readme.md | 2 ++
examples/protocols/stomp/stomp-websockets/readme.md | 2 ++
examples/protocols/stomp/stomp/readme.md | 2 ++
examples/protocols/stomp/stomp1.1/readme.md | 2 ++
examples/protocols/stomp/stomp1.2/readme.md | 2 ++
133 files changed, 281 insertions(+), 20 deletions(-)
diff --git
a/examples/features/broker-connection/amqp-federation-multicast-fanout/readme.md
b/examples/features/broker-connection/amqp-federation-multicast-fanout/readme.md
index 789fc8e..f977641 100644
---
a/examples/features/broker-connection/amqp-federation-multicast-fanout/readme.md
+++
b/examples/features/broker-connection/amqp-federation-multicast-fanout/readme.md
@@ -1,5 +1,7 @@
# AMQP Broker Connection demonstrating fanout of multicast messages
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to create and start the broker manually.
This example demonstrates the fanning out of messages sent to a single broker
to a tiered set of federated brokers.
diff --git
a/examples/features/broker-connection/amqp-federation-multicast-hub-spoke/readme.md
b/examples/features/broker-connection/amqp-federation-multicast-hub-spoke/readme.md
index 7f9d23b..64c4346 100644
---
a/examples/features/broker-connection/amqp-federation-multicast-hub-spoke/readme.md
+++
b/examples/features/broker-connection/amqp-federation-multicast-hub-spoke/readme.md
@@ -1,5 +1,7 @@
# AMQP Federation example of multicast hub and spoke configuration
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to create and start the broker manually.
This example demonstrates how you can federate messages over multicast
addresses in a hub and spoke topology.
diff --git
a/examples/features/broker-connection/amqp-federation-multicast-ring/readme.md
b/examples/features/broker-connection/amqp-federation-multicast-ring/readme.md
index df77525..7d4f866 100644
---
a/examples/features/broker-connection/amqp-federation-multicast-ring/readme.md
+++
b/examples/features/broker-connection/amqp-federation-multicast-ring/readme.md
@@ -1,5 +1,7 @@
# AMQP Federation example of a multicast ring configuration
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to create and start the broker manually.
This example demonstrates how you can federate messages over multicast
addresses in a ring topology.
diff --git
a/examples/features/broker-connection/amqp-federation-over-ssl/readme.md
b/examples/features/broker-connection/amqp-federation-over-ssl/readme.md
index c3ec7f7..13d3835 100644
--- a/examples/features/broker-connection/amqp-federation-over-ssl/readme.md
+++ b/examples/features/broker-connection/amqp-federation-over-ssl/readme.md
@@ -1,5 +1,7 @@
# AMQP Broker Connection demonstrating Federation over SSL connections
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to create and start the broker manually.
This example demonstrates how you can federate messages sent to an Address on
a remote server back to the local server and also instruct the remote server to
federate messages sent to a Queue on the local server back to itself over a
single AMQP connection. The connection is made using a connector and acceptor
with SSL configured.
diff --git
a/examples/features/broker-connection/amqp-federation-queue-dual-federation/readme.md
b/examples/features/broker-connection/amqp-federation-queue-dual-federation/readme.md
index 1487848..c725f0a 100644
---
a/examples/features/broker-connection/amqp-federation-queue-dual-federation/readme.md
+++
b/examples/features/broker-connection/amqp-federation-queue-dual-federation/readme.md
@@ -1,5 +1,7 @@
# AMQP Broker Connection example with dual Federation of Queue messages
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to create and start the broker manually.
This example demonstrates the use of dual federation to move messages among
two brokers as a consumer moves.
diff --git
a/examples/features/broker-connection/amqp-federation-queue-multiple-brokers/readme.md
b/examples/features/broker-connection/amqp-federation-queue-multiple-brokers/readme.md
index ef45703..de5976a 100644
---
a/examples/features/broker-connection/amqp-federation-queue-multiple-brokers/readme.md
+++
b/examples/features/broker-connection/amqp-federation-queue-multiple-brokers/readme.md
@@ -1,5 +1,7 @@
# AMQP Broker Connection with Queue federation across three brokers
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to create and start the broker manually.
This example demonstrates the configuration of Queue federation across a set
of three brokers where the message
diff --git
a/examples/features/broker-connection/amqp-federation-queue-priority/readme.md
b/examples/features/broker-connection/amqp-federation-queue-priority/readme.md
index 73530e2..7c0e7c8 100644
---
a/examples/features/broker-connection/amqp-federation-queue-priority/readme.md
+++
b/examples/features/broker-connection/amqp-federation-queue-priority/readme.md
@@ -1,5 +1,7 @@
# AMQP Broker Connection with Queue federation with configured higher priority
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to create and start the broker manually.
This example demonstrates the affect of consumer priority when using Queue
federation, message will be moved to the broker federating messages as it has
been given a higher consumer priority than a consumer on the local broker.
diff --git a/examples/features/broker-connection/amqp-federation/readme.md
b/examples/features/broker-connection/amqp-federation/readme.md
index 47322f3..53ce2d1 100644
--- a/examples/features/broker-connection/amqp-federation/readme.md
+++ b/examples/features/broker-connection/amqp-federation/readme.md
@@ -1,5 +1,7 @@
# AMQP Broker Connection with local and remote Federation
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to create and start the broker manually.
This example demonstrates how you can federate messages sent to an Address on
a remote server back to the local server and also instruct the remote server to
federate messages sent to a Queue on the local server back to itself over a
single AMQP connection.
diff --git
a/examples/features/broker-connection/amqp-receiving-messages/readme.md
b/examples/features/broker-connection/amqp-receiving-messages/readme.md
index 8b08677..296e3bd 100644
--- a/examples/features/broker-connection/amqp-receiving-messages/readme.md
+++ b/examples/features/broker-connection/amqp-receiving-messages/readme.md
@@ -1,5 +1,7 @@
# AMQP Broker Connection with Receivers
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to create and start the broker manually.
This example demonstrates how you can create a broker connection from one
broker towards another broker, and send messages from that broker towards the
target server.
diff --git
a/examples/features/broker-connection/amqp-sending-messages-multicast/readme.md
b/examples/features/broker-connection/amqp-sending-messages-multicast/readme.md
index bd0d781..f5b6595 100644
---
a/examples/features/broker-connection/amqp-sending-messages-multicast/readme.md
+++
b/examples/features/broker-connection/amqp-sending-messages-multicast/readme.md
@@ -1,5 +1,7 @@
# AMQP Broker Connection with Senders on Multicast
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to create and start the broker manually.
This example demonstrates how you can create a broker connection from one
broker towards another broker, and send messages from that broker towards the
target server.
diff --git
a/examples/features/broker-connection/amqp-sending-messages/readme.md
b/examples/features/broker-connection/amqp-sending-messages/readme.md
index 6cf4de1..0cc1684 100644
--- a/examples/features/broker-connection/amqp-sending-messages/readme.md
+++ b/examples/features/broker-connection/amqp-sending-messages/readme.md
@@ -1,5 +1,7 @@
# AMQP Broker Connection with Senders
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to create and start the broker manually.
This example demonstrates how you can create a broker connection from one
broker towards another broker, and send messages from that broker towards the
target server.
diff --git a/examples/features/broker-connection/amqp-sending-overssl/readme.md
b/examples/features/broker-connection/amqp-sending-overssl/readme.md
index 851a3ff..6220267 100644
--- a/examples/features/broker-connection/amqp-sending-overssl/readme.md
+++ b/examples/features/broker-connection/amqp-sending-overssl/readme.md
@@ -1,4 +1,6 @@
# AMQP Broker Connection with Senders and SSL
+
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to create and start the broker manually.
diff --git a/examples/features/broker-connection/disaster-recovery/readme.md
b/examples/features/broker-connection/disaster-recovery/readme.md
index b346bc3..e3f4bff 100644
--- a/examples/features/broker-connection/disaster-recovery/readme.md
+++ b/examples/features/broker-connection/disaster-recovery/readme.md
@@ -1,4 +1,6 @@
# AMQP Broker Disaster Recovery
+
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to create and start the broker manually.
diff --git a/examples/features/clustered/client-side-load-balancing/readme.md
b/examples/features/clustered/client-side-load-balancing/readme.md
index 6b66fbd..756dbc4 100644
--- a/examples/features/clustered/client-side-load-balancing/readme.md
+++ b/examples/features/clustered/client-side-load-balancing/readme.md
@@ -1,5 +1,7 @@
# JMS Client-Side Load-Balancing Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to create and start the broker manually.
This example demonstrates how connections created from a single JMS Connection
factory can be created to different nodes of the cluster. In other words it
demonstrates how ActiveMQ Artemis does **client side load balancing** of
connections across the cluster.
diff --git
a/examples/features/clustered/clustered-durable-subscription/readme.md
b/examples/features/clustered/clustered-durable-subscription/readme.md
index dd82ec7..29ddc14 100644
--- a/examples/features/clustered/clustered-durable-subscription/readme.md
+++ b/examples/features/clustered/clustered-durable-subscription/readme.md
@@ -1,5 +1,7 @@
# JMS Clustered Durable Subscription Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example demonstrates a clustered JMS durable subscription. Normally
durable subscriptions exist on a single node and can only have one subscriber
at any one time, however, with ActiveMQ Artemis it's possible to create durable
subscription instances with the same name and client-id on different nodes of
the cluster, and consume from them simultaneously. This allows the work of
processing messages from a durable subscription to be spread across the cluster
in a similar way to how JMS [...]
diff --git a/examples/features/clustered/clustered-grouping/readme.md
b/examples/features/clustered/clustered-grouping/readme.md
index 82e37a5..890c508 100644
--- a/examples/features/clustered/clustered-grouping/readme.md
+++ b/examples/features/clustered/clustered-grouping/readme.md
@@ -2,6 +2,8 @@
Before continuing please **read the caveats about clustered grouping** in the
"Message Grouping" chapter of ActiveMQ Artemis User Guide. In short,
**clustered grouping is not recommended**.
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example demonstrates how to ensure strict ordering across a cluster using
clustered message grouping
diff --git a/examples/features/clustered/clustered-jgroups/readme.md
b/examples/features/clustered/clustered-jgroups/readme.md
index 9783268..be02dc7 100644
--- a/examples/features/clustered/clustered-jgroups/readme.md
+++ b/examples/features/clustered/clustered-jgroups/readme.md
@@ -1,5 +1,7 @@
# ActiveMQ Artemis Clustering with JGroups Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example demonstrates the working of a two node cluster using JGroups as
the underlying topology broadcasting/discovery technique.
diff --git a/examples/features/clustered/clustered-queue/readme.md
b/examples/features/clustered/clustered-queue/readme.md
index 769ce8b..7970ab6 100644
--- a/examples/features/clustered/clustered-queue/readme.md
+++ b/examples/features/clustered/clustered-queue/readme.md
@@ -1,5 +1,7 @@
# JMS Load Balanced Clustered Queue Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example demonstrates a JMS queue deployed on two different nodes. The two
nodes are configured to form a cluster.
diff --git
a/examples/features/clustered/clustered-static-discovery-uri/readme.md
b/examples/features/clustered/clustered-static-discovery-uri/readme.md
index d2f9ca1..5c019c2 100644
--- a/examples/features/clustered/clustered-static-discovery-uri/readme.md
+++ b/examples/features/clustered/clustered-static-discovery-uri/readme.md
@@ -1,5 +1,7 @@
# JMS Load Balanced Static Clustered Queue Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example demonstrates a JMS queue deployed on two different nodes. The two
nodes are configured to form a cluster from a _static_ list of nodes.
diff --git a/examples/features/clustered/clustered-static-discovery/readme.md
b/examples/features/clustered/clustered-static-discovery/readme.md
index d2f9ca1..5c019c2 100644
--- a/examples/features/clustered/clustered-static-discovery/readme.md
+++ b/examples/features/clustered/clustered-static-discovery/readme.md
@@ -1,5 +1,7 @@
# JMS Load Balanced Static Clustered Queue Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example demonstrates a JMS queue deployed on two different nodes. The two
nodes are configured to form a cluster from a _static_ list of nodes.
diff --git a/examples/features/clustered/clustered-static-oneway/readme.md
b/examples/features/clustered/clustered-static-oneway/readme.md
index a6c2faa..faf05ce 100644
--- a/examples/features/clustered/clustered-static-oneway/readme.md
+++ b/examples/features/clustered/clustered-static-oneway/readme.md
@@ -1,5 +1,7 @@
# JMS Load Balanced Static Clustered One Way Queue Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example demonstrates a JMS queue deployed on three different nodes. The
three nodes are configured to form a one way cluster from a _static_ list of
nodes.
diff --git a/examples/features/clustered/clustered-topic-uri/readme.md
b/examples/features/clustered/clustered-topic-uri/readme.md
index 22b9d18..c961c64 100644
--- a/examples/features/clustered/clustered-topic-uri/readme.md
+++ b/examples/features/clustered/clustered-topic-uri/readme.md
@@ -1,5 +1,7 @@
# JMS Clustered Topic URI Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example demonstrates a JMS Topic deployed on two different nodes. The two
nodes are configured to form a cluster.
diff --git a/examples/features/clustered/clustered-topic/readme.md
b/examples/features/clustered/clustered-topic/readme.md
index 397d0e7..d7e1553 100644
--- a/examples/features/clustered/clustered-topic/readme.md
+++ b/examples/features/clustered/clustered-topic/readme.md
@@ -1,5 +1,7 @@
# JMS Clustered Topic Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example demonstrates a JMS Topic deployed on two different nodes. The two
nodes are configured to form a cluster.
diff --git a/examples/features/clustered/queue-message-redistribution/readme.md
b/examples/features/clustered/queue-message-redistribution/readme.md
index f1a7575..f8f160e 100644
--- a/examples/features/clustered/queue-message-redistribution/readme.md
+++ b/examples/features/clustered/queue-message-redistribution/readme.md
@@ -1,5 +1,7 @@
# Message Redistribution Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example demonstrates message redistribution between queues with the same
name deployed in different nodes of a cluster.
diff --git a/examples/features/clustered/symmetric-cluster/readme.md
b/examples/features/clustered/symmetric-cluster/readme.md
index b7b592b..cc271dc 100644
--- a/examples/features/clustered/symmetric-cluster/readme.md
+++ b/examples/features/clustered/symmetric-cluster/readme.md
@@ -1,5 +1,7 @@
# JMS Symmetric Cluster Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This examples demonstrates a **symmetric cluster** set-up with ActiveMQ
Artemis.
diff --git a/examples/features/connection-router/evenly-redirect/readme.md
b/examples/features/connection-router/evenly-redirect/readme.md
index 03e3589..effd6e9 100644
--- a/examples/features/connection-router/evenly-redirect/readme.md
+++ b/examples/features/connection-router/evenly-redirect/readme.md
@@ -1,8 +1,9 @@
# Evenly Redirect Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to create and start the broker manually.
This example demonstrates how incoming client connections are evenly
redirected across two brokers
using a third broker with a connection router to redirect incoming client
connections,
based on a least-connections policy and caching on a filtered prefix of the
connection ClientID.
-
diff --git a/examples/features/connection-router/symmetric-redirect/readme.md
b/examples/features/connection-router/symmetric-redirect/readme.md
index ee75faa..5162ae6 100644
--- a/examples/features/connection-router/symmetric-redirect/readme.md
+++ b/examples/features/connection-router/symmetric-redirect/readme.md
@@ -1,5 +1,7 @@
# Symmetric Redirect Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to create and start the broker manually.
This example demonstrates how incoming client connections are distributed
across two brokers
diff --git a/examples/features/connection-router/symmetric-simple/readme.md
b/examples/features/connection-router/symmetric-simple/readme.md
index da7c5bb..2eb13f4 100644
--- a/examples/features/connection-router/symmetric-simple/readme.md
+++ b/examples/features/connection-router/symmetric-simple/readme.md
@@ -1,5 +1,7 @@
# Symmetric Simple Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to create and start the broker manually.
This example demonstrates how data is partitioned across two brokers. The idea
is to focus on
diff --git a/examples/features/federation/federated-address-divert/readme.md
b/examples/features/federation/federated-address-divert/readme.md
index b30d43b..0ee6a28 100644
--- a/examples/features/federation/federated-address-divert/readme.md
+++ b/examples/features/federation/federated-address-divert/readme.md
@@ -1,5 +1,7 @@
# Federated Address Divert Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example demonstrates a core multicast address deployed on two different
brokers. The two brokers are configured to form a federated address mesh.
diff --git
a/examples/features/federation/federated-address-downstream-upstream/readme.md
b/examples/features/federation/federated-address-downstream-upstream/readme.md
index 641ba09..12ed239 100644
---
a/examples/features/federation/federated-address-downstream-upstream/readme.md
+++
b/examples/features/federation/federated-address-downstream-upstream/readme.md
@@ -1,5 +1,7 @@
# Federated Address Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example demonstrates a core multicast address deployed on three different
brokers. The three brokers are configured to form a federated address mesh.
diff --git
a/examples/features/federation/federated-address-downstream/readme.md
b/examples/features/federation/federated-address-downstream/readme.md
index 641ba09..12ed239 100644
--- a/examples/features/federation/federated-address-downstream/readme.md
+++ b/examples/features/federation/federated-address-downstream/readme.md
@@ -1,5 +1,7 @@
# Federated Address Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example demonstrates a core multicast address deployed on three different
brokers. The three brokers are configured to form a federated address mesh.
diff --git a/examples/features/federation/federated-address/readme.md
b/examples/features/federation/federated-address/readme.md
index 641ba09..12ed239 100644
--- a/examples/features/federation/federated-address/readme.md
+++ b/examples/features/federation/federated-address/readme.md
@@ -1,5 +1,7 @@
# Federated Address Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example demonstrates a core multicast address deployed on three different
brokers. The three brokers are configured to form a federated address mesh.
diff --git
a/examples/features/federation/federated-queue-downstream-upstream/readme.md
b/examples/features/federation/federated-queue-downstream-upstream/readme.md
index 347c60d..a4893ec 100644
--- a/examples/features/federation/federated-queue-downstream-upstream/readme.md
+++ b/examples/features/federation/federated-queue-downstream-upstream/readme.md
@@ -1,5 +1,7 @@
# Federated Queue Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example demonstrates a core queue deployed on three different brokers.
The three brokers are configured to form a federated queue mesh.
diff --git a/examples/features/federation/federated-queue-downstream/readme.md
b/examples/features/federation/federated-queue-downstream/readme.md
index 347c60d..a4893ec 100644
--- a/examples/features/federation/federated-queue-downstream/readme.md
+++ b/examples/features/federation/federated-queue-downstream/readme.md
@@ -1,5 +1,7 @@
# Federated Queue Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example demonstrates a core queue deployed on three different brokers.
The three brokers are configured to form a federated queue mesh.
diff --git a/examples/features/federation/federated-queue/readme.md
b/examples/features/federation/federated-queue/readme.md
index 347c60d..a4893ec 100644
--- a/examples/features/federation/federated-queue/readme.md
+++ b/examples/features/federation/federated-queue/readme.md
@@ -1,5 +1,7 @@
# Federated Queue Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example demonstrates a core queue deployed on three different brokers.
The three brokers are configured to form a federated queue mesh.
diff --git a/examples/features/ha/application-layer-failover/readme.md
b/examples/features/ha/application-layer-failover/readme.md
index 1ef46b4..c9cb10e 100644
--- a/examples/features/ha/application-layer-failover/readme.md
+++ b/examples/features/ha/application-layer-failover/readme.md
@@ -1,5 +1,7 @@
# JMS Application-Layer Failover Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory. This
example will always spawn and stop multiple brokers.
ActiveMQ Artemis implements fully transparent **automatic** failover of
connections from a live node to a backup node which requires no special coding.
This is described in a different example and requires broker replication.
diff --git a/examples/features/ha/client-side-failoverlistener/readme.md
b/examples/features/ha/client-side-failoverlistener/readme.md
index c766986..5fc83d4 100644
--- a/examples/features/ha/client-side-failoverlistener/readme.md
+++ b/examples/features/ha/client-side-failoverlistener/readme.md
@@ -1,5 +1,7 @@
# JMS Client Side Failover Listener Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory. This
example will always spawn and stop multiple servers.
This example demonstrates how you can listen on failover event on the client
side.
diff --git a/examples/features/ha/colocated-failover-scale-down/readme.md
b/examples/features/ha/colocated-failover-scale-down/readme.md
index 3b9c81a..5f69e07 100644
--- a/examples/features/ha/colocated-failover-scale-down/readme.md
+++ b/examples/features/ha/colocated-failover-scale-down/readme.md
@@ -1,5 +1,7 @@
# JMS Colocated Failover Recover Only Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory. This
example will always spawn and stop multiple servers.
This example demonstrates how you can colocate live and backup servers in the
same VM. We do this by creating an HA Policy that is colocated. Colocated means
that backup servers can be created and maintained by live servers on behalf of
other requesting live servers. In this example we create a colocated shared
store broker that will scale down. That is it will not become live but scale
down the journal to the colocated live server.
diff --git a/examples/features/ha/colocated-failover/readme.md
b/examples/features/ha/colocated-failover/readme.md
index b338e5a..9aa10a2 100644
--- a/examples/features/ha/colocated-failover/readme.md
+++ b/examples/features/ha/colocated-failover/readme.md
@@ -1,5 +1,7 @@
# JMS Colocated Failover Shared Store Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory. This
example will always spawn and stop multiple brokers.
This example demonstrates how you can colocate live and backup brokers in the
same VM. We do this by creating an HA Policy that is colocated. Colocated means
that backup brokers can be created and maintained by live brokers on behalf of
other live brokers requesting a backup. In this example we create a colocated
shared store broker.
diff --git a/examples/features/ha/non-transaction-failover/readme.md
b/examples/features/ha/non-transaction-failover/readme.md
index 6c51d89..ef99388 100644
--- a/examples/features/ha/non-transaction-failover/readme.md
+++ b/examples/features/ha/non-transaction-failover/readme.md
@@ -1,5 +1,7 @@
# JMS Non Transaction Failover Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory.
This example demonstrates two servers coupled as a live-backup pair for high
availability (HA), and a client connection failing over from live to backup
when the live broker is crashed.
diff --git a/examples/features/ha/replicated-failback-static/readme.md
b/examples/features/ha/replicated-failback-static/readme.md
index f48c885..cfdf5dc 100644
--- a/examples/features/ha/replicated-failback-static/readme.md
+++ b/examples/features/ha/replicated-failback-static/readme.md
@@ -1,5 +1,7 @@
# JMS Replicated Failback Static Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory.
This example is the same as the "replicated-failback" example but with a
"static" clustering configuration (i.e. not using UDP multicast).
diff --git a/examples/features/ha/replicated-failback/readme.md
b/examples/features/ha/replicated-failback/readme.md
index 8dfe609..73544bc 100644
--- a/examples/features/ha/replicated-failback/readme.md
+++ b/examples/features/ha/replicated-failback/readme.md
@@ -1,5 +1,7 @@
# JMS Replicated Failback Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory.
This example demonstrates two servers coupled as a live-backup pair for high
availability (HA) using replication and a client connection failing over from
live to backup when the live broker is crashed and then back to the original
live when it is restarted (i.e. "failback").
diff --git a/examples/features/ha/replicated-multiple-failover/readme.md
b/examples/features/ha/replicated-multiple-failover/readme.md
index 06e44d0..0610bae 100644
--- a/examples/features/ha/replicated-multiple-failover/readme.md
+++ b/examples/features/ha/replicated-multiple-failover/readme.md
@@ -1,5 +1,7 @@
# JMS Multiple Failover using Replication Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory.
This example demonstrates three servers coupled as a live-backup-backup group
for high availability (HA) using replication, and a client connection failing
over from live to backup when the live broker is crashed and then to the second
backup once the new live fails.
diff --git a/examples/features/ha/zookeeper-single-pair-failback/readme.md
b/examples/features/ha/zookeeper-single-pair-failback/readme.md
index 2d5ece4..4ba4652 100644
--- a/examples/features/ha/zookeeper-single-pair-failback/readme.md
+++ b/examples/features/ha/zookeeper-single-pair-failback/readme.md
@@ -9,6 +9,8 @@ pluggable quorum vote replication Reference Implementation
based on [Apache Cura
The example shows a client connection failing over from live to backup when
the live broker is crashed and
then back to the original live when it is restarted (i.e. "failback").
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory after
running a Zookeeper node at `localhost:2181`.
If no Zookeeper node is configured, can use the commands below (see [Official
Zookeeper Docker Image Site](https://hub.docker.com/_/zookeeper)
diff --git a/examples/features/perf/soak/readme.md
b/examples/features/perf/soak/readme.md
index efc93b7..d4bea04 100644
--- a/examples/features/perf/soak/readme.md
+++ b/examples/features/perf/soak/readme.md
@@ -2,6 +2,8 @@
## Run The Server Standalone
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
Use the Profile server
mvn -Pserver verify
diff --git a/examples/features/standard/auto-closeable/readme.md
b/examples/features/standard/auto-closeable/readme.md
index 248fca1..7d7389b 100644
--- a/examples/features/standard/auto-closeable/readme.md
+++ b/examples/features/standard/auto-closeable/readme.md
@@ -1,5 +1,7 @@
# JMS Auto Closable Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how JMS resources such as connections, sessions and
consumers in JMS 2 can be automatically closed on error.
diff --git a/examples/features/standard/broker-msg-auth-plugin/readme.md
b/examples/features/standard/broker-msg-auth-plugin/readme.md
index f8b3ae9..f8ad85b 100644
--- a/examples/features/standard/broker-msg-auth-plugin/readme.md
+++ b/examples/features/standard/broker-msg-auth-plugin/readme.md
@@ -1,5 +1,7 @@
# Broker Plugin Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows how a message plugin can be used to filter message sent to
a consumer depending on that consumers roles. Credentials for a user are by
default invalidated every 10 seconds so this plugin may cause excessive
authentication if used without configuring the security-invalidation-interval
limit appropriately.
\ No newline at end of file
diff --git a/examples/features/standard/broker-plugin/readme.md
b/examples/features/standard/broker-plugin/readme.md
index 8862e73..c07768e 100644
--- a/examples/features/standard/broker-plugin/readme.md
+++ b/examples/features/standard/broker-plugin/readme.md
@@ -1,5 +1,7 @@
# Broker Plugin Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
AMQP Messages should be by definition immutable at the server's. So, we don't
recommend changing message contents. However if you require you can use this
example as a basis for adding properties on making changes
\ No newline at end of file
diff --git a/examples/features/standard/browser/readme.md
b/examples/features/standard/browser/readme.md
index fc68d54..514c548 100644
--- a/examples/features/standard/browser/readme.md
+++ b/examples/features/standard/browser/readme.md
@@ -1,5 +1,7 @@
# JMS QueueBrowser Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to use a JMS
[QueueBrowser](https://docs.oracle.com/javaee/7/api/javax/jms/QueueBrowser.html)
with ActiveMQ Artemis.
diff --git a/examples/features/standard/camel/readme.md
b/examples/features/standard/camel/readme.md
index a39fa7c..f30db8a 100644
--- a/examples/features/standard/camel/readme.md
+++ b/examples/features/standard/camel/readme.md
@@ -1,5 +1,7 @@
# Camel Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example contains 2 different Maven modules:
diff --git a/examples/features/standard/cdi/readme.md
b/examples/features/standard/cdi/readme.md
index 3cf4c68..c6194d1 100644
--- a/examples/features/standard/cdi/readme.md
+++ b/examples/features/standard/cdi/readme.md
@@ -19,6 +19,10 @@
-->
# CDI Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
+To run the example, simply type **mvn verify** from this directory.
+
This is a simple example that demonstrates how to use CDI to integrate with
ActiveMQ Artemis on the client side. It is designed mainly for connecting to a
remote broker rather than embedding within your application.
## Configuring the connection
diff --git a/examples/features/standard/client-kickoff/readme.md
b/examples/features/standard/client-kickoff/readme.md
index 595901f..5737241 100644
--- a/examples/features/standard/client-kickoff/readme.md
+++ b/examples/features/standard/client-kickoff/readme.md
@@ -1,5 +1,7 @@
# Client Kickoff Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows how to kick off a client connected to ActiveMQ using
[JMX](http://www.oracle.com/technetwork/java/javase/tech/javamanagement-140525.html)
diff --git a/examples/features/standard/completion-listener/readme.md
b/examples/features/standard/completion-listener/readme.md
index a8c7d6d..000be0a 100644
--- a/examples/features/standard/completion-listener/readme.md
+++ b/examples/features/standard/completion-listener/readme.md
@@ -1,5 +1,7 @@
# JMS Completion Listener Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to send a message asynchronously to ActiveMQ
Artemis and use a CompletionListener to be notified of the Broker receiving it.
\ No newline at end of file
diff --git a/examples/features/standard/consumer-rate-limit/readme.md
b/examples/features/standard/consumer-rate-limit/readme.md
index 923c068..be61053 100644
--- a/examples/features/standard/consumer-rate-limit/readme.md
+++ b/examples/features/standard/consumer-rate-limit/readme.md
@@ -1,5 +1,7 @@
# JMS Message Consumer Rate Limiting
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
With ActiveMQ Artemis you can specify a maximum consume rate at which a JMS
MessageConsumer will consume messages. This can be specified when creating or
configuring the connection factory. See `jndi.properties`.
diff --git a/examples/features/standard/context/readme.md
b/examples/features/standard/context/readme.md
index 0f03836..c98fa00 100644
--- a/examples/features/standard/context/readme.md
+++ b/examples/features/standard/context/readme.md
@@ -1,5 +1,7 @@
# JMS Context Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to send and receive a message to a JMS Queue using
ActiveMQ Artemis by using a JMSContext.
diff --git a/examples/features/standard/core-bridge/readme.md
b/examples/features/standard/core-bridge/readme.md
index 66fcb75..67dedbd 100644
--- a/examples/features/standard/core-bridge/readme.md
+++ b/examples/features/standard/core-bridge/readme.md
@@ -1,5 +1,7 @@
# Core Bridge Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example demonstrates a core bridge deployed on one server, which consumes
messages from a local queue and forwards them to an address on a second server.
diff --git a/examples/features/standard/database/readme.md
b/examples/features/standard/database/readme.md
index fa1613c..d2d1c0c 100644
--- a/examples/features/standard/database/readme.md
+++ b/examples/features/standard/database/readme.md
@@ -1,5 +1,7 @@
# Database example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to configure ActiveMQ Artemis to run with a
database.
diff --git a/examples/features/standard/dead-letter/readme.md
b/examples/features/standard/dead-letter/readme.md
index 68a5adc..5a55347 100644
--- a/examples/features/standard/dead-letter/readme.md
+++ b/examples/features/standard/dead-letter/readme.md
@@ -1,5 +1,7 @@
# Dead Letter Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to define and deal with dead letter messages.
diff --git a/examples/features/standard/delayed-redelivery/readme.md
b/examples/features/standard/delayed-redelivery/readme.md
index 722a796..af0eb11 100644
--- a/examples/features/standard/delayed-redelivery/readme.md
+++ b/examples/features/standard/delayed-redelivery/readme.md
@@ -1,5 +1,7 @@
# Delayed Redelivery Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example demonstrates how ActiveMQ Artemis can be configured to provide a
delayed redelivery in the case where a message needs to be redelivered.
diff --git a/examples/features/standard/divert/readme.md
b/examples/features/standard/divert/readme.md
index 8651024..0cea170 100644
--- a/examples/features/standard/divert/readme.md
+++ b/examples/features/standard/divert/readme.md
@@ -1,5 +1,7 @@
# Divert Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
ActiveMQ Artemis diverts allow messages to be transparently "diverted" from
one address to another with just some simple configuration defined on the
broker side.
diff --git a/examples/features/standard/durable-subscription/readme.md
b/examples/features/standard/durable-subscription/readme.md
index 6b74040..4153987 100644
--- a/examples/features/standard/durable-subscription/readme.md
+++ b/examples/features/standard/durable-subscription/readme.md
@@ -1,5 +1,7 @@
# JMS Durable Subscription Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example demonstrates how to use a durable subscription with ActiveMQ
Artemis.
diff --git a/examples/features/standard/embedded-simple/readme.md
b/examples/features/standard/embedded-simple/readme.md
index 7b85d02..11e2151 100644
--- a/examples/features/standard/embedded-simple/readme.md
+++ b/examples/features/standard/embedded-simple/readme.md
@@ -1,5 +1,7 @@
# Embedded Broker with External Config Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory.
This examples shows how to setup and run an embedded broker using ActiveMQ
Artemis.
diff --git a/examples/features/standard/embedded/readme.md
b/examples/features/standard/embedded/readme.md
index c70c044..551a2ad 100644
--- a/examples/features/standard/embedded/readme.md
+++ b/examples/features/standard/embedded/readme.md
@@ -1,5 +1,7 @@
# Embedded Broker with Programmatic Config Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory.
This examples shows how to setup and run an embedded broker using ActiveMQ
Artemis.
diff --git a/examples/features/standard/exclusive-queue/readme.md
b/examples/features/standard/exclusive-queue/readme.md
index 2712afd..3700ba4 100644
--- a/examples/features/standard/exclusive-queue/readme.md
+++ b/examples/features/standard/exclusive-queue/readme.md
@@ -1,5 +1,7 @@
# JMS Exclusive Queue Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to configure ActiveMQ Artemis so all messages are
delivered to the same consumer
diff --git a/examples/features/standard/expiry/readme.md
b/examples/features/standard/expiry/readme.md
index 963e6de..258cb8b 100644
--- a/examples/features/standard/expiry/readme.md
+++ b/examples/features/standard/expiry/readme.md
@@ -1,5 +1,7 @@
# JMS Expiration Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to configure ActiveMQ Artemis so messages are
expipired after a certain time.
diff --git a/examples/features/standard/http-transport/readme.md
b/examples/features/standard/http-transport/readme.md
index 5c1951c..fed6591 100644
--- a/examples/features/standard/http-transport/readme.md
+++ b/examples/features/standard/http-transport/readme.md
@@ -1,5 +1,7 @@
# JMS HTTP Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to configure ActiveMQ Artemis to use the HTTP
protocol as its transport layer.
diff --git a/examples/features/standard/interceptor-amqp/readme.md
b/examples/features/standard/interceptor-amqp/readme.md
index 89ab8b0..d7de6c2 100644
--- a/examples/features/standard/interceptor-amqp/readme.md
+++ b/examples/features/standard/interceptor-amqp/readme.md
@@ -1,5 +1,7 @@
# AMQP Interceptor Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to implement and configure a simple incoming,
server-side AMQP interceptor with ActiveMQ Artemis.
diff --git a/examples/features/standard/interceptor-client/readme.md
b/examples/features/standard/interceptor-client/readme.md
index 2f83bce..51203ad 100644
--- a/examples/features/standard/interceptor-client/readme.md
+++ b/examples/features/standard/interceptor-client/readme.md
@@ -1,5 +1,7 @@
# JMS Interceptor Client Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to implement and configure a simple incoming,
client-side interceptor with ActiveMQ Artemis.
diff --git a/examples/features/standard/interceptor-mqtt/readme.md
b/examples/features/standard/interceptor-mqtt/readme.md
index c6d5627..cf9745a 100644
--- a/examples/features/standard/interceptor-mqtt/readme.md
+++ b/examples/features/standard/interceptor-mqtt/readme.md
@@ -1,5 +1,7 @@
# MQTT Interceptor Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to implement and configure a simple incoming,
server-side MQTT interceptor with ActiveMQ Artemis.
diff --git a/examples/features/standard/interceptor/readme.md
b/examples/features/standard/interceptor/readme.md
index 375f82e..84a8ae2 100644
--- a/examples/features/standard/interceptor/readme.md
+++ b/examples/features/standard/interceptor/readme.md
@@ -1,5 +1,7 @@
# JMS Interceptor Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to implement and configure a simple incoming,
server-side interceptor with ActiveMQ Artemis.
diff --git a/examples/features/standard/jms-bridge/readme.md
b/examples/features/standard/jms-bridge/readme.md
index 8001bcd..3af6fb7 100644
--- a/examples/features/standard/jms-bridge/readme.md
+++ b/examples/features/standard/jms-bridge/readme.md
@@ -1,5 +1,7 @@
# JMS Bridge Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to create a JMS Bridge between two ActiveMQ Artemis
brokers.
diff --git a/examples/features/standard/jmx-ssl/readme.md
b/examples/features/standard/jmx-ssl/readme.md
index b5154bd..3c1147a 100644
--- a/examples/features/standard/jmx-ssl/readme.md
+++ b/examples/features/standard/jmx-ssl/readme.md
@@ -1,5 +1,7 @@
# JMX Management Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows how to manage ActiveMQ Artemis using [JMX over
SSL](http://www.oracle.com/technetwork/java/javase/tech/javamanagement-140525.html)
diff --git a/examples/features/standard/jmx/readme.md
b/examples/features/standard/jmx/readme.md
index 0b3803b..dad7f8c 100644
--- a/examples/features/standard/jmx/readme.md
+++ b/examples/features/standard/jmx/readme.md
@@ -1,5 +1,7 @@
# JMX Management Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows how to manage ActiveMQ Artemis using
[JMX](http://www.oracle.com/technetwork/java/javase/tech/javamanagement-140525.html)
diff --git a/examples/features/standard/large-message/readme.md
b/examples/features/standard/large-message/readme.md
index 144881b..13c07bf 100644
--- a/examples/features/standard/large-message/readme.md
+++ b/examples/features/standard/large-message/readme.md
@@ -1,5 +1,7 @@
# Large Message Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, This
example will start and stop the broker since it will look for a failure.
This example shows you how to send and receive very large messages with
ActiveMQ Artemis.
diff --git a/examples/features/standard/last-value-queue/readme.md
b/examples/features/standard/last-value-queue/readme.md
index 297d277..9eeacd2 100644
--- a/examples/features/standard/last-value-queue/readme.md
+++ b/examples/features/standard/last-value-queue/readme.md
@@ -1,5 +1,7 @@
# Last-Value Queue Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to configure and use last-value queues.
diff --git a/examples/features/standard/management-notifications/readme.md
b/examples/features/standard/management-notifications/readme.md
index 9cee5e0..3ea674d 100644
--- a/examples/features/standard/management-notifications/readme.md
+++ b/examples/features/standard/management-notifications/readme.md
@@ -1,5 +1,7 @@
# Management Notification Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows how to receive management notifications from ActiveMQ
Artemis using JMS Messages.
diff --git a/examples/features/standard/management/readme.md
b/examples/features/standard/management/readme.md
index 425c22a..dcc6c56 100644
--- a/examples/features/standard/management/readme.md
+++ b/examples/features/standard/management/readme.md
@@ -1,5 +1,9 @@
# Management Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
+To run the example, simply type **mvn verify** from this directory.
+
This example shows how to manage ActiveMQ Artemis using JMS Messages to invoke
management operations on the server.
To manage ActiveMQ Artemis using JMX, see the "jmx" example.
diff --git a/examples/features/standard/message-counters/readme.md
b/examples/features/standard/message-counters/readme.md
index f5ff5a7..6321a03 100644
--- a/examples/features/standard/message-counters/readme.md
+++ b/examples/features/standard/message-counters/readme.md
@@ -1,5 +1,7 @@
# JMS Message Counter Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to use message counters to obtain message
information for a JMS queue.
diff --git a/examples/features/standard/message-group/readme.md
b/examples/features/standard/message-group/readme.md
index b570bf3..b8065d6 100644
--- a/examples/features/standard/message-group/readme.md
+++ b/examples/features/standard/message-group/readme.md
@@ -1,5 +1,7 @@
# Message Group Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to configure and use message groups with ActiveMQ
Artemis.
diff --git a/examples/features/standard/message-group2/readme.md
b/examples/features/standard/message-group2/readme.md
index 0a81e20..062515d 100644
--- a/examples/features/standard/message-group2/readme.md
+++ b/examples/features/standard/message-group2/readme.md
@@ -1,5 +1,7 @@
# Message Group Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to configure and use message groups via a
connection factory with ActiveMQ Artemis.
diff --git a/examples/features/standard/message-priority/readme.md
b/examples/features/standard/message-priority/readme.md
index e48746a..5c8aaad 100644
--- a/examples/features/standard/message-priority/readme.md
+++ b/examples/features/standard/message-priority/readme.md
@@ -1,5 +1,7 @@
# JMS Message Priority Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows how messages with different priorities are delivered in
different orders.
diff --git a/examples/features/standard/netty-openssl/readme.md
b/examples/features/standard/netty-openssl/readme.md
index fbae0e9..de012a5 100644
--- a/examples/features/standard/netty-openssl/readme.md
+++ b/examples/features/standard/netty-openssl/readme.md
@@ -1,5 +1,7 @@
# JMS OpenSSL Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to configure Netty OpenSSL with ActiveMQ Artemis to
send and receive message.
diff --git a/examples/features/standard/no-consumer-buffering/readme.md
b/examples/features/standard/no-consumer-buffering/readme.md
index 5ae359b..33512da 100644
--- a/examples/features/standard/no-consumer-buffering/readme.md
+++ b/examples/features/standard/no-consumer-buffering/readme.md
@@ -1,5 +1,7 @@
# No Consumer Buffering Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
By default, ActiveMQ Artemis consumers buffer messages from the broker in a
client side buffer before actual delivery actually occurs.
diff --git a/examples/features/standard/opentelemetry/readme.md
b/examples/features/standard/opentelemetry/readme.md
index e537d7a..ce9b485 100644
--- a/examples/features/standard/opentelemetry/readme.md
+++ b/examples/features/standard/opentelemetry/readme.md
@@ -8,6 +8,8 @@ using environment-based properties to configure OpenTelemetry
SDK.
[](https://www.youtube.com/watch?v=MVGx7QrztZQ)
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start
and create the broker manually.
> **_NOTE:_** You must have
> [jeager](https://github.com/open-telemetry/opentelemetry-java/tree/main/sdk-extensions/autoconfigure#jaeger-exporter)
> running at `http://localhost:16686`. You can learn more about Jeager
> [here](https://www.jaegertracing.io/)
diff --git a/examples/features/standard/paging/readme.md
b/examples/features/standard/paging/readme.md
index f0697e1..ef89c55 100644
--- a/examples/features/standard/paging/readme.md
+++ b/examples/features/standard/paging/readme.md
@@ -1,5 +1,7 @@
# Paging Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows how ActiveMQ Artemis would avoid running out of memory
resources by paging messages.
diff --git a/examples/features/standard/pre-acknowledge/readme.md
b/examples/features/standard/pre-acknowledge/readme.md
index 014b91d..d511c72 100644
--- a/examples/features/standard/pre-acknowledge/readme.md
+++ b/examples/features/standard/pre-acknowledge/readme.md
@@ -1,5 +1,7 @@
# JMS Pre-Acknowledge Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
Standard JMS supports three acknowledgement modes: AUTO_ACKNOWLEDGE,
CLIENT_ACKNOWLEDGE, and DUPS_OK_ACKNOWLEDGE. For a full description on these
modes please consult the JMS specification, or any JMS tutorial.
diff --git a/examples/features/standard/producer-rate-limit/readme.md
b/examples/features/standard/producer-rate-limit/readme.md
index b8db366..09e3ba9 100644
--- a/examples/features/standard/producer-rate-limit/readme.md
+++ b/examples/features/standard/producer-rate-limit/readme.md
@@ -1,5 +1,7 @@
# JMS Message Producer Rate Limiting
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
With ActiveMQ Artemis you can specify a maximum send rate at which a JMS
MessageProducer will send messages. This can be specified when creating or
deploying the connection factory. See `activemq-jms.xml`
diff --git a/examples/features/standard/queue-jakarta/readme.md
b/examples/features/standard/queue-jakarta/readme.md
index 41e01d9..68e4417 100644
--- a/examples/features/standard/queue-jakarta/readme.md
+++ b/examples/features/standard/queue-jakarta/readme.md
@@ -1,5 +1,7 @@
# Jakarta Messaging 3.0 Queue Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to send and receive a message to a JMS Queue using
ActiveMQ Artemis.
diff --git a/examples/features/standard/queue-requestor/readme.md
b/examples/features/standard/queue-requestor/readme.md
index 1730b20..de6cebc 100644
--- a/examples/features/standard/queue-requestor/readme.md
+++ b/examples/features/standard/queue-requestor/readme.md
@@ -1,5 +1,7 @@
# JMS QueueRequestor Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to use a
[QueueRequestor](https://docs.oracle.com/javaee/7/api/javax/jms/QueueRequestor.html)
with ActiveMQ Artemis.
diff --git a/examples/features/standard/queue-selector/readme.md
b/examples/features/standard/queue-selector/readme.md
index 60448a4..1346d54 100644
--- a/examples/features/standard/queue-selector/readme.md
+++ b/examples/features/standard/queue-selector/readme.md
@@ -1,5 +1,7 @@
# JMS Queue Selector Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to selectively consume messages using message
selectors with queue consumers.
diff --git a/examples/features/standard/queue/readme.md
b/examples/features/standard/queue/readme.md
index bbe6012..ab22a59 100644
--- a/examples/features/standard/queue/readme.md
+++ b/examples/features/standard/queue/readme.md
@@ -1,5 +1,7 @@
# JMS Queue Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to send and receive a message to a JMS Queue using
ActiveMQ Artemis.
diff --git a/examples/features/standard/reattach-node/readme.md
b/examples/features/standard/reattach-node/readme.md
index ef09c34..903e079 100644
--- a/examples/features/standard/reattach-node/readme.md
+++ b/examples/features/standard/reattach-node/readme.md
@@ -1,5 +1,7 @@
# JMS Reattach Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example demonstrates how ActiveMQ Artemis connections can be configured
to be resilient to temporary network failures.
diff --git a/examples/features/standard/request-reply/readme.md
b/examples/features/standard/request-reply/readme.md
index 68ee072..23215de 100644
--- a/examples/features/standard/request-reply/readme.md
+++ b/examples/features/standard/request-reply/readme.md
@@ -1,5 +1,7 @@
# JMS Request-Reply Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify -Pexample** from this directory.
This example shows you how to handle a request message and receive a reply. To
get a reply message, the requesting client creates a temporary queue. Then it
sends out the request message with JMSReplyTo set to the temporary queue. The
request message is handled by a SimpleRequestServer, who is listening to the
request queue for incoming requests. If a request message has arrived, it
extracts the reply queue from the request message by JMSReplyTo header, and
sends back a reply message. To [...]
diff --git a/examples/features/standard/scheduled-message/readme.md
b/examples/features/standard/scheduled-message/readme.md
index 2841aae..5b970c8 100644
--- a/examples/features/standard/scheduled-message/readme.md
+++ b/examples/features/standard/scheduled-message/readme.md
@@ -1,5 +1,7 @@
# JMS Scheduled Message Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to send a scheduled message to a JMS Queue using
ActiveMQ Artemis.
diff --git a/examples/features/standard/security-keycloak/readme.md
b/examples/features/standard/security-keycloak/readme.md
index 9b7d6a6..ee16203 100644
--- a/examples/features/standard/security-keycloak/readme.md
+++ b/examples/features/standard/security-keycloak/readme.md
@@ -1,5 +1,7 @@
# JMS Security Keycloak Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
In this example, broker authentication is delegated to keycloak. A keycloak
server is installed and configured with
diff --git a/examples/features/standard/security-ldap/readme.md
b/examples/features/standard/security-ldap/readme.md
index 5fd81a8..6916f2f 100644
--- a/examples/features/standard/security-ldap/readme.md
+++ b/examples/features/standard/security-ldap/readme.md
@@ -1,5 +1,7 @@
# JMS Security LDAP Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
**Note:** The logging from the embedded Apache DS LDAP server is verbose and
it may appear that there are errors, but these logs can be ignored.
diff --git a/examples/features/standard/security-manager/readme.md
b/examples/features/standard/security-manager/readme.md
index 32335a4..93fe8f0 100644
--- a/examples/features/standard/security-manager/readme.md
+++ b/examples/features/standard/security-manager/readme.md
@@ -1,5 +1,7 @@
# JMS Security Manager Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example is based on the "security" example and demonstrates how to
implement a custom security manager. The custom security manager in this
example simply logs details for authentication and authorization and then
passes everything through to an instance of
`org.apache.activemq.artemis.spi.core.security.ActiveMQJAASSecurityManager`
(i.e. the default security manager).
\ No newline at end of file
diff --git a/examples/features/standard/security/readme.md
b/examples/features/standard/security/readme.md
index f78df6a..e7d8713 100644
--- a/examples/features/standard/security/readme.md
+++ b/examples/features/standard/security/readme.md
@@ -1,5 +1,7 @@
# JMS Security Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows how to configure and use security using ActiveMQ Artemis.
diff --git a/examples/features/standard/send-acknowledgements/readme.md
b/examples/features/standard/send-acknowledgements/readme.md
index e9dc702..0a98ae1 100644
--- a/examples/features/standard/send-acknowledgements/readme.md
+++ b/examples/features/standard/send-acknowledgements/readme.md
@@ -1,5 +1,7 @@
# Asynchronous Send Acknowledgements Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
Asynchronous Send Acknowledgements are an advanced feature of ActiveMQ Artemis
which allow you to receive acknowledgements that messages were successfully
received at the broker in a separate thread to the sending thread
diff --git a/examples/features/standard/shared-consumer/readme.md
b/examples/features/standard/shared-consumer/readme.md
index 090f110..9428bc5 100644
--- a/examples/features/standard/shared-consumer/readme.md
+++ b/examples/features/standard/shared-consumer/readme.md
@@ -1,5 +1,7 @@
# JMS Shared Consumer Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how can use shared consumers to share a subscription on
a topic. In JMS 1.1 this was not allowed and so caused a scalability issue. In
JMS 2 this restriction has been lifted so you can share the load across
different threads and connections.
\ No newline at end of file
diff --git a/examples/features/standard/slow-consumer/readme.md
b/examples/features/standard/slow-consumer/readme.md
index 3501aa4..d1d69d1 100644
--- a/examples/features/standard/slow-consumer/readme.md
+++ b/examples/features/standard/slow-consumer/readme.md
@@ -1,5 +1,7 @@
# JMS Slow Consumer Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the server manually.
This example demonstrates Slow Consumer policy KILL and NOTIFY and the
associated address-settings.
diff --git a/examples/features/standard/spring-boot-integration/readme.md
b/examples/features/standard/spring-boot-integration/readme.md
index 108b9a1..7a81857 100644
--- a/examples/features/standard/spring-boot-integration/readme.md
+++ b/examples/features/standard/spring-boot-integration/readme.md
@@ -1,7 +1,7 @@
# ActiveMQ Artemis Spring Boot Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory.
This example shows how to setup and run an embedded broker within a Spring
Boot Application relying on [AMQP 1.0 JMS Spring Boot
project](https://github.com/amqphub/amqp-10-jms-spring-boot) for configuration.
-
-
diff --git a/examples/features/standard/spring-integration/readme.md
b/examples/features/standard/spring-integration/readme.md
index e139278..b61369d 100644
--- a/examples/features/standard/spring-integration/readme.md
+++ b/examples/features/standard/spring-integration/readme.md
@@ -1,5 +1,7 @@
# ActiveMQ Artemis Spring Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory
This examples shows how to setup and run an embedded broker within a Spring
ApplicationContext using ActiveMQ Artemis along with ActiveMQ Artemis
configuration files.
\ No newline at end of file
diff --git a/examples/features/standard/ssl-enabled-crl-mqtt/readme.md
b/examples/features/standard/ssl-enabled-crl-mqtt/readme.md
index 399c7e8..2395978 100644
--- a/examples/features/standard/ssl-enabled-crl-mqtt/readme.md
+++ b/examples/features/standard/ssl-enabled-crl-mqtt/readme.md
@@ -1,5 +1,7 @@
# ActiveMQ Artemis MQTT CRL Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the server manually.
This example shows you how to configure 2-way SSL with CRL along with 2
different connections, one with a valid certificate and another with a revoked
certificate.
diff --git
a/examples/features/standard/ssl-enabled-dual-authentication/readme.md
b/examples/features/standard/ssl-enabled-dual-authentication/readme.md
index 10584e6..c680225 100644
--- a/examples/features/standard/ssl-enabled-dual-authentication/readme.md
+++ b/examples/features/standard/ssl-enabled-dual-authentication/readme.md
@@ -1,5 +1,7 @@
# JMS SSL Dual Authentication Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to configure 2-way SSL along with 2 different
authentications mechanisms so that SSL and non-SSL clients can send and consume
messages to/from ActiveMQ Artemis. The non-SSL authentication mechanism simply
uses username and password. The SSL authentication mechanism uses the client's
certificate.
diff --git a/examples/features/standard/ssl-enabled/readme.md
b/examples/features/standard/ssl-enabled/readme.md
index 5c3a12d..b5afbb0 100644
--- a/examples/features/standard/ssl-enabled/readme.md
+++ b/examples/features/standard/ssl-enabled/readme.md
@@ -1,5 +1,7 @@
# JMS SSL Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to configure SSL with ActiveMQ Artemis to send and
receive message.
diff --git a/examples/features/standard/static-selector/readme.md
b/examples/features/standard/static-selector/readme.md
index 0890840..5607c60 100644
--- a/examples/features/standard/static-selector/readme.md
+++ b/examples/features/standard/static-selector/readme.md
@@ -1,5 +1,7 @@
# Static Message Selector Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to configure a ActiveMQ Artemis queue with static
message selectors (filters).
diff --git a/examples/features/standard/temp-queue/readme.md
b/examples/features/standard/temp-queue/readme.md
index 8f06354..b41976c 100644
--- a/examples/features/standard/temp-queue/readme.md
+++ b/examples/features/standard/temp-queue/readme.md
@@ -1,5 +1,7 @@
# JMS Temporary Queue Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to use a TemporaryQueue with ActiveMQ Artemis.
First a temporary queue is created to send and receive a message and then
deleted. Then another temporary queue is created and used after its connection
is closed to illustrate its scope.
diff --git a/examples/features/standard/topic-hierarchies/readme.md
b/examples/features/standard/topic-hierarchies/readme.md
index 2f70bc7..b69048a 100644
--- a/examples/features/standard/topic-hierarchies/readme.md
+++ b/examples/features/standard/topic-hierarchies/readme.md
@@ -1,5 +1,7 @@
# Topic Hierarchy Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
ActiveMQ Artemis supports topic hierarchies. With a topic hierarchy you can
register a subscriber with a wild-card and that subscriber will receive any
messages routed to an address that match the wildcard.
diff --git a/examples/features/standard/topic-selector1/readme.md
b/examples/features/standard/topic-selector1/readme.md
index b0a5559..89ccea4 100644
--- a/examples/features/standard/topic-selector1/readme.md
+++ b/examples/features/standard/topic-selector1/readme.md
@@ -1,5 +1,7 @@
# JMS Topic Selector Example 1
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows how messages can be consumed from a topic using Message
Selectors.
diff --git a/examples/features/standard/topic-selector2/readme.md
b/examples/features/standard/topic-selector2/readme.md
index 01b7e6a..bbf5526 100644
--- a/examples/features/standard/topic-selector2/readme.md
+++ b/examples/features/standard/topic-selector2/readme.md
@@ -1,5 +1,7 @@
# JMS Topic Selector Example 2
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to selectively consume messages using message
selectors with topic consumers.
diff --git a/examples/features/standard/topic/readme.md
b/examples/features/standard/topic/readme.md
index ecdb65f..83de1e8 100644
--- a/examples/features/standard/topic/readme.md
+++ b/examples/features/standard/topic/readme.md
@@ -1,5 +1,7 @@
# JMS Topic Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to send and receive a message to a JMS Topic with
ActiveMQ Artemis.
diff --git a/examples/features/standard/transactional/readme.md
b/examples/features/standard/transactional/readme.md
index a256f3f..4df51c4 100644
--- a/examples/features/standard/transactional/readme.md
+++ b/examples/features/standard/transactional/readme.md
@@ -1,5 +1,7 @@
# JMS Transactional Session Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to use a transacted Session with ActiveMQ Artemis.
diff --git a/examples/features/standard/xa-heuristic/readme.md
b/examples/features/standard/xa-heuristic/readme.md
index 1b91133..c23b6f5 100644
--- a/examples/features/standard/xa-heuristic/readme.md
+++ b/examples/features/standard/xa-heuristic/readme.md
@@ -1,5 +1,7 @@
# JMS XA Heuristic Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to make an XA heuristic decision through the
ActiveMQ Artemis Management Interface.
diff --git a/examples/features/standard/xa-receive/readme.md
b/examples/features/standard/xa-receive/readme.md
index 5c41053..f45d5d3 100644
--- a/examples/features/standard/xa-receive/readme.md
+++ b/examples/features/standard/xa-receive/readme.md
@@ -1,5 +1,7 @@
# JMS XA Receive Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example demonstrates receiving a message within the scope of an XA
transaction. When using an XA transaction the message will only be acknowledged
and removed from the queue when the transaction is committed. If the
transaction is not committed the message maybe redelivered after rollback or
during XA recovery.
diff --git a/examples/features/standard/xa-send/readme.md
b/examples/features/standard/xa-send/readme.md
index baa35c6..08ee57c 100644
--- a/examples/features/standard/xa-send/readme.md
+++ b/examples/features/standard/xa-send/readme.md
@@ -1,5 +1,7 @@
# JMS XA Send Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how message sending behaves in an XA transaction in
ActiveMQ Artemis. When a message is sent within the scope of an XA transaction,
it will only reach the queue once the transaction is committed. If the
transaction is rolled back the sent messages will be discarded by the server.
diff --git
a/examples/features/sub-modules/inter-broker-bridge/artemis-jms-bridge/readme.md
b/examples/features/sub-modules/inter-broker-bridge/artemis-jms-bridge/readme.md
index 28e999a..cdf9cab 100644
---
a/examples/features/sub-modules/inter-broker-bridge/artemis-jms-bridge/readme.md
+++
b/examples/features/sub-modules/inter-broker-bridge/artemis-jms-bridge/readme.md
@@ -15,9 +15,9 @@ This example however is just focusing on integration with 5.x.
##Preparing
-1) From the root dir run `mvn clean package`.
+1) From this directory run `mvn clean package`.
-2) Copy artemis-jms-bridge/target/artemis-jms-bridge-<version>.war to the web
directory of the Artemis installation.
+2) Copy target/artemis-jms-bridge-<version>.war to the `web` sub-directory of
the Artemis installation.
3) Create an instance of the Artemis broker `$ARTEMIS_HOME/bin/artemis create
--allow-anonymous myBroker`
@@ -33,7 +33,7 @@ This example however is just focusing on integration with 5.x.
5) Edit `$ARTEMIS_INSTANCE/etc/bootstrap.xml` and add the war file.
```xml
-<app url="bridge" war="artemis-jms-bridge-<version>.war"/>
+<app name="bridge" url="bridge" war="artemis-jms-bridge-<version>.war"/>
```
##Testing
diff --git a/examples/protocols/amqp/queue/readme.md
b/examples/protocols/amqp/queue/readme.md
index 9b34e7e..8b77680 100644
--- a/examples/protocols/amqp/queue/readme.md
+++ b/examples/protocols/amqp/queue/readme.md
@@ -1,17 +1,11 @@
-# Proton qpid java example
+# AMQP / Qpid JMS Queue example
-To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
-
-ActiveMQ Artemis is a multi protocol broker. It will inspect the initial
handshake of clients to determine what protocol to use.
-
-All you need to do is to connect a client into activemq's configured port and
you should be able connect.
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
-To run this example simply run the command **mvn verify -Pexample**, execute
the `compile.sh` script and start the executable called `./hello`.
-
-You don't need to do anything special to configure the ActiveMQ Artemis broker
to accept AMQP clients.
+To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
-Just for the sake of documentation though we are setting the port of ActiveMQ
Artemis on this example as 5672 which is the port qpid have by default.
+This example uses the Qpid JMS AMQP 1.0 client to send a message to a queue
and then recieve it. The example connects to port 5672, the IANA registered
AMQP port.
-This is totally optional and you don't need to follow this convention. You can
use any port you chose including ActiveMQ's 61616 default port
+Artemis listens for AMQP connections on port 5672 by default, and additionally
on its default multi-protocol acceptor for port 61616, where it inspects the
initial handshake of clients to determine what protocol to use.
- <acceptor name="proton-acceptor">tcp://localhost:5672</acceptor>
\ No newline at end of file
+ <acceptor name="amqp">tcp://0.0.0.0:5672?protocols=AMQP</acceptor>
diff --git a/examples/protocols/amqp/sasl-scram/readme.md
b/examples/protocols/amqp/sasl-scram/readme.md
index d9570da..6f5857b 100644
--- a/examples/protocols/amqp/sasl-scram/readme.md
+++ b/examples/protocols/amqp/sasl-scram/readme.md
@@ -1,10 +1,12 @@
-# Artemis SASL-SCRAM Server and Client Example
+# Artemis SCRAM-SHA SASL Example
-Demonstrates the usage of SASL-SCRAM authentication with ActiveMQ Artemis
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify**
if you want to start and create the broker manually.
+This example demonstrates the usage of SCRAM-SHA SASL authentication with
ActiveMQ Artemis and AMQP clients.
+
Of note is the AMQP acceptor configuration restricting the offered mechanisms
to SCRAM-SHA-256, and the reference
to the login config scope ``amqp-sasl-scram`` that holds the relevant SCRAM
login module.
diff --git a/examples/protocols/mqtt/clustered-queue-mqtt/readme.md
b/examples/protocols/mqtt/clustered-queue-mqtt/readme.md
index eb714f9..204ef5a 100644
--- a/examples/protocols/mqtt/clustered-queue-mqtt/readme.md
+++ b/examples/protocols/mqtt/clustered-queue-mqtt/readme.md
@@ -1,5 +1,7 @@
# MQTT Clustered Subscription Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example demonstrates a queue deployed on two different nodes. The two
nodes are configured to form a cluster.
diff --git a/examples/protocols/mqtt/publish-subscribe/readme.md
b/examples/protocols/mqtt/publish-subscribe/readme.md
index 75cd36f..88c86f5 100644
--- a/examples/protocols/mqtt/publish-subscribe/readme.md
+++ b/examples/protocols/mqtt/publish-subscribe/readme.md
@@ -1,5 +1,9 @@
# MQTT Publish/Subscribe Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
+To run the example, simply type **mvn verify** from this directory.
+
This is a basic MQTT example that demonstrates how to setup and connect to an
Apache Artemis broker and send and receive messages using the MQTT protocol.
## Setting up the Broker
diff --git a/examples/protocols/openwire/chat/readme.md
b/examples/protocols/openwire/chat/readme.md
index 42bf00e..b5bdc84 100644
--- a/examples/protocols/openwire/chat/readme.md
+++ b/examples/protocols/openwire/chat/readme.md
@@ -1,5 +1,7 @@
# Openwire Chat Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
This example will require multiple windows to be executed
Window 1:
diff --git a/examples/protocols/openwire/message-listener/readme.md
b/examples/protocols/openwire/message-listener/readme.md
index b82e6f7..118227f 100644
--- a/examples/protocols/openwire/message-listener/readme.md
+++ b/examples/protocols/openwire/message-listener/readme.md
@@ -1,5 +1,7 @@
# OpenWire JMS Message Listener Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows how to use a MessageListener with the OpenWire client.
\ No newline at end of file
diff --git a/examples/protocols/openwire/message-recovery/readme.md
b/examples/protocols/openwire/message-recovery/readme.md
index 0df251c..8e7556f 100644
--- a/examples/protocols/openwire/message-recovery/readme.md
+++ b/examples/protocols/openwire/message-recovery/readme.md
@@ -1,5 +1,9 @@
# OpenWire JMS Message Recovery Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
+To run the example, simply type **mvn verify** from this directory.
+
This example will start and stop the broker within the example.
This example shows how to use send messages to a queue and having these
messages recovered from the journal when the broker is restarted.
\ No newline at end of file
diff --git a/examples/protocols/openwire/queue/readme.md
b/examples/protocols/openwire/queue/readme.md
index 7f4f0b9..605765a 100644
--- a/examples/protocols/openwire/queue/readme.md
+++ b/examples/protocols/openwire/queue/readme.md
@@ -1,5 +1,7 @@
# OpenWire JMS Queue Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to send and receive a message to a JMS queue using
ActiveMQ Artemis.
diff --git a/examples/protocols/openwire/virtual-topic-mapping/readme.md
b/examples/protocols/openwire/virtual-topic-mapping/readme.md
index 4660492..b75fcbd 100644
--- a/examples/protocols/openwire/virtual-topic-mapping/readme.md
+++ b/examples/protocols/openwire/virtual-topic-mapping/readme.md
@@ -1,5 +1,7 @@
# OpenWire Virtual Topic Mapping Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start
and create the broker manually.
diff --git a/examples/protocols/stomp/stomp-dual-authentication/readme.md
b/examples/protocols/stomp/stomp-dual-authentication/readme.md
index d8b95b8..1ca5adb 100644
--- a/examples/protocols/stomp/stomp-dual-authentication/readme.md
+++ b/examples/protocols/stomp/stomp-dual-authentication/readme.md
@@ -1,5 +1,7 @@
# Stomp Dual Authentication Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to configure 2-way SSL along with 2 different
authentications mechanisms so that SSL and non-SSL clients can send and consume
messages to/from ActiveMQ Artemis. The non-SSL authentication mechanism simply
uses username and password. The SSL authentication mechanism uses the client's
certificate. The Stomp client uses SSL socket directly to send a message. Then
a JMS client will use a non-SSL connection to consume it.
diff --git a/examples/protocols/stomp/stomp-embedded-interceptor/readme.md
b/examples/protocols/stomp/stomp-embedded-interceptor/readme.md
index ade1b8e..cd434aa 100644
--- a/examples/protocols/stomp/stomp-embedded-interceptor/readme.md
+++ b/examples/protocols/stomp/stomp-embedded-interceptor/readme.md
@@ -1,5 +1,7 @@
# Stomp Embedded Interceptor Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify -Pexample** from this directory.
This example shows you how to configure ActiveMQ Artemis to intercept received
Stomp messages.
diff --git a/examples/protocols/stomp/stomp-jms/readme.md
b/examples/protocols/stomp/stomp-jms/readme.md
index 378f0b5..96bdb78 100644
--- a/examples/protocols/stomp/stomp-jms/readme.md
+++ b/examples/protocols/stomp/stomp-jms/readme.md
@@ -1,5 +1,7 @@
# Stomp 1.2 Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to configure ActiveMQ Artemis to send and receive
Stomp messages using Stomp 1.2 protocol via the JMS API using the
[stomp-jms](https://github.com/fusesource/stompjms) client.
\ No newline at end of file
diff --git a/examples/protocols/stomp/stomp-websockets/readme.md
b/examples/protocols/stomp/stomp-websockets/readme.md
index bb26122..560b078 100644
--- a/examples/protocols/stomp/stomp-websockets/readme.md
+++ b/examples/protocols/stomp/stomp-websockets/readme.md
@@ -1,5 +1,7 @@
# Stomp WebSockets Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to configure ActiveMQ Artemis to send and receive
Stomp messages from modern web browser using Web Sockets.
diff --git a/examples/protocols/stomp/stomp/readme.md
b/examples/protocols/stomp/stomp/readme.md
index 18ced1e..100e0c7 100644
--- a/examples/protocols/stomp/stomp/readme.md
+++ b/examples/protocols/stomp/stomp/readme.md
@@ -1,5 +1,7 @@
# Stomp Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to configure ActiveMQ Artemis to send and receive
Stomp messages.
diff --git a/examples/protocols/stomp/stomp1.1/readme.md
b/examples/protocols/stomp/stomp1.1/readme.md
index 37d23af..2b9c3c4 100644
--- a/examples/protocols/stomp/stomp1.1/readme.md
+++ b/examples/protocols/stomp/stomp1.1/readme.md
@@ -1,5 +1,7 @@
# Stomp 1.1 Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to configure ActiveMQ Artemis to send and receive
Stomp messages using Stomp 1.1 protocol.
diff --git a/examples/protocols/stomp/stomp1.2/readme.md
b/examples/protocols/stomp/stomp1.2/readme.md
index 36c2801..0f6d013 100644
--- a/examples/protocols/stomp/stomp1.2/readme.md
+++ b/examples/protocols/stomp/stomp1.2/readme.md
@@ -1,5 +1,7 @@
# Stomp 1.2 Example
+If you have not already done so, [prepare the broker
distribution](../../../../README.md#getting-started) before running the example.
+
To run the example, simply type **mvn verify** from this directory, or **mvn
-PnoServer verify** if you want to start and create the broker manually.
This example shows you how to configure ActiveMQ Artemis to send and receive
Stomp messages using Stomp 1.2 protocol.
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
For further information, visit: https://activemq.apache.org/contact
