WSO2 Web Services Application Server Standalone Edition for Java, v1.1 - Installation Guide

This guide provides the installation procedure for WSO2 WSAS Standalone Edition for Java. Pre-requisites of WSO2 WSAS and installation instructions including how to start WSO2 WSAS & access its Management Console are laid down here.

Your feedback on WSO2 WSAS for Java is most appreciated. Please send them to our mailing lists.

Content

System Requirements

Java Runtime Environment 1.4 or 1.5 (For instructions on setting up the JRE in different operating systems, visit http://java.sun.com)
Memory No minimum requirement
Disk No minimum requirement.

Approximately 40 MB will be used for war distribution

Operating System Tested on Windows XP, Linux, Mac OS X, Fedora core, Ubuntu, Gentoo

Installing on Microsoft Windows

Note: WSO2 WSAS for Java, v1.1 release successfully tested only on Windows XP

There are two methods of installation on MS Windows Operating System.

  1. Using the Installation Wizard (WSO2 WSAS for Java, v1.1 Setup wizard)
  2. Using the Binary Distribution

Running Installation Wizard

Download the wso2wsas-standalone-edition-java-1.1.msi

Execute the msi and follow the instructions on the WSO2 WSAS for Java, v1.1 Setup wizard

The first page of the installation wizard is as follows

Figure1:Installation Wizard Page1

Clicking on Next will lead you to End-User License Agreement.

Figure2:Installation Wizard Page2-EULA

Select check box to accept the terms in the license agreement which will enable the Next button. Clicking on Next button will lead you to the Custom Setup page shown below. Custom Setup page will allow you to select the features you want to be installed.

Figure3:Installation Wizard Page3-Custom Setup

Browse button will take you to the page below where you can select the installation folder of WSO2 WSAS for Java.

Figure4:Installation Wizard Page3-Browse for Location

Clicking Disk Usage button on Custom Setup page will take you to the page below. This will give you information on the disk sizes of the volumes on your computer, free disk space, and amount required for the selected WSO2 WSAS for Java features.

Figure5:Installation Wizard Page4-Disk Space Requirements

By clicking on Custom Setup Page's Next button you go to the Ready to Install page below. By clicking on Install button WSO2 WSAS for Java, v1.1 will be installed in your computer.

Figure6:Installation Wizard Page5-Ready to install

Once installation is complete and set up exits, by clicking on the Finish button on the WiX setup wizard, you'll be able to view WSO2 WSAS on the programs list of the start menu of Windows. Shortcut to WSO2 WSAS for Java, v1.1 will also appear on the Desktop.

On the programs list of the start menu, WSO2 WSAS for Java will have following options :

Figure7:Programme on start menu

Once you add WSO2 WSAS for Java as an NT service to Windows services, you can start this service from Services in Administrative tools of the Control Panel.

Figure8:Network service

Installing using Binary Distribution

The following steps will take you through the installation for MS Windows Operating System

  1. Download the WSO2 WSAS binary distribution.
  2. Extract the zip archive.
  3. Set JAVA_HOME environment variable to your Java installation.
  4. Execute the WSO2 WSAS starting script. eg: C:\wso2wsas-standalone-edition-java-1.1\bin\wso2wsas.bat
  5. Check your WSO2 WSAS instance using this URL https://localhost:9443

Installing on Linux

Again, there are two methods of installation on Linux:

  1. Using Binary Distribution
  2. Using Binary Installers (deb/rpm)

Installing using Binary Distribution

  1. Download the WSO2 WSAS binary distribution.
  2. Extract the zip archive . eg: unzip wso2wsas-standalone-edition-java-1.1.zip -d /opt
  3. Set JAVA_HOME environment variable to your Java installation using export command or by editing /etc/profile. eg : export JAVA_HOME="/opt/j2sdk"
  4. Execute the WSO2 WSAS starting script. eg: cd /opt/wso2wsas-standalone-edition-java-@wso2wsas_version/bin; sh wso2wsas.sh
  5. Check your WSO2 WSAS instance using this URL https://localhost:9443

Installing using Binary Installers (deb/rpm)

The following steps will take you through the binary distribution installation.

  1. Download WSO2 WSAS deb or RPM binary
  2. Install Debian binary ( deb ) eg: dpkg -i wso2wsas-standalone-edition-java-1.1.deb(To install deb/rpm, log in to the system as root user.)
  3. Install RPM binary ( rpm ) eg: rpm -Uvh wso2wsas-standalone-edition-java-1.1.rpm
  4. Execute the WSO2 WSAS binary from shell. eg: /usr/bin/wso2wsas

Troubleshooting Installation

When trying to execute the WSO2 WSAS binary from a shell. eg: /usr/bin/wso2wsas (after WSO2 WSAS for Java, v1.1 has been installed), if an error message saying 'Permission denied' pops up, then check the file permission of the run.sh script and set execution permission.

Modify/ Repair/ Remove Installation

On MS Windows systems use

  1. "Add or Remove programs" utility on Control Panel to change or remove WSO2 WSAS installation
  2. or return to wso2wsas-standalone-edition-java-1.1.msi, execute & follow the instructions as seen below.

Figure9:modify_repair_remove

In Debian Linux system use dpkg utility to remove the WSO2 WSAS installation. eg : dpkg -r wso2wsas-standalone-edition-java-1.1

In Redhat Linux systems use rpm utility to remove the WSO2 WSAS installation. e: rpm -e wso2wsas-standalone-edition-java-1.1

Accessing the Management Console

Once WSO2 WSAS for Java, v1.1 is successfully installed, in order to access the Management Console, first start the server, then launch a web browser instance and point it to the URL https://localhost:9443/ (if you are using the default settings). This will take you to the "Sign In" page of the Management Console as seen as below

Note: WSO2 WSAS by default has two listeners, HTTP and HTTPS. The HTTP listener opens on port 9762, while the HTTPS listener opens on port 9443. The admin is exposed only via the HTTPS port.

Figure10:mgtconsole

For details on WSO2 WSAS for Java Management Console see Administrator's Guide