Install Runtime as a Windows service

To configure and start DATPROF Runtime as a service we make of use of Windows Service Wrapper tooling, which is included in the default installation package. All documents, shortcuts, and other items are stored in the winsw subfolder of the Runtime installation folder.

Initial Steps

make sure DATPROF Runtime is not running.

The Preparation and Extraction of the software to install DATPROF Runtime as a Windows service are identical to the steps for the normal installation.

Configure DATPROF Runtime as a Windows service

To configure this setup go to the folder <Datprof Runtime Installation Folder>\winsw

Edit the file: DatprofRuntimeService.xml

This file contains a selected set of parameters provided by the winsw project.

CODE

<configuration>
  <!-- ID of the service. It should be unique accross the Windows system-->
  <id>DatprofRuntimeService</id>
  
  <!-- Display name of the service -->
  <name>DATPROF Runtime Service</name>
  
  <!-- Service description -->
  <description>DATPROF Runtime Service application.</description>
  
  <!-- Path to the executable, which should be started -->
  <executable>%BASE%\..\jre\bin\java.exe</executable>
  <argument>-jar</argument>
  <argument>%BASE%\..\lib\runtime-service.jar</argument>
  <argument>%BASE%\..\data</argument>
</configuration>

The most important entry is the last argument which refers to the <DATPROF Runtime Data Folder>.

In this configuration file the %BASE% variable points to the <DATPROF Runtime Installation Folder>. The use of %BASE% is optional.

Modify this argument to point it to the correct DATA folder.

Do not change the order of the arguments.

After this, save the file.

Install / Uninstall DATPROF Runtime as a Windows service

Open a command box as an administrator

To make the configuration work we use the tool DatprofRuntimeService.exe.

By opening a command box and issuing the command: DatprofRuntimeService.exe /? it shows all possible parameters.

Now install the service.

execute:

cd <DATPROF Runtime Installation Folder>\winsw

DatprofRuntimeService.exe install

You can see this in the services MMC. This will install DATPROF Runtime as a Windows Service

To uninstall the service

execute:

cd <DATPROF Runtime Installation Folder>\winsw

DatprofRuntimeService.exe uninstall

Start / Stop DATPROF Runtime as a Windows service

Start DATPROF Runtime when installed as a service:

execute:

cd <DATPROF Runtime Installation Folder>\winsw

DatprofRuntimeService.exe start

Now DATPROF Runtime is installed and started as a service.

Stop a started DATPROF Runtime as a service:

execute:

cd <DATPROF Runtime Installation Folder>\winsw

DatprofRuntimeService.exe stop

Advanced configuration

The default configuration file DatprofRuntimeService.xml contains a limited set of possible arguments.

More options are available and can be investigated in the example configuration file: DatprofRuntimeService-allOptions.xml

You might want to consider running this service using another user. Add and modify the required section from the example file to DatprofRuntimeService.xml.