MOCCA Online comes with a reasonable default configuration. Therefore, providing your own configuration is only required when you need configuration options different from the default parameters.
Since MOCCA version 1.3 a configuration resource may be specified as servlet context init parameter. This allows to keep your configuration resource outside of the deployed servlet context and to redeploy the web application without overwriting your configuration resource.
To specify your own configuration resource simply set the corresponding servlet context init parameter configurationResource. Please refer to the documentation of your servlet container on how to set servlet context initialization parameters. Usually this is done via the web.xml file in your web application. (Apache Tomcat users are recommended to use context parameters as shown below.)
WEB-INF/web.xml:
...
<web-app>
...
<context-param>
<param-name>configurationResource</param-name>
<param-value>file://mocca/configuration.xml</param-value>
</context-param>
...
</web-app>The value of the configurationResource parameter must be a valid Spring resource name. Placeholders such as ${user.home} are also supported (via Spring's Property Placeholder Configurer).
In addition to the specifying init parameters in the web.xml Apache Tomcat also allows to provide a file named $CATALINA_BASE/conf/[enginename]/[hostname]/[webappname].xml (e.g. .../conf/Catalina/localhost/mocca.xml) to specify context parameters. See also http://tomcat.apache.org/tomcat-6.0-doc/config/context.html.
The configurationResource parameter may be specified like the following:
<?xml version="1.0" encoding="UTF-8"?>
<Context>
<Parameter name="configurationResource" value="file:${user.home}/mocca/configuration.xml" override="false"/>
</Context>
This way, the init parameter is not overwritten when the web application is redeployed.
For the available configuration options please see MOCCA Configuration.