HomeDocumentation > Administration > Administrative tasks > Administering the Apache Geronimo Server > Configure JAX-WS engine

Apache Geronimo 2.0 is distributed with two JAX-WS engines: Apache Axis2 and Apache CXF. The Geronimo-Jetty assembly defaults to use CXF as its JAX-WS engine whereas the Geronimo-Tomcat assembly uses Axis2.

There are two ways to configure which JAX-WS engine should be used:

Setting a system property

To configure Axis2 as Geronimo's JAX-WS engine, set the org.apache.geronimo.jaxws.provider system property to "axis2". For example:

export GERONIMO_OPTS="-Dorg.apache.geronimo.jaxws.provider=axis2"

To configure CXF as Geronimo's JAX-WS engine, set the org.apache.geronimo.jaxws.provider system property to "cxf". For example:

export GERONIMO_OPTS="-Dorg.apache.geronimo.jaxws.provider=cxf"

Changing the configuration file

To configure Axis2 as Geronimo's JAX-WS engine, modify the $GERONIMO_HOME/var/config/config.xml file in the following way:

  1. Remove the condition attribute and add the load="false" attribute to org.apache.geronimo.configs/cxf-deployer/2.0/car module.
  2. Remove the condition attribute and add the load="true" attribute to org.apache.geronimo.configs/axis2-deployer/2.0/car module.

To configure CXF as Geronimo's JAX-WS engine, modify the $GERONIMO_HOME/var/config/config.xml file in the following way:

  1. Remove the condition attribute and add the load="false" attribute to org.apache.geronimo.configs/axis2-deployer/2.0/car module.
  2. Remove the condition attribute and add the load="true" attribute to org.apache.geronimo.configs/cxf-deployer/2.0/car module.

SAAJ engine

By default, CXF will use Sun's SOAP with Attachments API for Java (SAAJ) implementation. That implementation requires Sun JDK. There are a few options for platforms were Sun JDK is not available:

  1. Switch to Axis2 SAAJ implementation. In Geronimo you can configure which SAAJ provider should be used by setting the org.apache.geronimo.saaj.provider system property. To use Axis2 SAAJ implementation set the org.apache.geronimo.saaj.provider system property to "axis2". For example:

    export GERONIMO_OPTS="-Dorg.apache.geronimo.saaj.provider=axis2"

  2. Add Sun XML parser jar to the classpath. Download: https://maven-repository.dev.java.net/nonav/repository/com.sun.xml.parsers/jars/jaxp-ri-1.4.2.jar and put it in the $GERONIMO_HOME/lib/endorsed/ directory.

    Icon

    Please note that these options have not been tested.