summaryrefslogtreecommitdiff
path: root/BKUOnline/src/site/apt/configuration.apt
blob: a751b57f15ad8a0c51647405df0341f26450b86c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
	---
	Configuration
	---
	EGIZ
	---
	2010
	---
	
MOCCA Online Configuration

	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 {{{http://static.springsource.org/spring/docs/2.5.5/reference/resources.html}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 {{{Apache Tomcat}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 {{{http://static.springsource.org/spring/docs/2.5.5/reference/resources.html}Spring resource}} name. Placeholders such as <<<$\{user.home\}>>> are also supported (via {{{http://static.springsource.org/spring/docs/2.5.5/api/org/springframework/beans/factory/config/PropertyPlaceholderConfigurer.html}Spring's Property Placeholder Configurer}}).
	
* Apache Tomcat
	
	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.
	
* Configuration Options

	For the available configuration options please see {{{../bkucommon/configuration.html}MOCCA Configuration}}.