Note: This is a beta release of Red Hat Bugzilla 5.0. The data contained within is a snapshot of the live data so any changes you make will not be reflected in the production Bugzilla. Also email is disabled so feel free to test any aspect of the site that you want. File any problems you find or give feedback here.
Bug 1061659 - [Doc Bug Fix] A terminology confusion, Apache HTTP Server is referred to in five different ways in a one article
Summary: [Doc Bug Fix] A terminology confusion, Apache HTTP Server is referred to in f...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: JBoss Enterprise Application Platform 6
Classification: JBoss
Component: Documentation
Version: 6.2.1
Hardware: Unspecified
OS: Unspecified
unspecified
high
Target Milestone: post-GA
: EAP 6.3.2
Assignee: Russell Dickenson
QA Contact: Michal Karm Babacek
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2014-02-05 10:44 UTC by Michal Karm Babacek
Modified: 2014-11-23 23:16 UTC (History)
6 users (show)

Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Build Name: 14874, Administration and Configuration Guide-6.2-1 Build Date: 02-12-2013 14:15:34 Topic ID: 4650-459084 [Specified]
Last Closed: 2014-11-23 23:16:49 UTC
Type: Bug


Attachments (Terms of Use)

Description Michal Karm Babacek 2014-02-05 10:44:51 UTC
This article:
    The mod_cluster connector has several advantages:

is a hardly legible mix of various terminologies.

In these few sentences, Apache HTTP Server is referred to as:

 * httpd
 * web container
 * HTTPD proxies
 * the proxy
 * Apache HTTP

Please, take a look at:

 https://bugzilla.redhat.com/show_bug.cgi?id=1017192
 https://bugzilla.redhat.com/show_bug.cgi?id=1015106

In other words, yes, Apache HTTP Server with mod_cluster modules acts as a proxy,
this diagram holds:

    Clients <-- HTTPS/HTTP --> Apache HTTP Server <-- AJP/HTTP/HTTPS --> EAP instances (application servers)

Yes, Apache HTTP Server with mod_cluster modules receives MCMP messages from its registered worker nodes, EAP instances.
Yes, Apache HTTP Server with mod_cluster modules performs load balancing accordingly to the load values it receives from its registered worker nodes, EAP instances.

Please, if you have any questions or doubts, set needinfo or ping me.

THX

Comment 3 Michal Karm Babacek 2014-03-21 13:02:21 UTC
The following sentence is very misleading:

{quote}
Which connector you use depends on which web container you choose to use with JBoss EAP 6.
{quote}

Could you tell me what was the intended meaning? I might be of an assistance in clearing it out.

The "web container" for EAP is JbossWeb, period. It has little to nothing to do with the load balancer "connector" on the Apache HTTP Server side (Oracle iPlanet, MS IIS), whether it is mod_cluster, mod_jk, ISAPI or NSAPI...

Comment 5 Russell Dickenson 2014-10-03 00:49:16 UTC
Summary of Changes
==================
* Removed the text "Which connector you use depends on which web container you choose to use with JBoss EAP 6."
* Edited several items slightly for grammatical reasons.

Notes to CCS
============
"About the mod_cluster HTTP Connector" (Topic ID 4650, revision 714937).

Notes to QE
===========
The amended text is available for preview at [1]. When the "Administration and Configuration Guide" is next rebuilt I will move this BZ to ON_QA.


[1] http://docbuilder.usersys.redhat.com/22815/#About_the_Modcluster_HTTP_Connector

Comment 7 Michal Karm Babacek 2014-10-22 10:03:03 UTC
Dear Russell,

there are two glitches present in the article:

1) There is no such thing as "Apache Web Server", within the context of our documentation. It's "Apache HTTP Server".
Please, see links in the description of this Bugzilla for further explanation.

2) The *Note:* bubble states:

> The mod_cluster configuration page is only visible for profiles with the HA
> Clustering subsystem enabled. These profiles are ha and full-ha for a managed
> domain, or standalone-ha and standalone-full-ha for a standalone server. 

That's not true and it's actually dangerously suggesting that mod_cluster subsystem has something to do with the clustering subsystem. It does not, they are independent. The note should run as, for instance:

> The mod_cluster configuration page is only visible for ha and full-ha
> profiles. These profiles are ha and full-ha for a managed domain, or
> standalone-ha and standalone-full-ha for a standalone server.

These are the last bits.

Thank you very much for giving it the final touch :-)

K.

Comment 8 Michal Karm Babacek 2014-11-06 14:04:08 UTC
Dear Doc guys, could you take a look at it, please?

Comment 16 Michal Karm Babacek 2014-11-20 13:58:33 UTC
It's perfect!

Thank you very much for your time and effort.

Cheers

K.


Note You need to log in before you can comment on or make changes to this bug.