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 zipfile into. 
  • This will be the Runtime Installation Folder
  • You need an existing empty folder to store all the Runtime data.
    This will be the Runtime Data folder
    The Data Folder will contain all the data of the Projects, Environments and Applications together with the logs and the Service database.

Example

Windows

Runtime Installation Folderc:\Apps\Datprof\Runtime
Runtime Data folderc:\Data\RuntimeData

Linux

Runtime Installation Folder/usr/app/datprof/runtime
Runtime Data folder/home/dataprof/runtimeData

Extract the software

Extract the Runtime software in the Runtime Installation Folder.

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

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

Custom Network Port settings

Click here to expand...

To change the default Network Port settings, before running Runtime the first time, follow this instruction


  • Create the folder "conf" in the Runtime Data Folder
  • Copy the file <Runtime installation Folder>\runtime.properties.example to <RuntimeDataFolder>\conf\runtime.properties

# ==========================
# Runtime service properties
# ==========================

# Port for the webservice:
server.port=7070

# Database properties for the Runtime service database
db.username=SA
db.password=
db.port=9001
db.url=jdbc:hsqldb:hsql://localhost/runtime
db.dialect=org.hibernate.dialect.HSQLDialect
db.driver=org.hsqldb.jdbcDriver

# Communication end-points for Agents to connect to
broker.stomp.port=61613
broker.stomp.host=localhost
broker.jms.port=61616
broker.jms.host=localhost

# eof
CODE

To change:

  • Application server port number
    Edit server.port=<OWN_APP_PORT>
  • java message que port number
    Edit: broker.jms.port=<OWN_JMS_PORT>
  • Stomp port number
    Edit: broker.stomp.port=<OWN_STOMP_PORT>
  • Database port number
    Edit: db.port=<OWN_DB_PORT>
    Edit: db.url=jdbc:hsqldb:hsql://localhost:<OWN_DB_PORT>/runtime

Start DATPROF Runtime

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

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

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

Examples

Windows:

c:\Apps\Datprof\runtime-3.17.0\bin\runtimeStart.bat c:\Data\RuntimeData


Linux:

/home/datprof/runtime-3.17.0/bin/runtimeStart /data/datprof/runtimeData


Datprof Runtime opens a windows and once started the message appears: Runtime version <x.y.z> is ready: <IP-Adress>:<PortNumber>

Login 

Point your browser to the IP-adress and portnumber listed : ie: 192.100.10.1:7070.  (On the local machine "localhost:7070" will do)

Login as user: admin, password: admin

Change the admin password as soon as possible using the Administration icon in the menubar and select "Change Password" from the "Edit" dropdown menu.

The first time you login you will get a prompt telling you that the license has expired. To resolve this, enter the correct License key using the Administration → License

Now DATPROF Runtime is installed and operational.