JBoss 4.x Installation

JBoss Installation Guide:

In this procedure I used the following versions for installtion.

OS : RHEL 5.3
JBoss : jboss-4.2.3.GA
JDK : jdk-6u23-linux-i586

1) Create a user with name 'jboss' and group also with 'jboss' and create the required password for the user too.

[root@tripwire ~]# passwd jboss
Changing password for user jboss.
New UNIX password:
BAD PASSWORD: it is too short
Retype new UNIX password:
passwd: all authentication tokens updated successfully.


2) Download the required versions of Java and Jboss. Here I had downloaded the following packages from the corresponding links.
i) jboss-4.2.3.GA.zip : This file has been downloaded from the following link.
http://www.jboss.org/jbossas/downloads/

ii) jdk-6u23-linux-i586.bin : This file has been downloaded from the following link.
http://www.oracle.com/technetwork/java/javase/downloads/index.html

3) Copy these files to jboss home directory and change the permissions of the file to jboss user.

[root@tripwire jboss]# chown jboss.jboss jboss-4.2.3.GA.zip jdk-6u23-linux-i586.bin

4) Install jdk as java includes in it.

[jboss@tripwire ~]$ chmod +x jdk-6u23-linux-i586.bin
[jboss@tripwire ~]$ ./jdk-6u23-linux-i586.bin

These files will be extracted in the same directory

[jboss@tripwire ~]$ ll
total 179824
-rw-r--r-- 1 jboss jboss 99479031 Dec 10 2010 jboss-4.2.3.GA.zip
drwxr-xr-x 10 jboss jboss 4096 Dec 7 22:43 jdk1.6.0_23
-rwxr-xr-x 1 jboss jboss 84461758 Dec 10 2010 jdk-6u23-linux-i586.bin

5) Unzip downloaded Jboss file from the same jboss user.

[jboss@tripwire ~]$ unzip jboss-4.2.3.GA.zip

Now jboss-4.2.3.GA directory will be created in the same jboss user directory.

6) Now we can start the jboss by exporting the variables temporarily.

[jboss@tripwire ~]$ JAVA_HOME=/home/jboss/jdk1.6.0_23
[jboss@tripwire ~]$ export JAVA_HOME
[jboss@tripwire ~]$ jboss-4.2.3.GA/bin/run.sh

This following command only works with localhost if you require to access the jboss URL form remote machines you have to tweak the above command

[jboss@tripwire ~]$ jboss-4.2.3.GA/bin/run.sh -b 0.0.0.0

But it will be difficult to export each and every time.
So lets create a startup and shutdown scripts to start and stop jboss accordingly.

Startup script:

Create a file start_jboss.sh with the following parameters.

[jboss@tripwire ~]$ cat start_jboss.sh
#!/bin/bash

export JAVA_HOME=/home/jboss/jdk1.6.0_23
export PATH=$PATH:$JAVA_HOME/bin

export JBOSS_HOME=/home/jboss/jboss-4.2.3.GA
export PATH=$PATH:$JBOSS_HOME/bin

sh $JBOSS_HOME/bin/run.sh -b 0.0.0.0 &

Add the execute permissions for above file.

[jboss@tripwire ~]$ chmod +x start_jboss.sh


Shutdown Script:

Create a file shutdown_jboss.sh with the following parameters.

[jboss@tripwire ~]$ cat shutdown_jboss.sh
export JAVA_HOME=/home/jboss/jdk1.6.0_23
export PATH=$PATH:$JAVA_HOME/bin

export JBOSS_HOME=/home/jboss/jboss-4.2.3.GA
export PATH=$PATH:$JBOSS_HOME/bin

sh $JBOSS_HOME/bin/shutdown.sh --shutdown

Add the execute permissions to the file

[jboss@tripwire ~]$ chmod +x shutdown_jboss.sh

Now you can simply start and stop the jboss using these scripts.

Now you can access the jboss URL.

http://:8080 Eg: http://192.168.8.131:8080

By default Jboss runs on 8080 port number, If you want to change the port service number then change the value of 8080 to required number in /home/jboss/jboss-4.2.3.GA/server/default/deploy/jboss-web.deployer/server.xml file in 22 line (Approximately). You need to change the string as follows.

Before change :
[jboss@tripwire ~]$ grep 8080 /home/jboss/jboss-4.2.3.GA/server/default/deploy/jboss-web.deployer/server.xml
Define a non-SSL HTTP/1.1 Connector on port 8080


After Change: (Here changed the required port to 10000)

[jboss@tripwire ~]$ grep 10000 /home/jboss/jboss-4.2.3.GA/server/default/deploy/jboss-web.deployer/server.xml
Define a non-SSL HTTP/1.1 Connector on port 10000


So now you can access the Jboss URL using port 10000

http://192.168.8.131:10000

Note : This particular procedure works with jboss 4.x not sure for other versions.