WSO2 Data Services Server 3.2.2
-------------

01 Dec 2014

Welcome to the Data Services Server 3.2.2 release

WSO2 Data Services Server 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 Architecture, enabling business logic
and applications. Bringing together a number of Apache Web services projects,
WSO2 Data Services Server provides a secure, transactional and reliable runtime for deploying
and managing Web services.

This is based on the revolutionary WSO2 Carbon framework. All the major features
have been developed as pluggable Carbon components.

Key Features
------------

* Enable Clustering with Hazelcast
* Dynamic Query Support
* Escape non printable characters
* Error handling in clustered environment
* Improved Patches and Service packs installation model
* Multi-profile support at the Carbon platform which enables a Carbon based product to behave in multiple modes/profiles
* Feature Categorization


Installation & Running
----------------------
1. Extract the downloaded zip file
2. Run the wso2server.sh or wso2server.bat file in the bin directory
3. Once the server starts, point your Web browser to
   https://localhost:9443/carbon/

For more details, see the Installation Guide.

System Requirements
-------------------

1. Minimum memory - 1GB
2. Processor      - Pentium 800MHz or equivalent at minimum
3. The Management Console requires full Javascript enablement of the Web browser
   NOTE:
     On Windows Server 2003, it is not allowed to go below the medium security
     level in Internet Explorer 6.x.

For more details see
https://docs.wso2.com/display/Carbon420/Installation+Prerequisites

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

All known issues have been recorded at https://wso2.org/jira/browse/CARBON

Samples:-

The CSV and Excel samples may not work under different application servers, because,
the given relative paths of CSV and Excel files may be invalid. The currently set file 
paths work under the standalone version of Data Services Server.

Data Services Server Binary Distribution Directory Structure
--------------------------------------------

	CARBON_HOME
		|- bin <folder>
		|- dbscripts <folder>
		|- lib <folder>
		|- repository <folder>
		|   |- carbonapps <folder>
		|   |- components <folder>
        	|   |- conf <folder>
        	|   |- data <folder>
        	|   |- database <folder>
        	|   |- deployment <folder>
        	|   |- logs <folder>
        	|   |- resources <folder>
        	|       |- security <folder>
        	|   |- tenants <folder>
		|- resources <folder>
                |- samples <folder>
		|- tmp <folder>
		|- webapp-mode <folder>
		|- INSTALL.txt <file> 
		|- LICENSE.txt <file>
		|- README.txt <file> 
		|- release-notes.html <file>

    	- bin
	  Contains various scripts .sh & .bat scripts

	- dbscripts
          Contains the SQL scripts for setting up the database on a variety of
          Database Management Systems, including H2, Derby, MSSQL, MySQL abd
          Oracle.

	- docs
          Contains WSO2 Data Services Server documentation.

	- lib
	  Contains the basic set of libraries required to startup WSO2 Data Services Server
	  in standalone mode

	- repository
      	  The repository where services and modules deployed in WSO2 Data Services Server
          are stored.

		- carbonapps
          	Carbon Application hot deployment directory.

        	- components
          	Contains OSGi bundles and configurations
      
        	- conf
          	Contains configuration files

        	- data
          	Contains various data files, including binary transaction logs
         
        	- database
          	Contains the database

        	- deployment
          	Contains Axis2 deployment details

        	- lib
          	Contains all the jar files required by Axis2 clients as dependancies,
                these has to be first generated by running "ant" from /bin
          
        	- logs
          	Contains all log files created during execution

        	- resources
	        Contains additional resources that may be required

                    - security
                      Contains security resources

        	- tenants
          	Contains tenant details
      
	- samples
	  Contains some sample applications that demonstrate the functionality
	  and capabilities of WSO2 Data Services Server

	- tmp
	  Used for storing temporary files, and is pointed to by the
	  java.io.tmpdir System property

	- webapp-mode
      	  The user has the option of running WSO2 Carbon in webapp mode (hosted as a web-app in an application server).
          This directory contains files required to run Carbon in webapp mode.

	- LICENSE.txt
	  License information of all the jar files used in WSO2 Data Services Server

	- README.txt
	  This document.

	- INSTALL.txt
          This document will contain information on installing WSO2 Data Services Server

	- release-notes.html
	  Release information for WSO2 Data Services Server 3.2.2


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 Data Services Server, visit the WSO2 Oxygen Tank (http://wso2.org)

Crypto Notice
-------------

This distribution includes cryptographic software.  The country in
which you currently reside may have restrictions on the import,
possession, use, and/or re-export to another country, of
encryption software.  Before using any encryption software, please
check your country's laws, regulations and policies concerning the
import, possession, or use, and re-export of encryption software, to
see if this is permitted.  See <http://www.wassenaar.org/> for more
information.

The U.S. Government Department of Commerce, Bureau of Industry and
Security (BIS), has classified this software as Export Commodity
Control Number (ECCN) 5D002.C.1, which includes information security
software using or performing cryptographic functions with asymmetric
algorithms.  The form and manner of this Apache Software Foundation
distribution makes it eligible for export under the License Exception
ENC Technology Software Unrestricted (TSU) exception (see the BIS
Export Administration Regulations, Section 740.13) for both object
code and source code.

The following provides more details on the included cryptographic
software:

Apacge Rampart   : http://ws.apache.org/rampart/
Apache WSS4J     : http://ws.apache.org/wss4j/
Apache Santuario : http://santuario.apache.org/
Bouncycastle     : http://www.bouncycastle.org/


For further details, see the WSO2 Carbon documentation at
https://docs.wso2.com/display/DSS322/WSO2+Data+Services+Server+Documentation

---------------------------------------------------------------------------
 Copyright 2012 WSO2 Inc.
