...
This installation guide assumes a newly installed Tomcat 7 or Tomcat 8 application server. For migrating existing installations from before FEWS 2017.02, see the paragraph on Migration.
It is important to adjust the JVM memory settings of tomcat. For Linux based installations,
On CentOS these settings can be set in the /usr/share/tomcat6/conf/tomcat6.conf file.
- JAVA_OPTS="-Dgeonetwork.dir=/var/lib/geonetwork_data -Dfile.encoding=UTF-8 -Xms128m -Xmx712m -XX:PermSize=128m -XX:MaxPermSize=128m -Dgeonetwork.search.temporal.extent.overrule=true"
On windows the JAVA_OPTS can be added to the sentenv.bat file in the tomcat bin directory.
FEWS Installation
The root of the tomcat installation is referred to as "${catalina.home}" and will be used from here. The root of a tomcat installation can be recognized by the webapps and conf directories.
FEWS Installation
If Tomcat is succesfully installed, the FEWS installation can be done.
...
In this folder a clientConfig.xml is required to configure a stand alone or Direct database access client. In the following code snippet the configuration of a Stand alone client can be seen.
| Code Block |
|---|
<?xml version="1.0" encoding="UTF-8"?>
<clientConfiguration xmlns="http://www.wldelft.nl/fews" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.wldelft.nl/fews http://fews.wldelft.nl/schemas/version1.0/clientConfig.xsd">
<clientType>Stand alone</clientType>
</clientConfiguration> |
the FewsWebServices.war can be installed using the standard installation options of Tomcat. See the tomcat deployment documentation for more information.
Config\PiClientConfigFiles\FewsPiService.properties
The only requirement for running the FewsWebServices is that a default filter is configured in FEWS. This can be done in
2 two different ways
. :
Configure a default filter in the Filters.xml of the FEWS configuration
or configure Default Filter
...
with the name of the filter that should be used for all webservice requests.
Alternatively a property file can be used to configure the default filter (and other properties as well). The property file should be located at: "${catalina.home}/fews/Region_Home/Config/PiClientConfigFiles/FewsPiService.properties. In the following code snippet the default filter to be used by the FEWS Web Services is configured using the property key "FILTER_ID" where the filter "All" has been configured.
N.B.: In version before FEWS 2017.02 it was possible to override the FewsPiService.properties with another name or location. This is no longer supported. Only one property file can be used for all services and the name is fixed.
If the previous configurations have been applied.
the FewsWebServices.war can be installed using the standard installation options of Tomcat. See the tomcat deployment documentation for more information. Migrations from before 2017.02
...