- Install JDK and set up the
JAVA_HOMEenvironment variable. For more information, see Installation Prerequisites.
- Download and install a service wrapper library to use for running your WSO2 product as a Windows service. WSO2 recommends Yet Another Java Service Wrapper (YAJSW) version 11.03, and several WSO2 products provide a default
wrapper.conffile in their
<PRODUCT_HOME>/bin/yajsw/directory. The instructions below describe how to set up this file.
The configuration file used for wrapping Java Applications by YAJSW is
wrapper.conf, which is located in the
<YAJSW_HOME>/conf/ directory and in the
<PRODUCT_HOME>/bin/yajsw/ directory of many WSO2 products. Following is the minimal
wrapper.conf configuration for running a WSO2 product as a Windows service. Open your
wrapper.conf file, set its properties as follows, and save it in
If you are using ESB 4.9.0, you must manually add the following property to the
If this property is not added, you may come across an exception that will result in blank pages when you log on to the management console.
If you want to set additional properties from an external registry at runtime, store sensitive information like usernames and passwords for connecting to the registry in a properties file and secure it with secure vault.
Extract the Carbon-based product that you want to run as a Windows service, and then set the Windows environment variable
CARBON_HOME to the extracted product directory location. For example, if you want to run ESB 4.59.0 as a Windows service, you would set
CARBON_HOME to the extracted
Running the product in console mode
You will now To verify that YAJSW is configured correctly for running the Carbon-based product as a Windows service.
If the configurations are set properly for YAJSW, you will see a console output similar to the following and can now access the WSO2 management console from your web browser via https://localhost:9443/carbon.