[Apache Geronimo Wiki] New: HowToAxisGeronimo

[ge...@incubator.apache.org]

   Date: 2004-05-12T05:31:23
   Editor: PhilipMarkDonaghy <ph...@yahoo.com>
   Wiki: Apache Geronimo Wiki
   Page: HowToAxisGeronimo
   URL: http://wiki.apache.org/geronimo/HowToAxisGeronimo

   Initial version

New Page:

== Axis 1.2 Web Application Installation ==

Before continuing with HowToTutorial we must install and test the Axis web application within Geronimo.

Download the Axis binaries. We are using 1.2 beta

cd $AXIS_HOME/webapps/axis

Create a geronimo-jetty.xml, our's looks like this,

<?xml version="1.0" encoding="UTF-8"?>
<web-app
    xmlns="http://geronimo.apache.org/xml/ns/web/jetty"
    configId="org/apache/axis/webapp"
    parentId="org/apache/geronimo/Server"
    >
    <context-root>/axis</context-root>
    <context-priority-classloader>false</context-priority-classloader>
</web-app>

Modify the web.xml so that Jetty is happy. Working version below,

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://java.sun.com/xml/ns/j2ee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"
         version="2.4">
    <display-name>Apache-Axis</display-name>

    <listener>
        <listener-class>org.apache.axis.transport.http.AxisHTTPSessionListener</listener-class>
    </listener>

  <servlet>
    <servlet-name>AxisServlet</servlet-name>
    <servlet-class>
        org.apache.axis.transport.http.AxisServlet
    </servlet-class>
  </servlet>

  <servlet>
    <servlet-name>AdminServlet</servlet-name>
    <servlet-class>
        org.apache.axis.transport.http.AdminServlet
    </servlet-class>
    <load-on-startup>100</load-on-startup>
  </servlet>

  <servlet>
    <servlet-name>SOAPMonitorService</servlet-name>
    <servlet-class>
        org.apache.axis.monitor.SOAPMonitorService
    </servlet-class>
    <init-param>
      <param-name>SOAPMonitorPort</param-name>
      <param-value>5001</param-value>
    </init-param>
    <load-on-startup>100</load-on-startup>
  </servlet>

  <servlet-mapping>
    <servlet-name>AxisServlet</servlet-name>
    <url-pattern>/servlet/AxisServlet</url-pattern>
  </servlet-mapping>

  <servlet-mapping>
    <servlet-name>AxisServlet</servlet-name>
    <url-pattern>*.jws</url-pattern>
  </servlet-mapping>

  <servlet-mapping>
    <servlet-name>AxisServlet</servlet-name>
    <url-pattern>/services/*</url-pattern>
  </servlet-mapping>

  <servlet-mapping>
    <servlet-name>SOAPMonitorService</servlet-name>
    <url-pattern>/SOAPMonitor</url-pattern>
  </servlet-mapping>

 <!-- uncomment this if you want the admin servlet -->
 <!--
  <servlet-mapping>
    <servlet-name>AdminServlet</servlet-name>
    <url-pattern>/servlet/AdminServlet</url-pattern>
  </servlet-mapping>
 -->

    <session-config>
        <!-- Default to 5 minute session timeouts -->
        <session-timeout>5</session-timeout>
    </session-config>

    <!-- currently the W3C havent settled on a media type for WSDL;
    http://www.w3.org/TR/2003/WD-wsdl12-20030303/#ietf-draft
    for now we go with the basic 'it's XML' response -->
  <mime-mapping>
    <extension>wsdl</extension>
     <mime-type>text/xml</mime-type>
  </mime-mapping>


  <mime-mapping>
    <extension>xsd</extension>
    <mime-type>text/xml</mime-type>
  </mime-mapping>

  <welcome-file-list id="WelcomeFileList">
    <welcome-file>index.html</welcome-file>
    <welcome-file>index.jsp</welcome-file>
    <welcome-file>index.jws</welcome-file>
  </welcome-file-list>

</web-app>

Add the additional jars required by Axis. Our axis/WEB-INF/lib looks like this,

activation.jar
axis-ant.jar
axis.jar
commons-discovery.jar
commons-logging.jar
jaxrpc.jar
log4j-1.2.8.jar
mail.jar
saaj.jar
wsdl4j.jar
xmlsec.jar

Note : See also the tag dependancy for an alternative way of using libraries.

Create a the axis.war

jar -cf ../axis.war *

Deploy the war

cd incubator-geronimo/target

java -jar bin/deployer.jar --install --module axis.war

Start the Geronimo server

java -jar bin/server.jar org/apache/axis/webapp

http://localhost:8080/axis/happyaxis.jsp should report total bliss.

More information is available at the root of the context, http://gisig.com:8080/axis/