Running Axis2 on the 'little-G' version of Geronimo

Geronimo 2.0.1 already has an option of using Axis2 internally for deploying JAXWS services. Here we are looking at how to deploy Axis2 as a war for more advanced scenarios.

Introduction

Geronimo has a stripped down version of its distribution affectionately called little-G. In this article we look at how easy it is to deploy Axis2 war distribution on little-G.

Background

Please download the following zip's from the Apache web site and unzip them:

Geronimo - Little-G 2.0.1 with Tomcat 6 (zip) [1]
Axis2 - 1.3 WAR (Web Archive) Distribution [2]

Start the Little-G server

To start Geronimo, type the following command:

<geronimo_home>\bin\geronimo run

Depending on the operating system you are using, you should see a screen similar to this:

C:\geronimo-tomcat6-minimal-2.0.1\bin>geronimo run
Using GERONIMO_BASE:   C:\geronimo-2.0.1
Using GERONIMO_HOME:   C:\geronimo-2.0.1
Using GERONIMO_TMPDIR: var\temp
Using JRE_HOME:        C:\JDK15\jre
Booting Geronimo Kernel (in Java 1.5.0_11)...
Starting Geronimo Application Server v2.0.1
[******>             ] 33%   6s Starting org.apache.geronimo.config...17:36:12,080 ERROR [[/]] "Restricted listeners property file not found
[********************] 100%  16s Startup complete
Listening on Ports:
1099 0.0.0.0 RMI Naming
8009 0.0.0.0 Tomcat Connector AJP AJP
8080 0.0.0.0 Tomcat Connector HTTP BIO HTTP
8443 0.0.0.0 Tomcat Connector HTTPS BIO HTTPS
9999 0.0.0.0 JMX Remoting Connector
Started Application Modules:
WAR: default/axis2/1188415013265/war
WAR: org.apache.geronimo.configs/remote-deploy-tomcat/2.0.1/car
Web Applications:
/axis2
/remote-deploy
Geronimo Application Server started

Deploy Axis2 war

Unzip the axis2-1.3-war.zip to extract axis2.war

To deploy axis2.war to Geronimo type the following command:

<geronimo_home>\bin\deploy.bat --user system --password manager deploy c:\download\axis2.war

Depending on the operating system you are using, you should see a screen similar to this:

C:\geronimo-tomcat6-minimal-2.0.1>bin\deploy.bat --user system --password manager deploy c:\download\axis2.war
Using GERONIMO_BASE:   C:\geronimo-tomcat6-minimal-2.0.1
Using GERONIMO_HOME:   C:\geronimo-tomcat6-minimal-2.0.1
Using GERONIMO_TMPDIR: var\temp
Using JRE_HOME:        C:\JDK15\jre
Deployed default/axis2/1188423684026/war @ /axis2

That's it folks! You can then point your browser to http://localhost:8080/axis2/ [3] to verify if all's well.

Summary

Axis2 war distribution and Geronimo's stripped down little-G distribution is a very handy combination for deploying Axis2 based web services

Applies To

1. Axis2 1.3 / Geronimo 2.0.1

More Information

Slightly old version of the little-G documentation [4]