There are several sources of configuration properties. If property isn't set, application default is used.
Warning: Do not combine sources specified below. Configuration becomes confusing and maintenance will be much more difficult.
Some application servers allows to set context parameters without modification of WAR file. This way of configuration is possible and recommended for Tomcat.
On Tomcat it is possible to specify context parameters in context
configuration file.
[tomcat_home]/conf/Catalina/localhost/clover.xml
which is created automatically just after deployment of CloverETL Server
web application.
You can specify property by adding this element:
<Parameter name="[propertyName]" value="[propertyValue]" override="false" />
Set system environment property with prefix
clover. , i.e.
(clover.config.file)
Source is common properties file (text file with key-value pairs):
[property-key]=[property-value]
By default CloverETL tries to find config file
[workingDir]/cloverServer.properties.
The same as above, but properties file is not loaded from default
location, because its location is specified by environment property
clover_config_file or
clover.config.file. This is recommended way of
configuration if context parameters cannot be set in application
server.
Unzip clover.war and modify file
WEB-INF/web.xml, add this code:
<context-param> <param-name>[property-name]</param-name> <param-value>[property-value]</param-value> </context-param>
This way isn't recommended, but it may take place when none of above ways is possible.
Configuration sources have these priorities:
context parameters (specified in application server or
directly in web.xml)
external config file CS tries to find it in this order (only one of them is loaded):
path specified by context parameter
config.file
path specified by environment property
clover_config_file or
clover.config.file
default location
([workingDir]/cloverServer.properties)
environment properties
default values