Using mod_proxy with http/https:

This wiki outlines the various steps required to install a basic load-balancing solution based on mod_proxy, mod_proxy_balancer and JBoss. Mod_proxy allows to use http/https and AJP protocols to proxy to JBoss. This documentation is for Apache httpd-2.2.x if
you have to use older version of httpd see Load
Balancing using mod_rewrite and mod_proxy

Using mod_proxy with http/https:

Step 1: Download Apache2.2.x Web Server

Get the latest Apache2.2.x package from Apache.org and
install it. We require no special configuration, just use the default settings. In the following steps, APACHE_HOME will represent the Apache install directory.

+

Note:* At the time of the writting of this document Apache 2.2.9 is most stable version of Apache httpd-2.2.x and is recommended if you want to use load-balancing using mod_proxy

+

Step 2: Setup Apache to use mod_proxy (HTTP)

Make sure that at least following modules are loaded (uncomment this in httpd.conf)

LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_balancer_module modules/mod_proxy_balancer.so
LoadModule proxy_http_module modules/mod_proxy_http.so

These are sufficient for http load balancing. However you may need to load mod_proxy_ftp module if you are using ftp or load mod_proxy_connect module if you are using SSL

Add those lines in APACHE_HOME/conf/httpd.conf :

<Proxy balancer://mycluster>
Order deny,allow
Allow from all

BalancerMember http://host1:8080 route=node1
BalancerMember http://host2:8180 route=node2
</Proxy>

ProxyPass /jmx-console balancer://mycluster
ProxyPassReverse /jmx-console  http://host1:8080/jmx-console ProxyPassReverse /jmx-console  http://host2:8180/jmx-console

By default the requests are load balanced in byrequests fashion, which performs weighted request counting. This is determined by parameter lbmethod. The stickysession parameter is also required, as there is no default value. stickysession is used to determine
which URL session name or cookie to use when looking for the route for the request.

ProxyPass /jmx-console balancer://mycluster lbmethod=byrequests stickysession=JSESSIONID|jsessionid

You can find more about ProxyPass attributes in the Apache HTTP Server documentation at http://httpd.apache.org/docs/2.2/mod/mod_proxy.html .

Step 3: Configure JBoss Web if you want to use sticky session

Edit JBOSS_HOME/server/all/deploy/jbossweb-web.deployer/server.xml (replace /all with your own server name)

Locate the <Engine> element and add an attribute for jvmRoute:

<Engine name="jboss.web" defaultHost="localhost" jvmRoute="node1">
.
</Engine>

Step 4: Configure JBoss session to add jvmRoute to the sessions

Finally, we need to tell JBoss Web to add the jvmRoute value to its session cookies so that mod_proxy_balancer can route incoming requests.

Edit JBOSS_HOME/server/all/deploy/jboss-web.deployer/META-INF/jboss-service.xml (replace /all with your own server name)

Locate the attribute element with a name of UseJK, and set its value to "true":

<attribute name="UseJK">true</attribute>

Using mod_proxy with AJP:

Step 1: See Using mod_proxy with http/https (above)

Step 2: Setup Apache to use mod_proxy (AJP)

Make sure that at least following modules are loaded (uncomment this in httpd.conf)

LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_balancer_module modules/mod_proxy_balancer.so
LoadModule proxy_ajp_module modules/mod_proxy_ajp.so

Add those lines in APACHE_HOME/conf/httpd.conf :

<Proxy balancer://mycluster>
Order deny,allow
Allow from all

BalancerMember ajp://localhost:8009/jmx-console
BalancerMember ajp://localhost:8109/jmx-console
</Proxy>

ProxyPass /jmx-console balancer://mycluster

Step 3: See Using mod_proxy with http/https (above)

Step 4: See Using mod_proxy with http/https (above)

When to use mod_jk and when to use mod_proxy for load-balancing

Load balancing is definitely easier to configure using mod_proxy as compared to mod_jk1.x.

mod_proxy works well since version 2.2.2 of Apache httpd. Don't use mod_proxy with older version of Apache httpd.

mod_jk is in continous development phase and is tried and tested by many people arround the world. mod_proxy is fairly new.

mod_proxy_http doesn't forward the SSL information to JBoss Web (See Forwarding
SSL environment when using http/https proxy )

mod_proxy allows to use https between Apache httpd and JBoss Web (See Encrypting
connection between httpd and TC).

If you decide to use mod_proxy, you have two options for load-balancing

When to use mod_proxy + mod_proxy_http and mod_proxy + mod_proxy_ajp for load-balancing

AJP is binary, so there was the transmission savings

JBoss Web could handle AJP faster and more efficiently than HTTP (the AJP endpoints were quicker than the HTTP endpoint implementations)

However mod_proxy_http now implements connection pooling and load balancing so one needs to test mod_proxy_http as well as mod_proxy_ajp before deciding

Here is the FAQ on
mod_proxy_ajp vs mod_jk

Using sticky sessions:

Add stickysession parameter to ProxyPass

ProxyPass /jmx-console balancer://mycluster stickysession=JSESSIONID lbmethod=bytraffic nofailover=Off

Sticky Session is supported by mod_proxy_http as well as mod_proxy_ajp

Note:* If you are using mod_proxy_http you have to create one ProxyPassReverse for each BalancerMember you define in the balancer.

Going over the 8K AJP headers limits:

The default size of a AJP package is 8K as the http headers are sent only in the first packet it could be needed to overcome the limit.

To reach this you need to add packetSize parameter in the <Connector/> parameter like:

<Connector port="8009" protocol="AJP/1.3"
packetSize="20000"
redirectPort="8443" ></Connector>

and ProxyIOBufferSize (also LimitRequestFieldsize probably) directive in httpd.conf too. For example:

ProxyIOBufferSize 19000
LimitRequestFieldsize 18000

packetSize is supported since Tomcat 5.5.21 and Tomcat 6.0.1.

Old version of httpd-2.2.x (x<5) need a patch to support this extension. You find the patch at http://people.apache.org/~jfclere/patches/ProxyIOBufferSize.patch

喜欢
(0)

437351 视图

平均用户评价

(1 评价)

评论
(10)





Brian
Holland 2009-4-24
上午12:06

Where does the text in Step 2 the second text snippet go?

<Proxy balancer://mycluster>

...

Does it go in the http.conf file as well, if so where exactly.

喜欢
(0)





Sham
Gatupa 2009-7-30
下午1:56 (回复
Brian Holland)

Brian, Yes, it should be in conf file. For little elegance in organizing the config information,

create another file(any name is good) vitual_proxy.conf and include this at the end in httpd.conf file

喜欢
(0)





Tiago
Emerick 2011-5-20
下午3:51 (回复
Sham Gatupa)

Sorry for reply an old post, but i need help.

I have to do this configuration, but in my case im using mod_cluster.

Do you know something about?

Anyway... using this confg posted here, doesnt work.

Any help?

Sorry again.

喜欢
(0)





Tiago
Emerick 2011-5-20
下午4:01

sorry again.

just being more specific, i have to do the same as you do here:

Using mod_proxy whith AJP

But in my case, is mod_cluster

喜欢
(0)





Jean-Frederic
Clere 2011-5-23
上午7:55 (回复
Tiago Emerick)

for mod_cluster please look to mod_cluster documentation. http://docs.jboss.org/mod_cluster/1.1.0/html/

喜欢
(0)





Sergiu
Pienar 2011-6-21
上午7:25

Hi,

I can not find JBOSS_HOME/server/all/deploy/jbossweb-web.deployer/server.xml but only JBOSS_HOME/server/all/deployers/jboss-web.deployer but this golder does not contain a server.xml file.

I'm using JBoss 5.1.0.GA.

Am I missing something ?

喜欢
(0)





Mark
DeSpain 2011-6-29
上午1:10

In the section "Using mod_proxy with http/https", I think the ProxyPass directive should actually be the same as what it is for the AJP section:

ProxyPass /jmx-console balancer://mycluster

as opposed to

ProxyPass /jmx-console balancer://mycluster/jmx-console

Otherwise, incoming requests will be unintentionally mapped to /jmx-console/jmx-console instead
of just /jmx-console, due to the BalancerMember directives also having /jmx-console at
the end.

BalancerMember http://host1:8080/jmx-console route=node1

喜欢
(0)





Jean-Frederic
Clere 2011-6-29
上午2:10 (回复
Mark DeSpain)

Fixed.

喜欢
(0)





Hendi
Marcos Silva 2012-5-7
下午1:57 (回复
Jean-Frederic Clere)

Using mod_proxy with http/https

did not work well ProxyPass /jmx-console balancer://mycluster

I went back to the ProxyPass /jmx-console balancer://mycluster/jmx-console

喜欢
(0)





Anoop
Rathi 2012-8-15
下午2:51

Sorry for putting it up here on such old post but I need to implement reverse proxy setup so that I can get rid of the JBoss instance port number from the URL once the Apache hits the JBoss.I was using mod_jk but unable to find the proxy setup anywhere.

I am using JBoss Eap 5.1 and Apache Tomcat 2.2.21 Where do I put the following configuration

1) ProxyPass /jmx-console balancer://mycluster lbmethod=byrequests stickysession=JSESSIONID|jsessionid

2) I didnt find the file on path specified. Its inside conf folder for me.

Edit JBOSS_HOME/server/all/deploy/jboss-web.deployer/META-INF/jboss-service.xml (replace /all with your own server name)

3) I didnt find below entry anywhere to make it true.

<attribute
name="UseJK">true</attribute>

please respond to these questions.

Thanks!