Upgrade instructions

Stop all Active processes

An upgraded version of Runtime cannot run with existing (old) agents. Before upgrading Runtime, you should ensure the following:

All applications are stopped
Log in as an admin user and check the dashboard for any running applications. Do not upgrade until all applications have finished or been aborted.
All agents are stopped (As of the agent rework in runtime version 4.4.0 this is no longer a required step as inactive agents are automatically dropped!)
Log in as an admin user, go to Administration → Agents, and ensure all agents are set to "Unavailable."
Confirm DATPROF Runtime has shutdown
Open the Windows Task Manager and verify that no Runtime processes are still running.

It is also possible to stop both the Runtime service as well as all the Runtime agents by using the /a option (or -a on Linux) for the stopRuntime script.

Create a backup

Once the applications and agents have stopped and Runtime has shutdown, do the following:

Create a backup of your Runtime Data folder (previously also referred to as the "Home" folder)
If DATPROF Runtime is installed as a service, uninstall the service through the command-line.

Extract the new software

Extract the Runtime software into a NEW Runtime Installation Folder.

This will create a sub-folder named runtime-<version>.

Example: c:\Apps\Datprof\runtime-4.10.4

Important: Avoid installing a new version of Runtime over an existing installation. Always use a separate folder for the new version.

Installing a new version on top of the old one can lead to failures, system corruption, or invalidation of the current setup. To ensure a seamless installation process and maintain system integrity, always create a new directory for each version.

Start DATPROF Runtime

Start the new version of Runtime using the existing Data folder as a required Parameter

On Windows:

<New Runtime Installation Folder>\runtimeStart.bat <RuntimeDataFolder>

On Linux:

<New Runtime Installation Folder>/runtimeStart.bat <RuntimeDataFolder>

Before Runtime upgrades, the following steps will take place automatically:

A new runtime.properties file is generated in the conf folder within the <RuntimeDataFolder>.
The contents of the existing db.properties file are merged into the newly created runtime.properties file.
The db.properties file is removed after the merge process is completed.

Once these steps are complete, you can proceed to reconfigure the new Runtime version as a service, following the provided guide.