Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 1089298

Summary:	[Doc Feature] Chapter on Clusters should be added to HornetQ documentation
Product:	[JBoss] JBoss Enterprise Application Platform 6	Reporter:	Martin Svehla <msvehla>
Component:	Documentation	Assignee:	Nidhi <nsriniva>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Martin Svehla <msvehla>
Severity:	high	Docs Contact:	Nidhi <nsriniva>
Priority:	unspecified
Version:	6.3.0	CC:	apestel, mnovak, msvehla, nsriniva, nziakova, smumford, twells
Target Milestone:	GA	Keywords:	Documentation, FutureFeature
Target Release:	EAP 6.3.0
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Enhancement
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2014-06-28 15:43:31 UTC	Type:	Enhancement
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Martin Svehla 2014-04-18 12:28:19 UTC

The chapter should contain at least:
- configuration of broadcast group, discovery group and cluster connections
- server-side load balancing
- working with jgroups

Comment 1 Martin Svehla 2014-05-20 06:58:30 UTC

Here's link to upstream documentation on HornetQ clustering: http://docs.jboss.org/hornetq/2.3.0.Final/docs/user-manual/html/clusters.html

Comment 6 Miroslav Novak 2014-06-16 09:13:41 UTC

Hi Nidhi,

there is one more issue in configuration of clustering using JGroups. For broadcast group there should be:

                <broadcast-groups>
                    <broadcast-group name="bg-group1">
                        <jgroups-stack>udp</jgroups-stack>
                        <jgroups-channel>udp</jgroups-channel>
                        <broadcast-period>2000</broadcast-period>
                        <connector-ref>
                            netty
                        </connector-ref>
                    </broadcast-group>
                </broadcast-groups>

and for discovery group:
                <discovery-groups>
                    <discovery-group name="dg-group1">
                        <jgroups-stack>udp</jgroups-stack>
                        <jgroups-channel>udp</jgroups-channel>
                        <refresh-timeout>10000</refresh-timeout>
                    </discovery-group>
                </discovery-groups>

Attribute jgroups-stack - The name of a stack defined in the org.jboss.as.clustering.jgroups subsystem.

Attribute jgroups-file cannot be set in EAP 6 and all occurrences (paragraphs) must be removed.

For HornetQ in EAP we don't support chain cluster topology. I'd like to remove it from doc from chapter - 19.5.1. About Server Side Load Balancing:
Chain cluster: In a chain cluster, each node in the cluster is not connected to every node in the cluster directly. Here the nodes form a chain with a node on each end of the chain and all other nodes only connect to the previous and next nodes in the chain. To create a chain cluster, node A would define a cluster connection that connects to node B, and node B would define a cluster connection that connects to node C. The messages will move from node A>B>C in this case. The attribute max-hops is set to 2. 

Thanks,
Mirek

Comment 11 Martin Svehla 2014-06-20 08:41:57 UTC

Thanks Nidhi

Comment 12 Nidhi 2014-07-15 07:00:08 UTC

*** Bug 970409 has been marked as a duplicate of this bug. ***

Comment 13 Nidhi 2014-07-15 08:57:18 UTC

*** Bug 1012469 has been marked as a duplicate of this bug. ***

Comment 14 Nidhi 2014-08-04 10:37:30 UTC

*** Bug 1029494 has been marked as a duplicate of this bug. ***