Stop all Active processes
An upgraded version 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 Administration → Agents. Make sure all agents are set to "Unavailable" .*
- DATPROF Runtime has shutdown. To check this, open the Windows Task Manager and confirm there are no Runtime processes still running.
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
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 sub-folder named runtime-<version>.
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 a required Parameter
<New Runtime Installation Folder>\runtimeStart.bat <RuntimeDataFolder of Previous Version.>
<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.
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.