Skip to main content
Skip table of contents

Installation instructions

Preparation

 Before installing check the following items:

  • You must be logged in on the server as the user that will normally start Runtime.

  • You need a writable folder to extract the Runtime zip file into. This will be the Runtime Installation Folder.

  • You need an existing empty folder to store all the Runtime data.
    From this point onward, we'll be referring to this folder as the Runtime Data folder. This folder will get populated with all the information used by the customer (log files, projects, and other information), and can be maintained between versions of Runtime when updated.

Installation Path Examples

Windows

Folder

Example Location

Runtime Installation Folder

c:\Apps\Datprof\Runtime

Runtime Data folder

c:\Data\RuntimeData

Linux

Folder

Example Location

Runtime Installation Folder

/usr/app/datprof/runtime

Runtime Data Folder

/home/datprof/runtimeData

Extract the software

Extract the Runtime software in the Runtime Installation Folder.

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

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

Network setting configuration

In case the user needs to use a non-standard network configuration, this can be achieved by editing the runtime.properties file in the conf sub-folder of the runtime data folder. This folder is automatically created upon first time execution.

Runtime Properties file

runtime.properties

CODE
#Mon Oct 31 14:17:01 CET 2022

#Runtime agent settings
agents.scheduler.interval_ms=100
agents.autostart=true

#Runtime network settings
server.port=7070

#Database settings
db.url=jdbc\:hsqldb\:hsql\://localhost/runtime
db.dialect=org.hibernate.dialect.HSQLDialect
db.driver=org.hsqldb.jdbcDriver
db.port=9003
db.username=SA
db.password=

#Stomp settings
broker.stomp.host=localhost
broker.stomp.port=61613

#JMS settings
broker.jms.port=61616
broker.jms.host=localhost

#Spring settings
spring.servlet.multipart.max-file-size=50MB
spring.servlet.multipart.max-request-size=50MB
spring.jpa.open-in-view=false

Using these settings, the user can edit things such as ports over which the various brokers we use communicate, and over which port Runtime is hosted.

Start DATPROF Runtime

Now execute the Runtime startup script using the Datprof Runtime Data Folder as a required parameter

  • Windows: <Runtime Installation Folder>\runtimeStart.bat  <Runtime Data Folder>

  • Linux: <Runtime Installation Folder>/runtimeStart <Runtime Data Folder>

Datprof Runtime opens a window and once started the following message appears: "Runtime version <x.y.z> is ready: <IP-Address>:<PortNumber>"

Runtime CMD.png

DATPROF Runtime Starting Runtime in Linux.png

First time login

To connect to Runtime, you will need a web browser. Open the browser and enter the IP address and port number where Runtime is hosted. If you are using the machine where Runtime is installed, you can simply use localhost:7070 with the default configuration.

Upon connecting to the web interface, you will see a login page. Use the default credentials to log in:

  • Username: admin

  • Password: admin

Important: For security reasons, change the admin password immediately after logging in.

To update the password:

  1. Click the user profile icon in the top-right corner.

  2. Select Change Password from the drop-down menu.

When logging in for the first time, a message may appear in the bottom-left corner stating: No license found or license is invalid.

To resolve this issue:

  1. Navigate to Administration → License.

  2. Enter the correct license key to activate Runtime.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.