Deploy as root application

A Simplicité instance can be deployed as the root application on an application server.

Note: This is the default with the cloud instance templates.


When using the Tomcat web container the root application is webapps/ROOT.

Application name property

The property WEB-INF/classes/ must be changed to an empty value:

License key

The license key context path must be / or *.

Embedded work and dbdoc folders

When using "exploded" deployment it is possible to embed the work and dbdoc folders in the WEB-INF folder. This approach is, for instance required, when deployng on CloudFoundry.

To do so the default dataDir environment entry if defined in the WEB-INF/web.xml file must be changed to:


This dataDir environment entry can also be defined in the META-INF/context.xmlfile, in this case the change is:


Note: Alternatively the root data dir can be defined by a JVM argument -Ddata.dir=... when lauching Tomcat or by setting a DATA_DIRenvironment variable.

And the log file location defined in the WEB-INF/classes/log4j.xml file must also be changed to:

<appender name="SIMPLICITE-FILE" class="org.apache.log4j.DailyRollingFileAppender">
    <param name="File" value="${catalina.base}/webapps/ROOT/WEB-INF/log/simplicite.log"/>
    <param name="Append" value="false"/>
    <param name="Threshold" value="DEBUG"/>
    <param name="DatePattern" value="'.'yyyy-MM-dd"/>
    <layout class="org.apache.log4j.PatternLayout">
    <param name="ConversionPattern" value="%d %-5p [%c] %m%n"/>

Embedded HSQLDB folder

If using HSQLDB and "exploded" deployment, it is also possible to embed the database folder in the WEB-INF folder.

To do so the data source JDBC URL defined in the META-INF/context.xml file must be changed to:

    maxActive="100" maxIdle="30" maxWait="10000"
    username="sa" password=""
    url="jdbc:hsqldb:file:${catalina.base}/webapps/ROOT/WEB-INF/db/<database name>;shutdown=true"/>

The <database name> must match the name of the HSQLDB database (which is also the base file name of the HSQLDB files).