Upgrading 10.3 to 10.4

When migrating to a new Cadenza version:

  1. Check and update database schemas using the Database Migration Tool.

    • Backup your database before running the tool, as schema structures may change.

  2. Check and update the Cadenza API. The recommended version of Cadenza JS for use with this Cadenza version is v10.4.9 (see the release notes).

  3. If you use workbook reports with your own binaries of Chromium and ChromeDriver, check and update ChromeDriver. The version of ChromeDriver for use with this Cadenza version is v139 (see System Requirements).

Applying updates in sequence is strongly recommended, as skipping versions may lead to increased update effort.

Users and Cadenza administrators find additional migration notes in the user documentation.

Configuration Changes

Removed Plugins

The following plugins must be removed if present or Cadenza will not start:

  • AccessManager

  • Cadenza

  • Gis

  • JobScheduling

  • Scripting

  • Selector

  • TableAnalyzer

  • Workbook

  • Gis_Layer_Template

The removal of plugins does not affect the relevant configuration. Configuration for these plugins has become core functionality configuration, without any change to their mandatory/optional status.

The functionality previously provided by the plugins AccessManager, Cadenza, Gis, JobScheduling, and Workbook is now defined core functionality independent of plugins.

selectiondatasourcedatabase Configuration no Longer Used

The selectiondatasourcedatabase configuration (either as an XML configuration file called selectiondatasourcedatabase-config.xml or as a section called selectiondatasourcedatabase in the single file configuration) is no longer used by Cadenza. You should remove the settings from your configuration.

Pivot Table Configuration Moved to workbooktable Configuration

selection Configuration no Longer Used

The selection configuration is no longer used and should be removed. The optional pivotTable configuration has been moved from the selection configuration to the workbooktable configuration.

Cadenza’s Proxy Settings Used When Exporting PDF Reports

The proxy settings made in the core configuration are now also used for the configuration of the web driver configured in workbookreport that enables Exporting PDF Reports.

Disabling Client-Side Rendering

Previously, most map layers were rendered in the backend. Only route and isochrone layers were rendered in the frontend. Now, most map layers are rendered in the frontend by default.

If absolutely necessary, client-side rendering can be disabled for the entire application using the system property net.disy.web.backend.layer.rendering. By default off. Alternatively, users can now disable client-side rendering for individual data view layers of a map view (Designer > Data > Advanced data view settings).

Elasticsearch Version

Elasticsearch version 7 is no longer supported. Please use version 8 instead.