Running the Micro Integrator Dashboard as a Windows Service¶
Follow the instructions given below to run the Micro Integrator Dashboard as a Windows service.
Prerequisites¶
-
Setup Micro Integrator runtime and Dashboard according to the instructions given here.
-
Point the
wso2mi_dashboard_home
environment variable to theMI_DASHBOARD_HOME
directory.
Note
Be sure to use lower case letters when setting the java_home
and wso2mi_dashboard_home
in the Windows OS. That is, you must not use JAVA_HOME
or WSO2MI_DASHBOARD_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 Micro Integrator Dashboard instance that you want to run as a service. Use the wrapper.conf file available in <MI_DASHBOARD_HOME>/bin/yajsw
folder to get the relevant configurations.
Info
WSO2 recommends Yet Another Java Service Wrapper (YAJSW) version 12.14. If you are running on JDK 11, 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, and execute the following command:
installService.bat
Starting the service¶
Navigate to the <YAJSW_HOME>/bat/
directory in the Windows command prompt, and execute the following command:
startService.bat
Stopping the service¶
Navigate to the <YAJSW_HOME>/bat/
directory in the Windows command prompt 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 and execute the following command:
uninstallServiceService.bat
Top