HomeDocumentation > Configuring and administering > Configuring and administering the Apache Geronimo Server > Configuring JAX-WS engine
{scrollbar}

INLINE

Apache Geronimo 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:

On a Windows system: set GERONIMO_OPTS=-Dorg.apache.geronimo.jaxws.provider=axis2
On a Unix-like system: 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:

On a Windows system: set GERONIMO_OPTS=-Dorg.apache.geronimo.jaxws.provider=cxf
On a Unix-like system: 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//car module.
  2. Remove the condition attribute and add the load="true" attribute to org.apache.geronimo.configs/axis2-deployer//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//car module.
  2. Remove the condition attribute and add the load="true" attribute to org.apache.geronimo.configs/cxf-deployer//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 where 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 the Axis2 SAAJ implementation, set the org.apache.geronimo.saaj.provider system property to axis2. For example:

    On a Windows system: set GERONIMO_OPTS=-Dorg.apache.geronimo.saaj.provider=axis2
    On a Unix-like system: 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.

    Note that these options have not been tested.