Installing and Configuring the J2EE Application Server Middleware Stack Components

Verify that a JDK is installed before attempting to install JBoss and the JAVA_HOME environment variable is set to JDK, not JRE.

Verify that Tomcat is not already installed on the system, and if it is, remove it.

The JBoss Enterprise Application Server Platform contains an embedded Tomcat Server, which interferes with the standalone version.

Download the JBoss Enterprise Application Platform package. See Table 1 for the correct version and Web link.

Follow the JBoss instructions, provided at the JBoss website, to install and configure the JBoss Application Server.

Set the environment variable $JBOSS_HOME to the JBoss installation directory, the default is /usr/local/jboss, and modify the system file you previously created (jboss.sh or jboss.csh) to export the following environment variable:

PATH=$JAVA_HOME/bin:$PATH

	NOTE: You can edit the $JBOSS_HOME/bin/run.conf file to modify the JBoss run time parameters, which include Java Virtual Machine (VM) options. For example, to increase the memory consumed by JBoss from the default of 128MB to 1024MB, set the following line in the run.conf file: JAVA_OPTS="-server -Xms1024m -Xmx1024m" Choose a value appropriate for your system configuration. For detailed information, see the JBoss Application Server documentation.

Start the JBoss Application Server using a non-root user and create a user and a group both called jboss, by entering the following:

# groupadd -r jboss

# useradd -r -m -g <JBOSS_GROUP_ID> -d /home/jboss jboss

Change the user and group ownership for the $JBOSS_HOME/server directory by entering the following:

# chown -R jboss:jboss $JBOSS_HOME/server

Test the JBoss installation by entering the following:

# su -l –m jboss -c '$JBOSS_HOME/bin/run.sh -c default -b 0.0.0.0'

Check the standard output and verify that no error messages appear.

The output should be similar to the following sample log:

23:18:10,415 INFO  [TomcatDeployer] deploy, ctxPath=/jmx-console, warUrl=.../deploy/jmx-console.war/
23:18:10,556 INFO  [Http11Protocol] Starting Coyote HTTP/1.1 on http-0.0.0.0-8080
23:18:10,568 INFO  [AjpProtocol] Starting Coyote AJP/1.3 on ajp-0.0.0.0-8009
23:18:10,574 INFO  [Server] JBoss (MX MicroKernel) [4.2.0.GA (build: SVNTag=JBPAPP_4_2_0_GA date=200706281411)] Started in 13s:147ms

Verify the JBoss installation by opening a browser and entering the following URL:

http://<YOUR_HOSTNAME>:8080/

Figure 4 JBoss Test Page

Verify the installation of the JBoss-embedded Hibernate package by changing to the $JBOSS_HOME/server/default/lib directory and checking for the hibernate3.jar file.

# ls ./$JBOSS_HOME/server/default/lib

Shutdown the server by entering the following:

# $JBOSS_HOME/bin/shutdown.sh -u<USER_NAME> -p<PASSWORD> -S

	NOTE: Set the user name and password in $JBOSS_HOME/server/<YOUR_CONFIG>/conf/props/jmx-console-users.properties before running the shutdown script.

From the JMX Agent View console, select service=JNDIView.

Locate the list operation and click invoke.

The JNDI Tree View is displayed as in Figure 6.

This operation can be helpful in determining why a particular EJB name did not resolve.

Expand the system tree, located in the left-hand pane, and scroll down to the JMX MBeans view.

Select a particular MBean and double-click it to open and view its attribute list.

Right-click on an attribute to display the pop-up menu and select Graph.

Select Create Monitor to display the creation view.

After a monitor is created, it appears under the Monitoring tree in the JBoss Management console pane, as displayed in Figure 8.

Figure 8 JBoss Web Console — Monitor Status

When a threshold is reached, the monitor sends out a JMX notification to the console. For example, the notification should look similar to the following:

