Dear doc guys,
I would like you to read the following text and comment on
which articles should appear in the official documentation.

Regarding the described workaround paragraphs:
  These won't be necessary as soon as [BZ 1004875] is resolved.
  This also means that in EAP 6.2, this text won't be accurate any more
  and paragraphs related to mod_jk with base os httpd would have to be updated.


Please, consider whether some parts of this text aren't actually more suitable
for the Knowledge base access portal.


RHEL5
=====
Mod_jk 1.2.37 is compatible with the base os httpd 2.2.3, yet, the current 
EAP 6.1.1 mod_jk RPM has its httpd dependency set to >= httpd 2.2.22, so one
can install mod_jk in the following ways:

a) The good, supported one with httpd 2.2.22
--------------------------------------------
{code}
yum install mod_jk
{code}

This step will install mod_jk-ap22 1.2.37 and its dependency: httpd 2.2.22 from
jbappplatform-6-*-server-5-rpm channel. At this point, mod_jk is successfully installed.
One can copy its configuration files examples:

{code}
cp /usr/share/doc/mod_jk-ap22-1.2.37/mod_jk.conf.sample /etc/httpd/conf.d/mod_jk.conf
cp /usr/share/doc/mod_jk-ap22-1.2.37/workers.properties.sample /etc/httpd/conf/workers.properties
{code}

and adjust them to ones needs <reference to configuration Chapter here>. Mod_jk is ready and the httpd
it resides in can be started as simply as:

{code}
service httpd start
{code}



b) Use the base os httpd 2.2.3 + yum workaround
------------------------------------------------
Due to the current httpd >= 2.2.22 dependency set for mod_jk 1.2.37,
it is not possible to install it in the standard way without being forced
to update the base os httpd 2.2.3 to 2.2.22 from jbappplatform-6 channel.
One can do the following unsupported workaround though:

{code}
yum install httpd mod_perl
{code}

The aforementioned command installs httpd 2.2.3, mod_perl and other necessary
dependencies from rhel-*-server-5 channel. If you are registered to jbappplatform-6 channel
already, you can append --disablerepo=jbappplatform-6-*

Furthermore, let's download mod_jk from jbappplatform-6-*-server-5-rpm channel:
{code}
yum install yum-downloadonly
yum install mod_jk-ap22 --downloadonly --downloaddir=./ -y
rpm -U mod_jk-ap22-1.2.37* --nodeps
{code}

At this point, mod_jk native lib is installed. One can copy its configuration files examples:

{code}
cp /usr/share/doc/mod_jk-ap22-1.2.37/mod_jk.conf.sample /etc/httpd/conf.d/mod_jk.conf
cp /usr/share/doc/mod_jk-ap22-1.2.37/workers.properties.sample /etc/httpd/conf/workers.properties
{code}

and adjust them to ones needs <reference to configuration Chapter here>. Mod_jk is ready and the httpd
it resides in can be started as simply as:

{code}
service httpd start
{code}



c) The good, supported one with base os httpd 2.2.3
---------------------------------------------------
If the base os httpd 2.2.3 must be used and updating httpd to httpd 2.2.22 from
jbappplatform-6 rpm channel is not the preferred option, the best and supported
solution is to follow mod_jk installation from the zip distribution.

Please note there are these dependencies one must install in order to be able to
use mod_jk 1.2.37 with the base os httpd 2.2.3:

{code}
yum install mod_perl
{code}



Note on mod_perl
----------------
Make sure mod_perl module is loaded _before_ mod_jk module. One can e.g. add this
to /etc/httpd/conf.d/mod_jk.conf:

+<IfModule !perl_module>
+        LoadModule perl_module modules/mod_perl.so
+</IfModule>
LoadModule jk_module modules/mod_jk.so

The following error message means that your mod_jk module had been loaded before mod_perl was present:
    Cannot load /etc/httpd/modules/mod_jk.so into server: /etc/httpd/modules/mod_jk.so: undefined symbol: ap_get_server_description




RHEL6
=====
The base os httpd 2.2.15 is just fine for running mod_jk 1.2.37, however the current
EAP 6.1.1 mod_jk RPM has its httpd dependency set to >= httpd 2.2.22,
so there are three options:

a) The good, supported one with httpd 2.2.22
--------------------------------------------
{code}
yum install mod_jk
{code}

This step will install mod_jk-ap22 1.2.37 and its dependency: httpd 2.2.22 from
jbappplatform-6-*-server-6-rpm channel.
At this point, mod_jk is successfully installed. One can copy its configuration files examples:

{code}
cp /usr/share/doc/mod_jk-ap22-1.2.37/mod_jk.conf.sample /etc/httpd/conf.d/mod_jk.conf
cp /usr/share/doc/mod_jk-ap22-1.2.37/workers.properties.sample /etc/httpd/conf/workers.properties
{code}

and adjust them to ones needs <reference to configuration Chapter here>. Mod_jk is ready and the httpd
it resides in can be started as simply as:

{code}
service httpd start
{code}



b) Use the base os httpd 2.2.15 + yum workaround
------------------------------------------------
It is possible to use mod_jk 1.2.37 with the base os httpd 2.2.15, yet,
the dependency of mod_jk 1.2.37 package is set to httpd >= 2.2.22. If updating httpd to httpd 2.2.22 from
jbappplatform-6 rpm channel is not the preferred option, one can install mod_jk with these steps:

{code}
yumdownloader mod_jk-ap22
rpm -U mod_jk-ap22-1.2.37* --nodeps
{code}

At this point, mod_jk native is installed and can be used with base os httpd 2.2.15.
One can copy its configuration files examples:

{code}
cp /usr/share/doc/mod_jk-ap22-1.2.37/mod_jk.conf.sample /etc/httpd/conf.d/mod_jk.conf
cp /usr/share/doc/mod_jk-ap22-1.2.37/workers.properties.sample /etc/httpd/conf/workers.properties
{code}

and adjust them to ones needs <reference to configuration Chapter here>. Mod_jk is ready and the httpd
it resides in can be started as simply as:

{code}
service httpd start
{code}



c) The good, supported one with base os httpd 2.2.15
-----------------------------------------------------
If the base os httpd 2.2.15 must be used and updating httpd to httpd 2.2.22 from
jbappplatform-6 rpm channel is not the preferred option, the best and supported
solution is to follow mod_jk installation from the zip distribution.
<reference to jboss-eap-native-webserver-connectors-6.1.1-RHEL*.zip install guide>


:-)