Skip to content

Running the Integration Control Plane as a Windows Service

Follow the instructions given below to run the Integration Control Plane as a Windows service.

Prerequisites

  • Setup Micro Integrator runtime and ICP server according to the instructions given here.

  • Point the wso2_integration_control_plane_home environment variable to the ICP_HOME directory.

Note

Be sure to use lower case letters when setting the java_home and wso2_integration_control_plane_home in the Windows OS. That is, you must not use JAVA_HOME or ICP_HOME.

Setting up the YAJSW wrapper

YASJW uses the configurations defined in the <YAJSW_HOME>/conf/wrapper.conf file to wrap Java applications. Replace the contents of this file with the configurations that are relevant to the Integration Control Plane instance that you want to run as a service. Use the wrapper.conf file available in <ICP_HOME>/bin/yajsw folder to get the relevant configurations.

Info

WSO2 recommends Yet Another Java Service Wrapper (YAJSW) version 13.05. If you are running on JDK 11 or JDK 17, previous versions of YAJSW will not be compatible.

Tip

You may encounter the following issue when starting Windows Services when the file "java" or a "dll" used by Java cannot be found by YAJSW.

"Error 2: The system cannot find the file specified"

This can be resolved by providing the "complete java path" for the wrapper.java.command as follows.

wrapper.java.command = ${java_home}/bin/java

Installing the service

Navigate to the <YAJSW_HOME>/bat/ directory in the Windows command prompt with administrative privileges, and execute the following command:

installService.bat

Starting the service

Navigate to the <YAJSW_HOME>/bat/ directory in the Windows command prompt with administrative privileges, and execute the following command:

startService.bat

Stopping the service

Navigate to the <YAJSW_HOME>/bat/ directory in the Windows command prompt with administrative privileges, and execute the following command:

stopService.bat

Uninstalling the service

To uninstall the service, navigate to the <YAJSW_HOME>/bat/ directory in the Windows command prompt with administrative privileges, and execute the following command:

uninstallServiceService.bat