Setting up KonaKart as a Windows Service

You can run KonaKart as a Windows Service if you wish. A special service.bat file is provided (in the KonaKart/bin directory) to make the installation and removal of KonaKart as a service extremely straightforward. For the second option for installing KonaKart as a service described below, the equivalent bat file is called KonaKartService.bat.

Two methods are provided. The first installs KonaKart as a service that runs tomcat directly. The second installs KonaKart as a service that calls the standard startkonakart.bat script. Each will be described below:

KonaKart as a Service - option 1

To install KonaKart as a service that calls tomcat directly run:


REM ---------------------------------------------------------------------------------------
REM To install KonaKart as a Windows Service
REM ---------------------------------------------------------------------------------------
 
C:\KonaKart\bin> service install
Installing the service 'KonaKart' ...
Using CATALINA_HOME:    "C:\KonaKart"
Using CATALINA_BASE:    "C:\KonaKart"
Using JAVA_HOME:        "C:\Program Files\Java\jdk1.8.0_211"
Using JRE_HOME:         "C:\Program Files\Java\jdk1.8.0_211\jre"
Using JVM:              "C:\Program Files\Java\jdk1.8.0_211\jre\bin\server\jvm.dll"
The service 'KonaKart' has been installed.

To remove KonaKart as a service run:


REM ---------------------------------------------------------------------------------------
REM To remove KonaKart as a Windows Service
REM ---------------------------------------------------------------------------------------
 
C:\KonaKart\bin>service remove KonaKart
The service 'KonaKart' has been removed

To display a GUI that can be used to configure the KonaKart service run:


REM ---------------------------------------------------------------------------------------
REM To configure KonaKart as a Windows Service - this opens up a GUI
REM ---------------------------------------------------------------------------------------
 
C:\KonaKart\bin> KonaKartw.exe

This option for running KonaKart as a service will not run SOLR. You would need to start that separately.

Note that you may need to configure a compatible jvm.dll and suitable memory settings for your environment. If the service fails to start or runs out of memory these are signs that you need to review the service configuration.

KonaKart as a Service - option 2

To install KonaKart as a service (it is called KonaKartService by default) that calls the standard startkonakart.bat script run:


REM ---------------------------------------------------------------------------------------
REM To install KonaKartService as a Windows Service
REM ---------------------------------------------------------------------------------------
 
C:\KonaKart\bin> KonaKartService.bat install
Installing the service 'KonaKartService' ...
The service 'KonaKartService' has been installed.

To remove KonaKartService as a service run:


REM ---------------------------------------------------------------------------------------
REM To remove KonaKartService as a Windows Service
REM ---------------------------------------------------------------------------------------
 
C:\KonaKart\bin> KonaKartService.bat remove
The service 'KonaKartService' has been removed

To display a GUI that can be used to configure the KonaKartService service run:


REM ---------------------------------------------------------------------------------------
REM To configure KonaKartService as a Windows Service - this opens up a GUI
REM ---------------------------------------------------------------------------------------
 
C:\KonaKart\bin> KonaKartServicew.exe

The KonaKartService takes 3 parameters for the start and stop methods. The same parameters are used in both methods.

  • Parameter 1 : start (to start the service) or stop (to stop it)
  • Parameter 2 : Any name for the KonaKart instance
  • Parameter 3 : Home directory of the installation

Unlike in the first option above, this option for running KonaKart as a service will run SOLR because that is started in the standard startkonakart.bat script.