How to Deploy Axis2 in JBoss

Applies To

1. Axis2 1.3, JBoss 4.2.2

2. JDK 1.5

Deploying Axis2 on JBoss (for this article, we will be using Jboss 4.2.2. The same steps should also apply to any other recent version of JBoss) is almost the same as deploying Axis2 on Apache Tomcat. Let's take a look at the steps involved with deploying Axis2 on JBoss 4.2.2 (referred to simply as JBoss from here onwards).

Step 1 : Download JBoss

Download the JBoss Application Server binary distribution from the JBoss Web site. You can get the version used in this article from here. We will be using the zip distribution of JBoss.

Once you have downloaded the zip file, extract it to a preferred location on your hard drive. We will refer to this folder as JBOSS_HOME. Now you can start the JBoss server by executing the provided startup script. Go to the JBOSS_HOME/bin folder and execute either the run.bat script (on Windows) or the run.sh script (on Linux).

Navigate to https://localhost:8080/ using your web browser and you should see the JBoss welcome page.

Step 2 : Download Apache Axis2

Next, you need to obtain the Axis2 Web application that is to be installed on JBoss. For this guide, we will be using the Axis2 version 1.3 Web archive, which you can download from here. Alternatively, you can build the Axis2 WAR file using the Axis2 Standard Binary Distribution or using the Source Distribution.

Once you have downloaded the Axis2 war distribution, extract it to get the included axis2.war file.

Step 3 : Install Axis2 Inside JBoss

When running JBoss, you can select the configuration you want to use. You can run JBoss in three different configurations, namely: all, default and minimal. Refer to the JBoss documentation to know more about these different configurations. For this guide, we will be using the default configuration of JBoss.

Copy the axis2.war file you got from step 2  to the JBOSS_HOME/server/default/deploy/ folder. This essentially completes the installation of Axis2 in JBoss.

If you have not already started the JBoss server as discussed in step 1, go to JBOSS_HOME/bin and run either run.bat or run.sh, depending on your operating system.

Once completed, you will see deployed Axis2 web application if you navigate to https://localhost:8080/axis2 on your web browser. 

Author

Eran Chinthaka, WS PMC Member/Member-Apache Software Foundation, eran(dot)chinthaka(Y)gmail.com, where y=@