Starting the Management Console on Linux and Solaris

Once you have installed the product, follow the instructions below to access its Management Console on Linux or Solaris from the command prompt.

Establish a SSH connection to the Linux/Solaris machine or log in on the text Linux console.

Step 1. Execute the Start Script

Follow the instructions below to execute the start script from the bin folder.

1. Establish a SSH connection to the Linux server or log in on the text Linux console.

2. Go to <PRODUCT_HOME>/bin, where "<PRODUCT_HOME>" is the actual folder where the product's distribution files are stored.

3. Execute the following command to start the server:

sh ./wso2server.sh

4. The operation log is displayed. The server has been started and running successfully. For example,

Step 2. The Product's Management Console (Web Interface)

The WSO2 Carbon Management console is a Web-based user interface powered by JSP and AJAX. It allows users to interact with a running Carbon instance, without having to directly interfere with any underlying configuration files.

The Management Console makes use of the default HTTPS servlet transport, which is configured in the catalina-server.xml file in directory <PRODUCT_HOME>/repository/conf/tomcat. It is essential for this transport to be properly configured in this file for the Management Console to be accessible by users.

Step 3. Accessing the Management Console

With any WSO2 product properly installed, you can access its Management Console (web interface) by opening a Web browser and typing in the management console's URL as it appears in the start script's log. For example,

Accessing from Internet/LAN

To connect to the product's 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. Typically, it is the IP address of the computer.

The URL should be in the format: https://<Server Host>:<Server Port>/<Context>. For example,

https://10.100.2.1:9443/carbon

2. The product's homepage opens.

Accessing from Local Machine

1. You can also connect to the product's Web Interface from the computer where it is installed by typing localhost instead of the IP.

According to the example screenshot displayed above, the URL should be:

https://localhost:9443/carbon

2. The product's homepage opens.

Note

The URL may change depending on the product.

Products like the WSO2 Gadget Server also has a Portal URL in addition to the Management Console.

Notice

When the product's homepage opens, it is possible that the Internet browser will display an "insecure connection" message, requiring your confirmation of being aware of the risks.
The 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 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 4. Login to the Management Console

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

For example,

You will be logged in to the product's Management Console. As an example, the screenshot below displays the Home page of WSO2 Carbon.

The controls in the Management Console may vary depending on the product and are usually self-explanatory. However, more information is available in this document as well as the context sensitive help tips accessible by clicking the 'Help' link at the top right corner of any page of the Management Console.