updating documentation on RELAY

doc/manual/en/images/RELAY.fig

@@ -0,0 +1,74 @@
+#FIG 3.2  Produced by xfig version 3.2.5
+Landscape
+Center
+Inches
+Letter  
+100.00
+Single
+-2
+1200 2
+6 3375 4800 6375 9075
+2 2 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 5
+	 3375 4800 6375 4800 6375 9075 3375 9075 3375 4800
+2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 2
+	 3375 5400 6375 5400
+2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 2
+	 3375 6000 6375 6000
+2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 2
+	 3375 6675 6375 6675
+2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 2
+	 3375 7350 6375 7350
+2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 2
+	 3375 8025 6375 8025
+2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 2
+	 3375 8550 6375 8550
+4 0 0 50 -1 16 16 0.0000 4 195 885 4425 5175 RELAY\001
+-6
+6 1575 825 4575 4200
+6 3750 1950 4350 2550
+1 3 0 1 0 7 50 -1 -1 0.000 1 0.0000 4050 2250 270 270 4050 2250 4200 2475
+4 0 0 50 -1 16 16 0.0000 4 195 180 3975 2400 A\001
+-6
+6 2100 1500 2700 2100
+1 3 0 1 0 7 50 -1 -1 0.000 1 0.0000 2400 1800 270 270 2400 1800 2550 2025
+4 0 0 50 -1 16 16 0.0000 4 195 195 2325 1875 C\001
+-6
+6 2475 2850 3075 3450
+1 3 0 1 0 7 50 -1 -1 0.000 1 0.0000 2775 3150 270 270 2775 3150 2925 3375
+4 0 0 50 -1 16 16 0.0000 4 195 180 2700 3225 B\001
+-6
+1 3 0 1 0 7 50 -1 -1 0.000 1 0.0000 3069 2364 1479 1479 3069 2364 4344 3114
+4 0 0 50 -1 16 16 0.0000 4 240 450 2850 4125 udp\001
+-6
+6 10125 2700 10725 3300
+1 3 0 1 0 7 50 -1 -1 0.000 1 0.0000 10425 3000 270 270 10425 3000 10575 3225
+4 0 0 50 -1 16 16 0.0000 4 195 165 10350 3075 F\001
+-6
+6 10200 1200 10800 1800
+1 3 0 1 0 7 50 -1 -1 0.000 1 0.0000 10500 1500 270 270 10500 1500 10650 1725
+4 0 0 50 -1 16 16 0.0000 4 195 180 10425 1650 E\001
+-6
+6 8700 1950 9300 2550
+1 3 0 1 0 7 50 -1 -1 0.000 1 0.0000 9000 2250 270 270 9000 2250 9150 2475
+4 0 0 50 -1 16 16 0.0000 4 195 195 8925 2325 D\001
+-6
+1 3 0 1 0 7 50 -1 -1 0.000 1 0.0000 9969 2289 1479 1479 9969 2289 11244 3039
+2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 0 0 2
+	 2175 9450 8400 9450
+2 1 0 2 0 7 50 -1 -1 0.000 0 0 7 1 0 2
+	1 1 4.00 60.00 120.00
+	 5475 9450 5475 4050
+2 1 0 2 0 7 50 -1 -1 0.000 0 0 7 1 0 2
+	1 1 4.00 60.00 120.00
+	 5475 5175 7425 5175
+2 4 0 3 0 7 50 -1 -1 0.000 0 0 7 0 0 5
+	 9525 2925 3600 2925 3600 1950 9525 1950 9525 2925
+4 0 0 50 -1 18 18 0.0000 4 225 2445 1800 600 Data Center NYC\001
+4 0 0 50 -1 18 18 0.0000 4 225 2415 8775 525 Data Center SFO\001
+4 0 0 50 -1 16 16 0.0000 4 195 990 7350 9300 Network\001
+4 0 0 50 -1 16 16 0.0000 4 255 3465 6525 5025 Relaying to other data center\001
+4 0 0 50 -1 16 16 0.0000 4 240 1320 4875 3900 Application\001
+4 0 0 50 -1 16 16 0.0000 4 210 360 6300 2325 tcp\001
+4 0 0 50 -1 16 16 0.0000 4 240 450 9750 4050 udp\001
+4 0 0 50 -1 2 18 0.0000 4 195 225 3975 2850 X\001
+4 0 0 50 -1 2 18 0.0000 4 195 225 8925 2850 Y\001

doc/manual/en/modules/advanced.xml

@@ -1590,16 +1590,33 @@
             </section>
 
         </section>
+    </section>
 
-        <section>
-            <title>Ergonomics</title>
-            <para>
-                Ergonomics is similar to the dynamic setting of optimal values for the JVM, e.g. garbage collection,
-                memory sizes etc. In JGroups, ergonomics means that we try to dynamically determine and set optimal
-                values for protocol properties. Examples are thread pool size, flow control credits, heartbeat
-                frequency and so on.
+    <section>
+        <title>Bridging remote clusters</title>
+        <para>
+            In 2.12, the RELAY protocol was added to JGroups. It allows for bridging of remote clusters. For example, if
+            we have a cluster in New York (NYC) and another one in San Francisco (SFO), then RELAY allows us to bridge
+            NYC and SFO, so that multicast messages sent in NYC will be forwarded to SFO and vice versa.
+        </para>
+        <para>
+            The NYC and SFO clusters could for example use IP multicasting (UDP as transport), and the bridge could use
+            TCP as transport. The SFO and NYC clusters don't even need to be named the same.
+        </para>
+        <para>
+            <figure id="RelayFig"><title>Relaying between different clusters</title>
+                <graphic fileref="images/RELAY.png" format="PNG" align="left" width="15cm"/>
+            </figure>
             </para>
-        </section>
+    </section>
 
+    <section>
+        <title>Ergonomics</title>
+        <para>
+            Ergonomics is similar to the dynamic setting of optimal values for the JVM, e.g. garbage collection,
+            memory sizes etc. In JGroups, ergonomics means that we try to dynamically determine and set optimal
+            values for protocol properties. Examples are thread pool size, flow control credits, heartbeat
+            frequency and so on.
+        </para>
     </section>
 </chapter>