...
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, but preferably more. 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.
For general Tomcat installation instructions, please see: 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.
Web Services log files
After upgrading the FewsWebServices.war, old log files have to be deleted. The log files are stored in: ${catalina.home}/fews/Region_Home folder. All *.txt files should be deleted.
...
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>/FewsDatabaseHttpsProxy jdbc: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 should not be specified when using AD (Active Directory). |
FEWS_WS_DATABASE_ENCRYPTED_PASSWORD | Encrypted Database password. The password should be 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". |
FEWS_WS_CLIENTCONFIGFILEID | Optional. Name of the client config file from the Delft-FEWS Configuration folder: PiClientConfigFiles. Default is: FewsPiService.properties |
An example of configured environment variables.
...