...
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 changes
FEWS PI-XML Web Service
The change that has the largest impact on the URLs of the Web services is the changed context path (the URL part after the servername + port). Before 2017.02 every FEWS Web service has its own context path. Since 2017.02 all webservices have the same context path, which is FewsWebServices by default.
...
If it is required to keep the endpoints backwards compatible, the FewsWebServices.war can be renamed into FewsPiServices.war.
PI-XML REST Web Service
For the PI-XML REST Web Service it is not possible to keep the endpoints backwards compatible since the "rest" path is now a required part of the endpoint.
http://localhost:8080/FewsWebServices/rest/fewspiservice
Tomcat installation changes
Cleanup
It is advisable to cleanup the ${catalina.home}/temp and ${catalina.home}/work
ToDo
...
folder. N.B. Don't delete the folders themselves, only their content!
DAC
Previously the FEWS Web services required a DAC.jar to be installed. Since 2017.02 this component is obsoleted and should be removed from existing tomcat installations. See also the tomcat installation guide.
To uninstall the DAC.jar it should be removed from the lib directory. Also the ${catalina.home}/conf/server.xml should be cleaned up. The reference to the DacLifecycleListener should be removed from the server.xml:
| Code Block |
|---|
<Listener className="nl.wldelft.fews.system.data.dac.DacLifecycleListener" /> |
Also a reference to the fews_dac resource should be removed:
| Code Block |
|---|
<Resource name="fews_dac" auth="Container"
type="nl.wldelft.fews.system.data.dac.DataAccessComponent"
factory="nl.wldelft.fews.system.data.dac.DacBeanFactory"
regionHome="${catalina.home}/fews/Region_Home"
binPath="${catalina.home}/fews/bin/"
closeMethod="stop"
/> |
From the ${catalina.home}/conf/Catalina/localhost old xml configurations with references to the old servces should be removed.
Stand Alone Local Data Stores Derby only
When using a stand alone configuration with an existing local data store, not that only the derby database datastore is supported for the Fews Web Services. Existing firebird datastores can be converted into a derby datastore using FEWS F12/Database/Replicate Central Database option.
Default property for waterml has changed from waterml.properties into