renamed star mirror as mesh mirror, added diagram

With the help of Claude that setup the diagram

Author: clebertsuconic

…/ha-with-star-mirror/clients-layout.conf …/ha-with-mesh-mirror/clients-layout.confexamples/features/broker-connection/ha-with-star-mirror/clients-layout.conf renamed to examples/features/broker-connection/ha-with-mesh-mirror/clients-layout.conf examples/features/broker-connection/ha-with-star-mirror/clients-layout.conf renamed to examples/features/broker-connection/ha-with-mesh-mirror/clients-layout.conf

@@ -27,9 +27,9 @@ under the License.
       <version>2.54.0-SNAPSHOT</version>
    </parent>
 
-   <artifactId>ha-with-star-mirror</artifactId>
+   <artifactId>ha-with-mesh-mirror</artifactId>
    <packaging>jar</packaging>
-   <name>Apache Artemis Example - HA with Star Mirror</name>
+   <name>Apache Artemis Example - HA with Mesh Mirror</name>
 
    <properties>
       <activemq.basedir>${project.basedir}/../../../..</activemq.basedir>
@@ -129,7 +129,7 @@ under the License.
                   <dependencies>
                      <dependency>
                         <groupId>org.apache.artemis.examples.broker-connection</groupId>
-                        <artifactId>ha-with-star-mirror</artifactId>
+                        <artifactId>ha-with-mesh-mirror</artifactId>
                         <version>${project.version}</version>
                      </dependency>
                   </dependencies>
@@ -188,7 +188,7 @@ under the License.
                            <goal>runClient</goal>
                         </goals>
                         <configuration>
-                           <clientClass>org.apache.artemis.jms.example.HAWithStarMirrorExample</clientClass>
+                           <clientClass>org.apache.artemis.jms.example.HAWithMeshMirrorExample</clientClass>
                            <args>
                               <param>${basedir}/target/server0</param>
                               <param>${basedir}/target/server1</param>
@@ -200,7 +200,7 @@ under the License.
                   <dependencies>
                      <dependency>
                         <groupId>org.apache.artemis.examples.broker-connection</groupId>
-                        <artifactId>ha-with-star-mirror</artifactId>
+                        <artifactId>ha-with-mesh-mirror</artifactId>
                         <version>${project.version}</version>
                      </dependency>
                   </dependencies>
@@ -233,7 +233,7 @@ under the License.
                   <dependencies>
                      <dependency>
                         <groupId>org.apache.artemis.examples.broker-connection</groupId>
-                        <artifactId>ha-with-star-mirror</artifactId>
+                        <artifactId>ha-with-mesh-mirror</artifactId>
                         <version>${project.version}</version>
                      </dependency>
                   </dependencies>
@@ -262,7 +262,7 @@ under the License.
                   <dependencies>
                      <dependency>
                         <groupId>org.apache.artemis.examples.broker-connection</groupId>
-                        <artifactId>ha-with-star-mirror</artifactId>
+                        <artifactId>ha-with-mesh-mirror</artifactId>
                         <version>${project.version}</version>
                      </dependency>
                   </dependencies>
@@ -291,7 +291,7 @@ under the License.
                   <dependencies>
                      <dependency>
                         <groupId>org.apache.artemis.examples.broker-connection</groupId>
-                        <artifactId>ha-with-star-mirror</artifactId>
+                        <artifactId>ha-with-mesh-mirror</artifactId>
                         <version>${project.version}</version>
                      </dependency>
                   </dependencies>

…r-connection/ha-with-star-mirror/pom.xml …r-connection/ha-with-mesh-mirror/pom.xmlexamples/features/broker-connection/ha-with-star-mirror/pom.xml renamed to examples/features/broker-connection/ha-with-mesh-mirror/pom.xml examples/features/broker-connection/ha-with-star-mirror/pom.xml renamed to examples/features/broker-connection/ha-with-mesh-mirror/pom.xml

@@ -1,18 +1,28 @@
-# High Availability with Star Mirror and Distributed Locks
+# High Availability with Mesh Mirror and Distributed Locks
 
