Clustering support for MessageBus

• Type: Improvement
• Status: Closed
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: 5.1 EE SP3 (5.1.6), 5.2 EE SP1 (5.2.5)
• Fix Version/s: 5.1 EE SP4 (5.1.7), 5.2 EE SP2 (5.2.6)
• Component/s: Fault Tolerance > Clustering Framework, Legacy Components > API
• Labels:
  • 5.2_release_notes
• Environment: All

This improvement adds support for clustered environment with the message bus. To enable this feature, the following properties in portal(-ext).properties must be configured.

##

1. 1. Cluster Link
      ##

2. Set the JGroups properties for each channel, we support up to 10
3. channels. Use as few channels as possible for best performance. By
4. default, only one UPD channel is enabled. Channels can be configured by
5. XML files that are located in the class path or by inline properties.
   #
   cluster.link.channel.properties.0=udp.xml
   #cluster.link.channel.properties.1=UDP(bind_addr=lcoalhost;mcast_addr=239.0.0.1;mcast_port=23901;ip_ttl=8;mcast_send_buf_size=150000;mcast_recv_buf_size=80000):PING(timeout=2000;num_initial_members=3):MERGE2(min_interval=5000;max_interval=10000):FD_SOCK:VERIFY_SUSPECT(timeout=1500):pbcast.NAKACK(gc_lag=50;retransmit_timeout=300,600,1200,2400,4800;max_xmit_size=8192):UNICAST(timeout=300,600,1200,2400):pbcast.STABLE(desired_avg_gossip=20000):FRAG(frag_size=8096;down_thread=false;up_thread=false):pbcast.GMS(join_timeout=5000;join_retry_timeout=2000;shun=false;print_local_addr=true)
   #cluster.link.channel.properties.2=mping.xml

#

1. Set JGroups' system properties. System properties have higher priority
2. than individual properties given to each channel. That means system
3. properties will override individual properties.
   #
   cluster.link.channel.system.properties=\
   #
4. Common
   #
   \
   jgroups.bind_addr:localhost,\
   jgroups.bind_interface:eth0,\
   \
   #
5. UDP
   #
   \
   jgroups.udp.mcast_addr:239.0.0.1,\
   jgroups.udp.mcast_port:23901,\
   jgroups.udp.ip_ttl:8,\
   \
   #
6. Multicast
   #
   \
   jgroups.mping.mcast_addr:239.0.0.2,\
   jgroups.mping.mcast_port:23902,\
   jgroups.mping.ip_ttl:8,\
   \
   #
7. TCP
   #
   \
   jgroups.tcpping.initial_hosts:localhost[7800],localhost[7801]

#

1. Set this property to autodetect the default outgoing IP address so that
2. JGroups can bind to it. The property must point to an address that is
3. accessible to the portal server, www.google.com or your local gateway.
   #
   cluster.link.autodetect.address=www.google.com:80

In addition, if you're using 5.1.7, META-INF/cluster-spring.xml must be added to the spring.configs property.
5.2.6 users can add the following property instead:
cluster.link.enabled=true