You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 12 Next »

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.

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.
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. In the following code snippet the configuration of a Stand alone client can be seen.

 

<?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 only requirement for running the FewsWebServices is that a default filter is configured in FEWS. This can be done in two different ways:
Configure a default filter in the Filters.xml of the FEWS configuration 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.
FILTER_ID=All

 

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

In case an existing FEWS web service has to be migrated to the 2017.02 or later version, the following changes should be taken into account.

URL change for the FEWS PI-XML REST Service.

 

ToDo

Migration manual:

Removing dac.jar -> Also remove LifeCycle listener from server.xml

Wat als er gestart wordt met een firebird local datastore?

FewsPiService.properties verplicht? Ook als er geen filter is geconfigureerd?

"No default filter id defined! Either configure the default filter id in Filters.xml file or configure FILTER_ID in FewsPiService properties file in the PiClientConfigFiles folder of the FEWS configuration"

umaquo uit test pages gehaald.

Temp en Work folder leegmaken. Niet weggooien!.

Bij fouten controleren of the temp dir bestaat.

clientConfig.xml required?

Patches?

Default property for waterml has changed from waterml.properties into 

 

 

  • No labels

Disclaimer