Stop all Active processes


An upgraded verson of Runtime cannot run with existing (old) agents so before upgrading Runtime you should ensure that:

  • All applications are stopped.
    Login as an admin user and check the dashboard for running applications. Do not upgrade before all applications have finished (or aborted).

  • All agents are stopped
    Login as an admin user and select Configuration → Agents. Make sure all agents are set to "Unavailable" .*
  • DATPROF Runtime has shutdown.
    Shutdown the application**

*When having problems stopping the agents you can kill the javaw processes.

**When having problems shutting down the application you can kill the java proces.

(info)
 As of version 3.23.0 it is now 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)
  • Make a backup of your Runtime database
    Internal database
    When you use the internal database this backup is already done by the backup of your Runtime Data folder.
    External database (installed before Runtime 3.17)
    Make a backup of the Service Database User/Schema using you own database backup tooling.
  • If DATPROF Runtime is installed as a service, remove the service.


Extract the new software

Extract the Runtime software into a NEW Runtime Installation Folder.

This will create a subfolder named runtime-<version>.

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

(info) Never install the new version over the old version. Always use a new folder.


Start DATPROF Runtime 

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


Windows

<New Runtime Installation Folder>\runtimeStart.bat  <RuntimeDataFolder of Previous Version.>

Linux

<New Runtime Installation Folder>/runtimeStart.bat  <RuntimeDataFolder of Previous Version.>


Before starting the application it will do three things:

1- Create a new runtime.properties in the conf folder of <RuntimeDataFolder>

2- Merge the db.properties file with the runtime.properties.

3- Remove the db.properties file.

(info) Datprof Runtime does not require any configuration file in the DATPROF Runtime Installation Folder anymore.


At this point you can reconfigure the new Runtime version as a service using /runtime/latest/runtime-installation/install-runtime-as-a-windows-service as a guide.