11:18:31,293 INFO  [Server] JBoss (MX MicroKernel) 
[4.2.0.GA (build: SVNTag=JBPAPP_4_2_0_GA date=200706281411
11:19:18,263 INFO  [ConsoleAlertListener] zyc-free-memory was 
triggered for attribute FreeMemory.

For more information, see the Web Console Monitoring Web page located at:

http://wiki.jboss.org/wiki/Wiki.jsp?page=WebConsoleMonitoring

Download mod_jk from the Apache Software Foundation (see Table 1 for the correct version and website link), and follow the instructions provided to build the mod_jk.so shared library. If necessary, copy the mod_jk.so file into the /usr/lib64/apache2/ directory.

Edit the Apache Web Server configuration file, /etc/apache2/conf/httpd.conf, and then add the following contents:

#Load mod_jk
LoadModule jk_module /usr/lib64/apache2/mod_jk.so
#Configure mod_jk
JkShmFile /var/log/apache2/memory.shm
JkWorkersFile /etc/apache2/workers.properties
JkLogFile /var/log/apache2/mod_jk.log
JkLogLevel info

Insert the following contents below the DocumentRoot line:

JkMount /jmx-console/* worker1

Create a file named /etc/apache2/workers.properties and add the following contents:

# Define 1 real worker using ajp13 
worker.list=worker1 
# Set properties for worker1 (ajp13) 
worker.worker1.type=ajp13 
worker.worker1.host=localhost 
worker.worker1.port=8009 
worker.worker1.lbfactor=50 
worker.worker1.cachesize=10 
worker.worker1.cache_timeout=600 
worker.worker1.socket_keepalive=1 
worker.worker1.socket_timeout=300

To use the JMX console for testing, you must configure it using the following steps:

If JBoss is not running, start it by entering the following:

# /usr/local/jboss/run.sh -c default -b 0.0.0.0

Restart Apache by entering the following:

# /etc/init.d/apache2 restart

Verify that you can connect to JBoss through the standard HTTP port served by Apache by navigating to the website located at:

http://<YOUR_HOSTNAME>/jmx-console/

At the JMX console security dialog box, enter admin for the username and admin for the password.

The JMX Agent View is shown in Figure 10.

Figure 10 JMX Agent View

Verify that php is installed by entering the following:

# rpm -q apache2–mod_php5

Create a test file named /srv/www/htdocs/test.php and add the following contents:

<? 
## sample php file 
phpinfo(); 
?>

Verify that PHP works by opening a browser and navigating to the website located at:

http://<YOUR_HOSTNAME>/test.php

A Web page containing the PHP version and license numbers is displayed.

Verify that the mod_perl module is installed by entering the following:

# rpm -q apache2–mod_perl

Create a sample test file named /srv/www/cgi-bin/test.pl and add the following contents:

#!/usr/bin/perl 
print "Content-type: text/plain\n\n"; 
print "mod_perl rocks!\n";

Assign execute permissions to the file by entering the following:

# chmod +x /srv/www/cgi-bin/test.pl

Edit the file /etc/sysconfig/apache2 by adding mod_perl to the APACHE_MODULE definition.

Change the DocumentRoot to /srv/www/cgi-bin in the /etc/apache2/default-server.conf file.

Restart Apache by entering the following:

# /etc/init.d/apache2 restart

Verify that Perl works by opening a browser and navigating to the following URL:

http://<YOUR_HOSTNAME>/perl/test.pl

The Web page displays the following message:

mod_perl rocks!

Verify the mod_python module is installed by entering the following:

# rpm -q apache2–mod_python

Create a test file named /srv/www/htdocs/test.py and insert the following contents:

from mod_python import apache
def handler(req):
        req.write("mod_python rocks!")
        return apache.OK

Edit the file /etc/apache2/conf.d/python.conf and add the following contents:

<Directory /srv/www/htdocs>
     AddHandler mod_python .py
     PythonHandler test
     PythonDebug On 
</Directory>

Add mod_python to the APACHE_MODULE definition in the file /etc/sysconfig/apache2

	NOTE: Check the file /etc/apache2/mime.types. If the line text/x-python py is included in this file, comment out this line by adding # to the beginning of the line.

Restart Apache by entering the following:

# /etc/init.d/apache2 restart

Verify that Python works by opening a browser and navigating to the following URL:

http://<YOUR_HOSTNAME>/test.py

The Web page displays the following message:

mod_python rocks!

Create the following in both the MySQL and Oracle databases:

For information on creating users, databases, and tables, see the following:

For MySQL, see the MySQL 5.0 Reference Manual located at:

http://dev.mysql.com/doc/refman/5.0/en/index.html

For Oracle, see the Oracle Database SQL Reference guide located at:

http://download-east.oracle.com/docs/cd/B19306_01/server.102/b14200/toc.htm

Create the USERS table with the osmsusr user in the MySQL database, by entering the following:

mysql> use osmsdb;

mysql> CREATE TABLE USERS

(USER_ID INT(10) AUTO_INCREMENT NOT NULL PRIMARY KEY,

FIRST_NAME VARCHAR(30) NOT NULL,

LAST_NAME VARCHAR(30) NOT NULL );

Create the USERS table with the user osmsusr in the Oracle database by entering the following:

SQL> CREATE TABLE USERS

(USER_ID NUMBER(10) NOT NULL,

FIRST_NAME VARCHAR2(30) NOT NULL,

LAST_NAME VARCHAR2(30) NOT NULL, );

SQL> ALTER TABLE USERS ADD CONSTRAINT USER_PRIMARY_KEY PRIMARY KEY(USER_ID) USING INDEX;

Create the Oracle sequence HIBERNATE_SEQUENCE to generate the primary key for the USERS table by entering the following:

SQL> CREATE SEQUENCE  HIBERNATE_SEQUENCE
START WITH 10
INCREMENT BY 1
MINVALUE 10
MAXVALUE 999999999999;

Create the directories SimpleDemo/src and SimpleDemo/WebRoot in the location of your choice.

Create a Hibernate mapping file named SimpleDemo/src/Users.hbm.xml, according to the definition of the table USERS, and add the following contents:

<?xml version="1.0"?>
<!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
<hibernate-mapping>
    <class name="com.hp.osms.hibernate.Users" table="USERS">
    	<id name="userId" type="java.lang.Long">
    		<column name="USER_ID" precision="10" scale="0" />
    		<generator class="native">
	   		<param name="sequence"> HIBERNATE_SEQUENCE</param>
    		</generator>
    	</id>
      <property name="firstName" type="java.lang.String">
      		<column name="FIRST_NAME" length="30" />
      </property>
      <property name="lastName" type="java.lang.String">
      		<column name="LAST_NAME" length="30" />
      </property>
    </class>
</hibernate-mapping>

Copy the example JBoss datasource files by entering the following:

For a MySQL database:

# cp $JBOSS_HOME/docs/examples/jca/mysql-ds.xml \

$JBOSS_HOME/server/default/deploy/

For an Oracle database:

# cp $JBOSS_HOME/docs/examples/jca/oracle-ds.xml \

$JBOSS_HOME/server/default/deploy/

Configure the JBoss connection to MySQL by editing the mysql-ds.xml file and adding the following contents:

<?xml version="1.0" encoding="UTF-8"?>
<datasources>
  <local-tx-datasource>
    <jndi-name>MySqlDS</jndi-name>
    <connection-url>jdbc:mysql://IP_OR_HOSTNAME_OF_THE_DB_SERVER:3306/osmsdb
    </connection-url>
    <driver-class>com.mysql.jdbc.Driver</driver-class>
    <user-name> osmsusr </user-name>
    <password> osmspass </password>
    <exception-sorter-class-name>org.jboss.resource.adapter.jdbc.vendor.MySQLExceptionSorter
		</exception-sorter-class-name>
    <metadata>
    <type-mapping>mySQL</type-mapping>
    </metadata>
  </local-tx-datasource>
</datasources>

Configure the JBoss connection to Oracle by editing the oracle-ds.xml file and adding the following contents:

<?xml version="1.0" encoding="UTF-8"?>
	<datasources>
		<local-tx-datasource>
			<jndi-name>OracleDS</jndi-name>
			<connection-url>jdbc:oracle:thin:@IP_OR_HOSTNAME_OF_THE_DB_SERVER:1521:osmsdb</connection-url>
			<driver-class>oracle.jdbc.driver.OracleDriver</driver-class>
			<user-name> osmsusr </user-name>
			<password> osmspass </password>
			<exception-sorter-classname>org.jboss.resource.adapter.jdbc.vendor.OracleExceptionSorter
			</exception-sorter-class-name>
			<metadata>
			<type-mapping>Oracle9i</type-mapping>
			</metadata>
	</local-tx-datasource>
</datasources>

Download the JDBC driver, as appropriate for the database, from one of the following websites:

Copy the JDBC driver to the $JBOSS_HOME/server/default/lib directory.

Deploy the archive file SimpleDemo.war to JBoss by entering the following:

# cp SimpleDemo.war $JBOSS_HOME/server/default/deploy/

Start the JBoss Enterprise Application Server by entering the following:

# $JBOSS_HOME/bin/run.sh -c default -b 0.0.0.0

Verify the Hibernate test page is displayed as in Figure 16 by opening a browser and navigating to:

http://JBOSS_HOSTNAME:8080/SimpleDemo/hibernate.jsp

Figure 16 Hibernate Test Page