| Table of Contents |
|---|
Introduction
Since FEWS 2017.02 all FEWS Web Services have been unified into one installation package (FewsWebServices.war). The following WebServices are available with this installation using HTTP(s):
- PI-XML SOAP Web Service: The PI-XML SOAP Service can be accessed by the SOAP protocol.
- PI-XML REST Web Service: The PI-XML REST Service provides a REST based interface using the REST protocol.
- WaterML Web Service: The WaterML2 Web Service can be accessed by the WaterML protocol.
- Digital Delta Web Service: The Digitale Delta Web Service can be accessed by the REST protocol.
- Umaquo Web Service: The Umaquo Web Service can be accessed by the SOAP protocol.
Tomcat Installation
To install the FEWS Web Services at least the Tomcat 7 application server is required. See: https://tomcat.apache.org/download-70.cgi
...
The requirements of the Java version to be used for Tomcat is the same as for the FEWS version that is being used.
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.
If Tomcat is succesfully installed, the FEWS installation can be done.
FEWS should be installed in the root folder of tomcat in the directory "${catalina.home}/fews/Region_Home".
In this folder a clientConfig.xml is required to configure a stand alone or Direct database access client.
Config\PiClientConfigFiles\FewsPiService.properties
Config\PiClientConfigFiles\FewsPiService.properties
| 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 ways. Configure a default filter in the Filters.xml of the FEWS configuration or configure
...