Upgrading deegree webservices - deegree/deegree3 GitHub Wiki

From 3.5.x to 3.6.0

NOTE: Before upgrading to version 3.6 install the latest version of 3.5 (at least 3.5.13) and verify your active configurations!

Changes in prerequisites and runtime environment :computer:

  • Supports Java 17
  • Supports Java Servlet API 6.0 compliant container (e.g Apache Tomcat 10.1+)
  • Supports PostgreSQL 16.0+ with PostGIS 3.4+
  • Supports Oracle 19c, 21c, 23ai
  • Supports MS SQL Server 2016, 2017, 2019, 2022

Changes in configuration files :boom:

  • Issue #1616/PR #1708: The password format for the file console.pw changed. Users need to re-create their password used by the deegree admin console when upgrading to deegree 3.6.
  • Issue #1248/PR #1783: The default logging provider changed from Apache Log4j2 to Logback. This requires adopting the logging configuration or to re-enable Apache Log4j2 by adding libraries and configuration files.

Changes in behavior :heavy_exclamation_mark:

  • Issue #1822/PR #1833: When processing a WMS GFI request on a group layer all queryable sub-layer are issued now.

From 3.4.x to 3.5.0

NOTE: Before upgrading to version 3.5 install the latest version of 3.4 (at least 3.4.35) and verify your active configurations!

Changes in prerequisites and runtime environment :computer:

Changes in configuration files :boom:

  • Issue #1495/PR #1496: The XML schema location has been changed. To enable code completion for the last available feature set within your IDE while editing the deegree configuration files you have to change the schema location to https://schemas.deegree.org/core/3.5/.
  • Issue #1017/PR #1337: Requires changes to all JDBC database connection files using Apache DBCP:
    • the driverClassName changed from org.apache.commons.dbcp.BasicDataSource to org.apache.commons.dbcp2.BasicDataSource (Notice the 2 in the package name dbcp2!)
    • the maxActive configuration option has been renamed to maxTotal
    • the maxWait configuration option has been renamed to maxWaitMillis
    • the removeAbandoned configuration option has been replaced by removeAbandonedOnBorrow and removeAbandonedOnMaintenance
  • Issue #1157/PR #1441: Syntax of ehcache configuration changed

Changes in behavior :heavy_exclamation_mark:

  • Issue #1102/PR #1442: deegree no longer sends a version header by default in HTTP response.
  • Issue #1494/PR #1489: for protecting deegree's REST API against un-authorized access use the HTTP header or parameter instead of BASIC HTTP Authentication.

Changes in data and storage ⚠️

  • ensure that the PostgreSQL database used for SQLFeatureStore with BLOB mode have the SRID set.