[Download] | [Documentation Home] | [Release Note]

Installation Guide

This installation guide provides information on,

  1. the prerequisites for WSO2 AppServer
  2. installation instructions
  3. starting up WSO2 AppServer, and
  4. accessing the management console

This document explains how AppServer should be installed & run in standalone mode

Content

Introduction

WSO2 AppServer is a lightweight application server for Web services. It is built on the Apache Axis2 framework and incorporates leading open source components into a simple, easy-to-use, and highly performant package. Web services specifications support include WS-Addressing, WS-Policy, WS-ReliableMessaging, WS-Security and more, giving a fully secure, transactional and reliable infrastructure.

WSO2 AppServer is distributed in several convenient distribution packages, and can be installed either as a standalone server or as part of a J2EE compliant servlet container. WSO2 AppServer is distributed under the Apache License, version 2.0.

[Download WSO2 AppServer ]

System Requirements

Java Runtime Environment 1.6.x (1.6.0_24 onwards recommended for production) - For instructions on setting up the JRE in different operating systems, visit http://java.sun.com
Memory 1 GB minimum. A heap size of around 512MB is generally sufficient to process typical SOAP messages. Requirements may vary with larger message size and on the number of messages processed concurrently
Disk Approximately 180 MB will be used for the .zip distribution (Excluding log files and databases)
Operating System Tested on Windows 2008 Server, Linux, Mac OS X, Fedora core, Ubuntu, Gentoo (Linux/Solaris is recommended for a production deployment)
Web Browser To start Management console. Mozilla Firefox 3.x, MS Internet Explorer 7 or higher
Apache Maven To build samples. Maven 2.1.0 or higher
Apache Ant To build samples. Ant 1.7.0 or higher


For more details see http://wso2.org/wiki/display/carbon/System+Requirements

Installing WSO2 Application Server in the Standalone Mode

Installing on Microsoft Windows

Here are the steps:

  • Download the WSO2 AppServer binary distribution.
  • Extract the zip archive.
  • Set the JAVA_HOME environment variable to your Java installation.
  • From the command prompt run bin/wso2server.bat
  • Access the WSO2 AppServer Management Console using the URL https://localhost:9443/carbon/
  • Login as "admin" using the default password "admin"

You can use the install.bat file in the AppServer distribution to install AppServer as a Windows NT service. This installation script is available at CARBON_HOME/bin. Once you add WSO2 AppServer as an NT service to Windows services, you can start this service from Services in Administrative tools of the Control Panel.

Installing on Linux

The following steps will take you through the binary distribution installation on Unix/Linux systems.

  1. Download the WSO2 AppServer binary distribution.
  2. Extract the zip archive. e.g., unzip wso2appserver-4.2.0.zip -d /opt
  3. Set the JAVA_HOME environment variable to your Java installation using the export command or by editing /etc/profile. e.g., export JAVA_HOME="/opt/j2sdk"
  4. Execute the WSO2 AppServer starting script. e.g., cd /opt/wso2appserver-4.2.0/bin; sh wso2server.sh
  5. Access the WSO2 AppServer Management Console using the URL https://localhost:9443/carbon/
  6. Login as "admin" using the default password "admin"

Removing Installation

On MS Windows systems, to remove the AppServer Windows NT service;

  • Run the CARBON_HOME/bin/install.bat file and select the unistall option

Accessing the Management Console

Once WSO2 AppServer has been successfully installed, in order to access the Management Console, first start the server, launch a web browser instance, and then point it to the URL https://localhost:9443/carbon/ (if you are using the default settings). This will take you to the "Sign In" page of the Management Console.


Note: By default, WSO2 AppServer has two listeners, HTTP and HTTPS. The HTTP listener opens on port 9763, while the HTTPS listener opens on port 9443. The administrator functions are exposed only via the HTTPS port.

For details on WSO2 AppServer Management Console see the User Guide .