This documentation is for WSO2 Enterprise Integrator version 6.2.0 . View documentation for the latest release.

All docs This doc
Skip to end of metadata
Go to start of metadata

You can run any profile of WSO2 Enterprise Integrator as a Windows service as described in the following sections:

Tip: If you are running multiple profiles as Windows services, a separate copy of the server pack should be used for each profile. This is done to avoid file locking and other concurrency related issues that may occur when more than one process is trying to access the same files.


Before you begin:

  • To find out if this version of the product has issues running on your OS due to the JDK version, see the known incompatibilities section.
  • To find out if this version of the product is fully tested on your operating system, see the compatibility matrix.

Prerequisites

Step 1 - Setting up the YAJSW wrapper 

YASJW uses the configurations defined in the <YAJSW_HOME>/conf/wrapper.conf file to wrap Java Applications. Replace it with the corresponding file out of the following to run a profile of WSO2 EI as a Windows service.

You can set additional configurations in the corresponding wrapper.conf file such as properties from an external registry at runtime, and sensitive information like usernames and passwords for connecting to the registry after securing them using secure vault.

  • ESB profile: <EI_HOME>/bin/yajsw/wrapper.conf
  • Business Process profile: <EI_HOME>/wso2/business-process/bin/yajsw/wrapper.conf
  • Message Broker profile: <EI_HOME>/wso2/broker/bin/yajsw/wrapper.conf
  • MSF4J profile: <EI_HOME>/wso2/msf4j/bin/yajsw/wrapper.conf
  • Analytics profile: <EI_HOME>/wso2/analytics/bin/yajsw/wrapper.conf

Step 2 - Setting up CARBON_HOME

Set the CARBON_HOME Windows environment variable to point to the directory of the corresponding profile of the extracted WSO2 EI directory location. For example, you need to set CARBON_HOME to the following directory paths based on the profile you want to run.

  • ESB profile: <EI_HOME>
  • Business Process profile: <EI_HOME>/wso2/business-process
  • Message Broker profile: <EI_HOME>/wso2/broker
  • MSF4J profile: <EI_HOME>/wso2/msf4j
  • Analytics profile: <EI_HOME>/wso2/analytics

Step 3 - Running WSO2 EI as a Windows service

You can run WSO2 EI as a Windows service by managing the service (i.e., install, start, stop, and uninstall the service) as follows.

Installing the service

To install the service, navigate to the <YAJSW_HOME>/bat/ directory in the Windows Command Prompt and execute the following command: 

installService.bat

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

install the Windows service

To verify if the service was successfully created, search for Windows services in your device.

search for Windows services

You view the WSO2 EI service added to the list of Windows services as shown below.

list of Windows services

Starting the service

To start the service, navigate to the <YAJSW_HOME>/bat/ directory in the Windows Command Prompt and execute the following command: 

startService.bat

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

start the Windows service

Now, you can access the Management Console from your web browser via https://localhost:9443/carbon (i.e., for the ESB profile). For information on accessing the Management Console of other profiles, see Running the Product.

Stopping the service

To stop the service, navigate to the <YAJSW_HOME>/bat/ directory in the Windows Command Prompt and execute the following command: 

stopService.bat

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

stop the Windows service

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

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

uninstall the Windows service

Alternatively, when using YAJSW wrapper, you can start WSO2 EI in its Console mode. For this, navigate to the <YAJSW_HOME>/bat/ directory in the Windows Command Prompt and execute the following command: 

runConsole.bat

If you set all the configurations properly for YAJSW, you will view the Console output similar to the following.

start WSO2 Ei in the Console mode

Now, you can access the Management Console from your web browser via https://localhost:9443/carbon (i.e., for the ESB profile). For information on accessing the Management Console of other profiles, see Running the Product.

  • No labels