January 4, 2013

How to Install JBoss EAP 6.0.1 Native Components and Webserver Connector Natives for RHEL 6

When I wanted to install the JBoss EAP 6.0.1 native components and Webserver Connector natives on RHEL 6.3 I had some hard time. The only thing I knew was that I wanted to install them via RPM package, so I could get the nice built in management support for upgrades, reinstall and uninstall. But finding the correct packages was not that obvious.

As usual when knowing the answer everything is easy, which I'm going to present to you below.

First install JBoss EAP 6.0.1 via yum. That is described in the JBoss EAP 6 Installation Guide, which you can find here https://access.redhat.com/knowledge/docs/en-US/JBoss_Enterprise_Application_Platform/6/html/Installation_Guide/Install_JBoss_Enterprise_Application_Platform_6_using_the_Red_Hat_Network_RPM_installation.html

$ yum groupinstall jboss-eap6

If you then grab the yum group info for that group package and then the list the installed file, you will see that the JBoss EAP 6 native components are already bundled in the jboss-eap6 group package.

$ yum groupinfo jboss-eap6
Group: JBoss EAP 6
 Mandatory Packages:
   jbossas-appclient
   jbossas-bundles
   jbossas-core
   jbossas-domain
   jbossas-hornetq-native
   jbossas-jbossweb-native
   jbossas-modules-eap
   jbossas-product-eap
   jbossas-standalone
   jbossas-welcome-content-eap

$ rpm -ql jbossas-hornetq-native
/usr/share/jbossas/modules/org/hornetq/main/lib
/usr/share/jbossas/modules/org/hornetq/main/lib/linux-x86_64
/usr/share/jbossas/modules/org/hornetq/main/lib/linux-x86_64/libHornetQAIO.so

$ rpm -ql jbossas-jbossweb-native
/usr/share/jbossas/modules/org/jboss/as/web/main/lib
/usr/share/jbossas/modules/org/jboss/as/web/main/lib/linux-x86_64
/usr/share/jbossas/modules/org/jboss/as/web/main/lib/linux-x86_64/libapr-1.so
/usr/share/jbossas/modules/org/jboss/as/web/main/lib/linux-x86_64/libcrypto.so
/usr/share/jbossas/modules/org/jboss/as/web/main/lib/linux-x86_64/libssl.so
/usr/share/jbossas/modules/org/jboss/as/web/main/lib/linux-x86_64/libtcnative-1.so

If you do not want install the JBoss EAP 6 via yum, you can do that manually which for example is described here - http://www.opensourcearchitect.com/tutorials/instaling-eap-600-rhel-6x. But I do not recommend that for JBoss EAP 6, because it is already nice packaged. If you are installing JBoss EAP 5.x, you probably want to take that path, but no for JBoss EAP 6.

The next thing is to install JBoss EAP 6 Webserver Connector Natives, but before doing that you need to install Apache Web Server, which I have earlier described here, http://magnus-k-karlsson.blogspot.se/2013/01/install-apache-web-server-on-red-hat.html

After you have installed Apache Web Server you only need to install two packages.

$ yum install mod_jk-ap22 mod_cluster-native

After installation you can list the installed files.

$ rpm -ql mod_jk-ap22
/usr/lib64/httpd/modules/mod_jk.so
/usr/share/doc/mod_jk-ap22-1.2.36
/usr/share/doc/mod_jk-ap22-1.2.36/LICENSE
/usr/share/doc/mod_jk-ap22-1.2.36/NOTICE
/usr/share/doc/mod_jk-ap22-1.2.36/README.txt
/usr/share/doc/mod_jk-ap22-1.2.36/TODO.txt
/usr/share/doc/mod_jk-ap22-1.2.36/mod_jk.conf.sample
/usr/share/doc/mod_jk-ap22-1.2.36/workers.properties.sample
/var/run/mod_jk

$ rpm -ql mod_cluster-native
/etc/httpd/conf.d/mod_cluster.conf
/usr/lib64/httpd/modules/mod_advertise.so
/usr/lib64/httpd/modules/mod_manager.so
/usr/lib64/httpd/modules/mod_proxy_cluster.so
/usr/lib64/httpd/modules/mod_slotmem.so
/usr/share/doc/mod_cluster-native-1.2.3
/usr/share/doc/mod_cluster-native-1.2.3/JBossORG-EULA.txt
/usr/share/doc/mod_cluster-native-1.2.3/README.txt
/usr/share/doc/mod_cluster-native-1.2.3/lgpl.txt
/usr/share/doc/mod_cluster-native-1.2.3/release.txt
/usr/share/selinux/packages/mod_cluster-native
/usr/share/selinux/packages/mod_cluster-native/mod_cluster-native.pp
/var/cache/mod_cluster

As you can see from the list of installed files, the mod_cluster-native package have already added a configuration file for the Apache Web Server - /etc/httpd/conf.d/mod_cluster.conf. After restarted you Apache Web Server you can test you mod cluster, by open a web browser and point it to http://127.0.0.1:6666/mod_cluster_manager.

No comments: