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.
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 |
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.
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
Clicking on Next will lead you to End-User License Agreement.
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.
Browse button will take you to the page below where you can select the installation folder of WSO2 WSAS for Java.
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.
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 :
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.
The following steps will take you through the installation for MS Windows Operating System
Again, there are two methods of installation on Linux:
The following steps will take you through the binary distribution 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.
On MS Windows systems use
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
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.
For details on WSO2 WSAS for Java Management Console see Administrator's Guide