...
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.
It is recommended to give a tomcat a heapsize of at least 1GByte. This can be done using the -Xmx1024m java argument. Since 2019.02 the FEWS Web Services won't start if there is not enough memory available. For general instructions on installing tomcat, see also: Delft-FEWS Installation - Install Apache Tomcat.
FewsWebServices.war installation
The FEWS Web Services are packaged in a file called the FewsWebServices.war. Before installation, make sure the tomcat server has been shutdown. Inspect the ${catalina.home}/webapps folder and inspect if there is a FewsWebServices folder. If this folder exists, delete the ${catalina.home}/webapps/FewsWebServices folder. The FewsWebServices.war file has to be copied to the ${catalina.home}/webapps folder.
Delft-FEWS Web Services Installation
If Tomcat is successfully installed and the FewsWebServices.war deployed, the FEWS configuration installation can be done. FEWS itself (i.e. the bin\ folder) is packaged inside the FewsWebServices.war. Please see below for notes regarding a Stand Alone Delft-FEWS application used in combination with the FEWS Web Services.
Direct database access using ENV variables (since 2020.02)
Since 2020.02 it is possible to install the Delft-FEWS Web Services by only providing Environment variables. This is the recommended way of configuration.
The environment variables can be set with SETX /M for windows or in the systemd configuration file for Linux. Run SETX /M makes variables available for all (service) user accounts.
| user environment variable | description |
|---|---|
FEWS_WS_CLIENT_CONFIG_FILE_NAME | Name of the client config file as available in the RootConfigFiles folder of the uploaded Delft-FEWS configuration. ClientType has to be: Web Services |
FEWS_WS_DATABASE_URL | Database url, e.g. jdbc:vjdbc:servlet:https://<host>:<port>/FewsDatabaseHttpsProxyjdbc:postgresql://<host>:<port>/<databaseName>jdbc:oracle:thin:@<host>:<port>:<sid> or jdbc:sqlserver://<host>:<port>;DatabaseName=<databaseName> |
| FEWS_WS_DATABASE_USER | Database user name to connect with. The name is not specified when using AD (Active Directory). |
| FEWS_WS_DATABASE_ENCRYPTED_PASSWORD | Encrypted Database password. The password is not specified when using AD (Active Directory).. |
| FEWS_WS_HOME | Optional. Folder where caches are stored. If not configured, it will be set to the "${catalina.home}/fews/Region_Home" |
An example of configured environment variables. Take not the reference
| Code Block | ||||
|---|---|---|---|---|
| ||||
FEWS_WS_DATABASE_URL=jdbc:postgresql://localhost:6001/fewsdb00
FEWS_WS_DATABASE_USER=fews00
FEWS_WS_DATABASE_ENCRYPTED_PASSWORD=myencryptedpassword
FEWS_WS_CLIENT_CONFIG_FILE_NAME=ws_clientConfig.xml
FEWS_WS_HOME=d:\fews-ws\region-home |
The clientConfiguration should be of type "Web Services" and a global.properties file is required. The configurated property file will be used by the Delft_FEWS configuration.
| Code Block | ||||
|---|---|---|---|---|
| ||||
<?xml version="1.0" encoding="UTF-8"?>
<clientConfiguration xsi:schemaLocation="http://www.wldelft.nl/fews http://fews.wldelft.nl/schemas/version1.0/clientConfig.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.wldelft.nl/fews">
<title>My WebServices Client</title>
<clientType>Web Services</clientType>
<otherRootConfigFiles>
<name>oc_global.properties</name>
</otherRootConfigFiles>
</clientConfiguration> |
Direct database access using clientConfig.xml
clientConfig.xml
Direct database access has to be configured in the "${catalina.home}/fews/Region_Home" directory. Make sure the exact folder names are use (case sensitive on linux): /fews/Region_Home
...