-This example demonstrates how to achieve high availability (HA) using star topology mirroring combined with distributed locks from the Lock Coordinator feature. The distributed locks ensure that only one broker accepts client connections at a time, providing automatic failover without split-brain scenarios across three brokers.
+This example demonstrates how to achieve high availability (HA) using mesh topology mirroring combined with distributed locks from the Lock Coordinator feature. The distributed locks ensure that only one broker accepts client connections at a time, providing automatic failover without split-brain scenarios across three brokers.
 
 ## Overview
 
 This example configures three brokers (server0, server1, and server2) that:
-- Mirror all messaging operations to each other using broker connections in a star topology
+- Mirror all messaging operations to each other using broker connections in a mesh topology
 - Share a distributed file-based lock to coordinate which broker accepts client connections
 - Automatically failover client connections when the active broker fails
 - Use lock coordinator on broker connections to ensure mirroring only happens when the broker is active
 
+## Topology Diagram
+
+![Mesh Topology](src/main/resources/images/mesh-topology.svg)
+
+**Key Points:**
+- Only Server 0 (holding the lock) actively mirrors data to Server 1 and Server 2 (solid blue arrows)
+- Server 1 and Server 2 have passive broker connections (dashed gray arrows - not actively mirroring)
+- When Server 0 fails, Server 1 or Server 2 acquires the lock and becomes active
+- The new active server's connections become active and start mirroring
+
 ## How It Works
 
-### Star Topology Mirroring Configuration
+### Mesh Topology Mirroring Configuration
 
 All three brokers are configured with mirroring to the other two brokers using AMQP broker connections. The key feature is using the **lock-coordinator attribute on broker connections**, which ensures that mirroring only happens when the broker holding the lock is active.
 
@@ -54,7 +64,7 @@ All three brokers are configured with mirroring to the other two brokers using A
 </broker-connections>
 ```
 
-This ensures that messages, queues, and other operations are replicated across all three brokers in a star topology.
+This ensures that messages, queues, and other operations are replicated across all three brokers in a mesh topology.
 
 ### Lock Coordinator for HA
 
@@ -64,7 +74,7 @@ The key feature of this example is the use of **distributed locks** to control w
 <lock-coordinators>
    <lock-coordinator name="clients-lock">
       <class-name>org.apache.activemq.artemis.lockmanager.file.FileBasedLockManager</class-name>
-      <lock-id>star-mirror-cluster-clients</lock-id>
+      <lock-id>mesh-mirror-cluster-clients</lock-id>
       <check-period>1000</check-period>
       <properties>
          <property key="locks-folder" value="/path/to/shared/locks"/>
@@ -97,7 +107,7 @@ When the active broker (holding the lock) fails:
 1. The lock is automatically released
 2. One of the backup brokers acquires the lock and starts accepting connections
 3. The client automatically reconnects to the now-active broker
-4. All messages are available due to star mirroring
+4. All messages are available due to mesh mirroring
 
 ## Setup
 
@@ -107,7 +117,7 @@ You have the following options to run this example:
 
 ### Non-interactive way
 
-You can run this example in a non-interactive way, with HAWithStarMirrorExample starting, stopping the servers, and consume messages from your servers during failover.
+You can run this example in a non-interactive way, with HAWithMeshMirrorExample starting, stopping the servers, and consume messages from your servers during failover.
 
 ```shell
 mvn verify -Pautomated
@@ -206,7 +216,7 @@ To observe the high availability in action:
 
 ## Example Flow
 
-1. All three brokers start with star mirroring configured
+1. All three brokers start with mesh mirroring configured
 2. One broker (typically server0) acquires the distributed lock and accepts client connections
 3. The client connects and sends 30 messages to a queue
 4. Server0 is killed (simulating a failure)
@@ -220,7 +230,7 @@ The lock coordinator supports different lock types (file-based, ZooKeeper). This
 
 The `check-period` parameter (in milliseconds) controls how frequently the lock holder verifies it still owns the lock, affecting how quickly failover occurs when a broker crashes.
 
