This documentation is for WSO2 ESB version 4.0.3. View documentation for the latest release.

Starting ESB Management Console on Windows

Once you have installed WSO2 ESB v.4.0.3 (See Installing ESB on Windows from Binary Distribution, Installing ESB on Windows from Source Distribution), follow the instructions below to access ESB Management Console on Windows.



Step 1. Execute ESB Start Script

In order to launch ESB management console, it is necessary to execute the WSO2 ESB start script wso2server.bat from the bin folder.

Follow the instructions below to run the start script.

1. Access Windows command prompt (go to "Start" "Run" type "cmd" without quotes and press "Enter").

2. Execute the following command:

cd <ESB_HOME>\bin

where "<ESB_HOME>" is the ESB installation folder. For example, c:\wso2\wso2esb-4.0.3\bin.

3. Execute the following command:

wso2server.bat --run

4. Operation log is displayed. ESB start script is running.


Step 2. Access ESB Management Console (Web Interface)

With WSO2 ESB properly installed, you can access its Management Console (web interface) by opening a Web browser and typing in the Host Name or IP address of the ESB.

Accessing ESB from Local Machine

1. You can connect to the ESB Web Interface from the computer where it is installed. Open a Web browser and access the following URL:

https://localhost:9443/esb

2. The WSO2 ESB homepage opens.

Accessing ESB from Internet/LAN

To connect to the ESB Web Interface from any computer connected to Internet/LAN, follow the instructions below.

1. Open a Web browser and access the real IP of the server WSO2 ESB. Typically, it is same as the IP address of the computer. Example:

https://192.168.56.32:9443/esb

2. WSO2 ESB homepage opens.

Notice

A situation can occur, in which Internet browser will display an insecure connection message, requiring the user's confirmation of being aware of the risks.

The WSO2 ESB Management Console is based on HTTPS protocol, which is a combination of HTTP and SSL protocols. This protocol is generally used to encrypt the traffic from the client to server for security reasons. The certificate it works with is used for encryption only, and does not prove the server identity. So when the users try to access the WSO2 ESB Management Console, a warning of untrusted connection is usually displayed. In order to continue working with this certificate, some steps should be taken to "accept" the certificate before access to the site is permitted. In case Mozilla Firefox browser is used, this usually occurs only on the first access to the server. Then the certificate is stored in the browser database marked as trusted. In case of some other browsers are used, insecure connection warning may be displayed every time server is accessed.

This scenario is suitable for testing purposes, or for running the program on the company's internal networks. But in case there is a need to provide an interface to the outside world, a company should obtain a certificate signed by a well-known CA. The role of a CA is to verify that the server accessed actually has the name it is accessed by, and that this server actually belongs to the given organization.


Step 3. Login to ESB Management Console (Web Interface)

Once you have established a connection to the WSO2 ESB, you will be prompted for a "Username" and "Password". Type in default "admin" as the "Username" and "admin" as the "Password". Click on "Sign-in."

Now you are logged in to the WSO2 ESB Management Console.

WSO2 ESB management console