Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

Starting from WSO2 AS 5.3.0, AS supports JavaEE 6 Web Profile. This support is provided using Apache TomEE, which is a project developed at Apache Software Foundation, and is a Java EE 6 Web Profile certified stack. 

In order to deploy javaee webapps in AS (which are written targeting TomEE), the following configurations should be in place: 

Enabling the JavaEE runtime

WSO2 leverages a concept called runtime environments to maintain separate runtimes. You can enable the following runtime environments in WSO2 AS: CarbonTomcatCXF and Javaee. See the topic on configuring runtime environments for more descriptive information. Shown below is the configuration to specify 'Javaee' as the runtime environment.

  1. Open the webapp-classloading.xml file stored in the META-INF folder of your web application.
  2. Enter the following class loading details to enable the Javaee runtime:

    <Classloading xmlns="">
  3. You can add other runtimes, in addition to Javaee, by entering a comma separated list for the <Environments> element.

  4. The support for Javaee is provided along with Apache TomEE. If you use the Javaee runtime, then TomEE should also be configured in AS as explained below.

Configuring TomEE

The following configurations are required if the Javaee runtime is enabled for your AS as explained above. There are two Apache TomEE configurations:

  • Setting the default Tomee configurations: 

    1. Open the tomee.xml file located in the <AS_HOME>/repository/conf/tomee/ directory.

    2.  In this file, you can configure the Datasources, Resources etc. See the following example where the "myDerbyDatasource" datasource is configured as a resource.

      <Resource id="myDerbyDatasource" type="DataSource" classpath="/path/to/driver.jar">
       . . . .
    3. See the documentation on Apache TomEE configurations for more examples on how to configure the tomee.xml file.

  • Setting the jvm system properties that will be used by TomEE:

    1. Open the file located in the <AS_HOME>/repository/conf/tomee/ directory. 

    2. Update the required properties. For a comprehensive list of system properties, see

  • No labels