-**Important:** This example demonstrates the star topology with lock coordinator on broker connections. Unlike the dual mirror example, the lock-coordinator attribute is specified on the broker connections themselves, ensuring that mirroring only occurs when a broker holds the lock. This prevents multiple brokers from simultaneously trying to mirror to each other when they don't have the client lock.
+**Important:** This example demonstrates the mesh topology with lock coordinator on broker connections. Unlike the dual mirror example, the lock-coordinator attribute is specified on the broker connections themselves, ensuring that mirroring only occurs when a broker holds the lock. This prevents multiple brokers from simultaneously trying to mirror to each other when they don't have the client lock.
 
 ## Change the configuration to ZooKeeper
 
@@ -230,7 +240,7 @@ If you want to try ZooKeeper, you need to change the lock-coordinator configurat
 <lock-coordinators>
    <lock-coordinator name="clients-lock">
       <class-name>org.apache.activemq.artemis.lockmanager.zookeeper.CuratorDistributedLockManager</class-name>
-      <lock-id>star-mirror-cluster-clients</lock-id>
+      <lock-id>mesh-mirror-cluster-clients</lock-id>
       <check-period>1000</check-period>
 
       <properties>

…connection/ha-with-star-mirror/readme.md …connection/ha-with-mesh-mirror/readme.mdexamples/features/broker-connection/ha-with-star-mirror/readme.md renamed to examples/features/broker-connection/ha-with-mesh-mirror/readme.md examples/features/broker-connection/ha-with-star-mirror/readme.md renamed to examples/features/broker-connection/ha-with-mesh-mirror/readme.md

@@ -21,6 +21,6 @@
  */
 public class CreateServers {
    public static void main(final String[] args) throws Exception {
-      HAWithStarMirrorExample.configureLocksFolder(args);
+      HAWithMeshMirrorExample.configureLocksFolder(args);
    }
 }

…on/ha-with-star-mirror/screen-clients.sh …on/ha-with-mesh-mirror/screen-clients.shexamples/features/broker-connection/ha-with-star-mirror/screen-clients.sh renamed to examples/features/broker-connection/ha-with-mesh-mirror/screen-clients.sh examples/features/broker-connection/ha-with-star-mirror/screen-clients.sh renamed to examples/features/broker-connection/ha-with-mesh-mirror/screen-clients.sh

@@ -30,9 +30,9 @@
 import org.apache.activemq.artemis.utils.FileUtil;
 
 /**
- * Example of star topology mirroring with three servers using lock coordinator on broker connections
+ * Example of mesh topology mirroring with three servers using lock coordinator on broker connections
  */
-public class HAWithStarMirrorExample {
+public class HAWithMeshMirrorExample {
 
    private static Process server0;
 
@@ -51,11 +51,11 @@ public static void main(final String[] args) throws Exception {
       try {
 
          // Start the three servers
-         server0 = ServerUtil.startServer(args[0], HAWithStarMirrorExample.class.getSimpleName() + "-peer0", 0, 0);
+         server0 = ServerUtil.startServer(args[0], HAWithMeshMirrorExample.class.getSimpleName() + "-peer0", 0, 0);
          Thread.sleep(2_000);
-         server1 = ServerUtil.startServer(args[1], HAWithStarMirrorExample.class.getSimpleName() + "-peer1", 1, 0);
+         server1 = ServerUtil.startServer(args[1], HAWithMeshMirrorExample.class.getSimpleName() + "-peer1", 1, 0);
          Thread.sleep(2_000);
-         server2 = ServerUtil.startServer(args[2], HAWithStarMirrorExample.class.getSimpleName() + "-peer2", 2, 0);
+         server2 = ServerUtil.startServer(args[2], HAWithMeshMirrorExample.class.getSimpleName() + "-peer2", 2, 0);
 
          // We connect to the broker holding the lock on the distributed lock
          ConnectionFactory factory = new org.apache.qpid.jms.JmsConnectionFactory(