Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table of Contents

Prerequisites

  • Install JDK 1.6 or higher and set up the the JAVA_HOME environment variable environment 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 default wrapper.conf file  file in their their <PRODUCT_HOME>/bin/yajsw directory/ directory. The instructions below describe how to set up this file.

...

The configuration file used for wrapping Java Applications by YAJSW is is wrapper.conf, which is located in the the <YAJSW_HOME>/conf directory / directory and in the the <PRODUCT_HOME>binHOME>/bin/yajsw directory / directory of many WSO2 products. Following is the minimal minimal wrapper.conf configuration  configuration for running a WSO2 product as a Windows service. Open your your wrapper.conf file file, set its properties as follows, and save it in in <YAJSW_HOME>/conf/ directory.

Info

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 variable CARBON_HOME to  to the extracted product directory location. For example, if you want to run ESB 4.5.0 as a Windows service, you would set set CARBON_HOME to  to the extracted extracted wso2esb-4.5.0 directory directory.

Image RemovedImage Added

Running the product in console mode

...

  1. Open a Windows command prompt and go to the directory the <YAJSW_HOME>/bat/ directory. For example:

    Code Block
    cd C:\Documents and Settings\yajsw_home\bat
  2. Start the wrapper in console mode using the following command:

    Code Block
    runConsole.bat

    For example:

    Image RemovedImage Added

If the configurations are set properly for YAJSW, you will see console output similar to the following and can now access the WSO2 management console from your web browser via via https://localhost:9443/carbon.

Image RemovedImage Added

Working with the WSO2CARBON servicethe WSO2CARBON service

To install the Carbon-based product as a Windows service, execute the following command in the the <YAJSW_HOME>/bat directory/ directory:

Code Block
installService.bat

The console will display a message confirming that the WSO2CARBON service the WSO2CARBON service was installed.

Image Removed Image Added 

To start the service, execute the following command in the same console window:

...

The console will display a message confirming that the WSO2CARBON service the WSO2CARBON service was started.

Image RemovedImage Added

To stop the service, execute the following command in the same console window:

...

The console will display a message confirming that the WSO2CARBON service the WSO2CARBON service has stopped.

Image RemovedImage Added

To uninstall the service, execute the following command in the same console window:

Code Block
uninstallService.bat

The console will display a message confirming that the WSO2CARBON service the WSO2CARBON service was removed.

Image Removed

 Image Added