Bug 1017239

Summary: [Doc Bug Fix] mod_cluster and clustering configuration mixed up together
Product: [JBoss] JBoss Enterprise Application Platform 6 Reporter: Michal Karm Babacek <mbabacek>
Component: DocumentationAssignee: Nidhi <nchaudha>
Status: CLOSED DEFERRED QA Contact: Michal Karm Babacek <mbabacek>
Severity: high Docs Contact: Russell Dickenson <rdickens>
Priority: unspecified    
Version: 6.2.0CC: anrobert, bperkins, dmichael, mbabacek, nchaudha, nziakova, rhatlapa, smumford
Target Milestone: post-GAKeywords: Documentation, Triaged
Target Release: EAP 6.4.2   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2015-10-27 20:20:12 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Michal Karm Babacek 2013-10-09 13:24:06 UTC
Hi guys,

if you take a look at Procedure 16.7. Configure a Worker Node,
you might notice that it seamlessly blends to clustering configuration.
It is not wrong per se, yes, one might carry out the steps mentioned, yet, it has little to do with mod_cluster as such.

It is actually a clustering configuration, technically absolutely unrelated to mod_cluster. As soon as you configure mod_cluster subsystem, it's ready. No need for any clustering configuration stuff.

It must be clear to the customer that:

1) As soon as you configure the mod_cluster subsystem in Jboss EAP 6 instance and mod_cluster module on Apache HTTP Server instance, you are ready to go with load balancing. No matter whether you are using standalone not clustered servers, clustered standalone servers, not clustered domain managed hosts, clustered domain managed hosts...

2) If you want to have session data replicated among cluster nodes, you must configure clustering subsystem. The default of standalone-ha, standalone-full-ha, or in domain, ha or full-ha profiles is good enough for start (provided you have <distributable/> element within your web.xml in your webapp you want to have replicated).



TL;DR: mod_cluster subsystem and clustering subsystem configurations are _absolutely_ unrelated and _not depending_ on each other. Luring the customer into thinking otherwise is confusing.

HTH
-M-

Comment 1 Michal Karm Babacek 2014-11-06 13:43:41 UTC
Dear Doc guys, could you look into it please?

Comment 2 Michal Karm Babacek 2015-01-20 13:48:43 UTC
Dear Tom, regarding my comment 1, may I ask you to check who's working on this bugzilla and whether there has been any change in the text of our current documentation build?
With more and more changes piling up, it's gonna be harder and harder to locate what was supposed to be fixed...

Thanks.

Comment 8 anrobert 2015-10-27 20:20:12 UTC
In JIRA -> https://issues.jboss.org/browse/JBEAP-1300