Axis2 with Rampart

Axis2/Rampart Installation

How to install or upgrade Axis2 + rampart.mar

Note: this procedure is now done by the do_build.sh script. We are currently using a post 1.4 SNAPSHOT due to a security bug in the 1.4 release. So do not follow these instructions until a 1.5 release is available.

To Build

The OSCARS code uses the the WSSE functionality provided by the ramapart.mar to digitally sign and verify SOAP messages. So when you install axis2 you must include the rampart.mar.

Download the axis2 distribution from http://ws.apache.org/axis2 and the rampart module from http://ws.apache.org/axis2/modules/index.html. 

Extract the zip files into a common directory

Set the environment variable $AXIS2_HOME to the directory in which axis was unzipped.

Run ant in the rampart-1.4 directory. This will copy the rampart jars to axis2 lib.

In the axis2-1.4/webapp directory, edit the create.war target in build.xml to remove the lines:     

     <exclude name="axis2-adb-codegen*.jar">
     <exclude name="axis2-codegen*.jar"/>
     <exclude name="jibx-bind*.jar"/>

Edit the conf/axis2.xml file to engage rampart by adding following line to the Global Modules section.
   

    <module ref="rampart"/>

If you want a better chance at debugging errors change DrillDownToRootCause to true and sendStackTraceDetails to true.

Then run ant to create an axis2.war file that includes rampart and its required classes.

You should then copy all the axis2 jar files into OSCARS/lib/axis2 in your OSCARS distribution /lib directory.  (Now done by the ant task axis2localcopy called by prepare.)

Axis2 Configuration

$CATALINA_HOME/webapps/axis2/WEB-INF/web.xml

defines servlets, e.g SOAPMonitor. AdminServlet,Axis2Servlet

maps urls to servlet names, and servlet names to class

$CATALINA_HOME/webapps/axis2/WEB-INF/conf/axis2.xml

Defines parameters like enableMTOM, username, password (for axis admin)

defines messageRecievers, transportReceivers(http, tcp, smtp

Engage global modules like SOAPMonitor and rampart

defines phase order (added soapMonitor phase)

$CATALINA_HOME/webapps/axis2/WEB-INF/classes/log4j.properties

Our version is copied from conf/server/axis2.log4j.properties by the ant target deployaar. The OSCARS.aar gets it from here and not from within OSCARS.aar.

To Install

Copy the new axis.2war file into $CATALINA_HOME/webapps/

If Tomcat is configured with autoDeploy set to true, the new war will be automatically started. Otherwise you will need to shutdown and restart Tomcat.