Skip to main content

How to update the Data Management Application to a newer version

Introduction​

This guide describes how to update an existing Data Management installation on Linux or Windows. It applies to environments where Data Management is already installed and running, and you want to upgrade to a newer compatible version (for example, within the 4.7.x release line).

This document focuses on what needs to be updated, what can be reused, and what must be verified after the update.

Supported Update Scenarios​

You can use this guide if:

  • PubServer is already installed and running
  • Data Management has been installed previously
  • You are updating:
    • The Data Management Spring Boot application
    • The Facet Core package
    • The Data Management Service (PubServer plugin) via PubServer update

⚠️ Cross--major-version upgrades may require additional migration steps. Always review the release notes before updating.

Prerequisites​

  • PubServer: Version 4.7.0.x (already installed)
  • Java SDK: Must match the target Data Management version (e.g. Java 21 for 4.7.0)
  • Existing configuration files backed up:
    • application.properties / application.yml
    • AuthService configuration (config.xml)
  • Access to Priint WebFTP

Update Overview​

ComponentUpdate Method
Data Management Spring Boot appReplace JAR file, add/update configuration and restart service
Facet Core PackageRedeploy deployment package
Data Management ServiceUpdated automatically with PubServer
AuthServiceVerify configuration (usually no change required)

1. Download the Updated Package​

Download the Data Management package that matches your target PubServer version.

Example for 4.7.0:

https://webftp.priint.com/#/priint_suite_4.7.0/publishing%20server%20add-on%20zips/latest/

Unzip the package on your local machine.

2. Update the Data Management Application (Spring Boot)​

2.1 Stop the Application​

Linux (systemd):

sudo systemctl stop data-management

Windows:

  • Stop the Windows service.

2.2 Replace the JAR File​

Copy the new JAR file from the package:

data-management-4.7.x.jar

Replace the existing JAR file.

Linux example:

/opt/pubserver/data-management/data-management.jar

Windows example:

C:\pubserver\data-management\data-management-4.7.jar

2.3 Reuse Existing Configuration​

  • Keep your existing application.properties or application.yml
  • Review release notes for newly introduced properties or required updated properties

2.4 Start the Application​

Linux (systemd):

sudo systemctl start data-management
sudo systemctl status data-management

Windows:

  • Start the Window service.

3. Update the Facet Core Package (If Used)​

Only required if you use the Facet module.

  1. Locate the updated Facet Core package (e.g. FacetCore_4.7.x.zip)
  2. Deploy it using the standard PubServer deployment package process
  3. Verify or reapply Facet Core configuration if required (please check the release note)

4. Data Management Service (PubServer Plugin)​

Starting from PubServer 4.7.0.805, the Data Management Service is:

  • Installed automatically
  • Updated automatically when PubServer is updated

No manual action is required.

After updating PubServer: verify the plugin is active

5. Verify AuthService Configuration​

Verify that the Data Management application is still registered.

File location: [path_to_domain]/config/AuthService/config.xml

Example:

<app name="priint:data-management" id="data-management" visible="true">
    <uri>[DATA-MANAGEMENT_HOME_PAGE]/auth/callback?sessionId={sessionId}</uri>
    <sessionCookieName>dataManagementSessionId</sessionCookieName>
</app>

Restart PubServer if changes are made.

7. Post-Update Validation Checklist​

  • Data Management UI loads correctly
  • Authentication via PubServer AuthService works
  • Required modules appear as expected:
    • Facet
    • Attribute Set
    • Content
  • No errors in:
    • Data Management logs
    • PubServer logs

Summary​

  • The update process is identical on Linux and Windows
  • Replace the Spring Boot JAR
  • Reuse existing configuration files
  • Redeploy Facet Core only if required
  • PubServer handles the plugin update automatically