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.
<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.