21st January 2008

WSO2 Web Services Application Server v2.2-RC1
-------------------------------------------

Welcome to the WSO2 WSAS 2.2-RC1 release

WSO2 WSAS is an enterprise ready Web services engine powered by Apache Axis2 and
which offers a complete middleware solution. It is a lightweight, high performing 
platform for Service Oriented Architectures, enabling business logic and applications. 
Bringing together a number of Apache Web services projects, WSO2 WSAS provides a 
secure, transactional and reliable runtime for deploying and managing Web services.

Key Features
------------
* Data services support - Expose you enterprise data as a services in a jiffy
* WSAS IDE - Eclipse IDE integration
* Clustering support for High Availability & High Scalability
* Full support for WS-Security, WS-Trust, WS-Policy and WS-Secure Conversation and XKMS
* EJB service provider support - Expose your EJBs as services
* Axis1 backward compatibility - Deploy Axis1 services on WSAS & Engage advanced WS-* protocols in front of legacy services
* JMX & Web interface based monitoring and management
* WS-* & REST support
* GUI, command line & IDE based tools for Web service development


New Features In This Release
----------------------------
* Improved Data Services support including New & improved UI, and database connection pooling
* WS-Security 1.1 support
* Improved clustering support
* Improved JSR-181 & JAXWS support
* JMX based monitoring
* Graceful shutdown & restart of the server
        Serve all pending requests before shutting down or restarting the server
* Improvements to the Management Console
* Various bug fixes to Apache Axis2, Apache Rampart & WSAS

Data Services - Bringing Enterprise Data to Web
-----------------------------------------------
* Service enable data locked in relational databases, CSV & Excel files in no time
* Zero code. Simple descriptor file describes the data to service mapping
* Controlled access to your data
* Customizable XML output
* Benefit from REST & WS-* support
* Built-in Connection pooling support
* Supports exposing Stored procedures & functions
* Built-in caching
* Throttling - to ensure your database is never overloaded.
* Easy configuration via graphical console
* Test your services via Try-it tool

WSAS Binary Distribution Directory Structure
--------------------------------------------

	WSO2WSAS_HOME
		|- bin <folder>
		|- conf <folder>
		|- database <folder>
		|- legal <folder>
		|- lib <folder>
		|- logs <folder>
		|- repository <folder>
		|- samples <folder>
		|-- LICENSE <file>
		|-- NOTICE <file>
		|-- README <file>
		|-- INSTALL <file> 
		|-- release-notes.html <file>
		
    -	bin
		Contains various scripts to start/stop WSAS server, change user 
		password, run tcpmon, java2wsdl, wsdl2java and admin scripts for cluster
		node management. 
		
	-	conf
		Contains configuration files, properties files and keystores.
		
	-	database
		This is where the operational database for WSAS and any additional 
		modules will be created.
		
	-	legal
		Contains license documents for all third party libraries included in 
		WSO2 WSAS.
		
	-	lib
		Contains WSAS and third party libraries required for the functioning of 
		WSO2 WSAS.
		
	-	LICENSE
		Apache License 2.0 under which WSO2 WSAS is distributed.
		
	-	logs
		Execution logs will be generated here.
		
	-	NOTICE
		Notice of development.
		
	-	README
		This document.

    -   INSTALL
        This document will contain information on installing WSO2 WSAS WSO2 WSAS 2.2-RC1 in different modes.
		
	-	release-notes.html
		Release information for WSO2 WSAS 2.2-RC1.
		
	-	repository
		The repository where services and modules deployed in WSO2 WSAS 2.2-RC1 
                are stored. In addition to this other custom deployers such as 
                dataservices, axis1services and pojoservices are also stored.
		
	-	samples
		Contains some sample applications that demonstrate the functionality 
                and capabilities of WSO2 WSAS 2.2-RC1.
	
For more information on WSO2 WSAS, visit the "WSO2 Oxygen Tank" at
http://wso2.org/library


Training
--------

WSO2 Inc. offers a variety of professional Training Programs, including
training on general Web services as well as WSO2 WSAS, Apache Axis2, Data Services
and a number of other products.

For additional support information please refer to
http://wso2.com/training/course-catalog/


Support
-------

WSO2 Inc. offers a variety of development and production support
programs, ranging from Web-based support up through normal business
hours, to premium 24x7 phone support.

For additional support information please refer to http://wso2.com/support/

For more information on WSO2 WSAS, visit the WSO2 Oxygen Tank (http://wso2.org)

How to do various things with WSAS - WSAS HOWTO Series(http://wso2.org/library/2707)

Known Issues
------------

1. POJO to Web service feature is still at an experimental stage.
One can upload jar/zip file and can create an AAR out of it. 
If you uploaded a jar/zip file which has a services.xml file in its
META-INF directory, when its transformed into AAR its services.xml
will be replaced by the generated services.xml. In addition to this,
the user cannot associate any library dependencies or web content with
the generated AAR file.

Due to limitations in Axis2, method overloading is not supported, and
hence the WSDL for services where methods are overloaded cannot be generated.
Hence all WSDL based functionality related to services will not work for 
such services.

2. WS-Policy support is limited to policy expressions with a single policy alternative.

3. You cannot have two different versions of the Apache Sandesha2 module
in the system.

4. A <parameter name="OmitSOAP12Action">true</parameter> entry has been
added to the HTTP & HTTPS transportSenders in order to overcome some issues
 with some browsers. In case of interoperability failures, please change
 the value of this parameter to false and retry.

5. The 'Try It' feature does not work for MTOM enabled services.

6. Persistent Reliable Messaging support is experimental. Thus it might not
provide QoS expected, during every possible interruption scenario.

7. When daemon.sh is used in Gentoo kernel that runs on Intel processors with 32/64 bit,
users probably have to rename the native binaries with the proper name as given in error 
message.

8. Cannot connect to JMX service using a JMX client tool such as jconsole from a remote machine
when the server is running on Linux. See http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6209663.
To rectify this, you should edit the /etc/hosts file on the server machine and set the correct IP
address.

9 Data Services, Axis1 services, Javascript services &amp; POJO services cannot be
deployed using the URL-based repository configuration

---------------------------------------------------------------------------
 2008 WSO2 Inc.
