[Download]
| [Documentation Home] | [Release Note]
Installation Guide
This installation guide provides information on,
- The prerequisites for WSO2 Data Services Server
- Installation instructions
- Starting up WSO2 Data Services Server, and
- Accessing the management console
This document explains how Data Services Server should be installed & run in
standalone mode
Content
WSO2 Data Services Server in Standalone Mode
Introduction
WSO2 Data Services Server 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 Data Services Server 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 Data Services Server is distributed under the
Apache License,
version 2.0.
[Download WSO2 Data Services Server ]
System Requirements
Java Runtime Environment |
1.5 or higher (For instructions on setting up the JRE in different
operating systems, visithttp://java.sun.com)
|
Memory |
1 GB |
Disk |
Approximately 100 MB will be used for the .zip distribution
|
Operating System |
Tested on Windows XP, Linux, Mac OS X, Fedora core, Ubuntu,
Gentoo
|
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
http://wso2.org/wiki/display/carbon/System+Requirements
|
Installing WSO2 Data Services Server in
the Standalone Mode
Installing on Microsoft Windows
Installing using Binary Distribution
-
Download
the WSO2 Data Services Server binary distribution.
- Extract the zip archive.
- Set the JAVA_HOME environment variable to your Java installation.
- Execute the WSO2 Data Services Server starting script at
CARBON_HOME/bin/wso2server.bat.
- Check your WSO2 Data Services Server instance using the URL
https://localhost:9443/carbon/
Note: The WSO2 Data Services Server release has been
successfully tested only on Windows XP & Windows 2003 server.
You can use the install.bat file in the Data Services Server distribution to install Data
Services Server as a Windows NT
service.
This installation script is available at CARBON_HOME/bin.
Here are the steps:
-
Download
the WSO2 Data Services Server binary distribution.
- Extract the zip archive.
- Set the JAVA_HOME environment variable to your Java installation.
- From the command prompt run bin/install.bat
Once you add WSO2 Data Services Server as an NT service to Windows services, you can
start
this service from Services in Administrative tools of the Control Panel.
Check your WSO2 Data Services Server instance using the URL
https://localhost:9443/carbon/
Installing on Linux
-
Using Binary Distribution
Installing using Binary Distribution
-
Download
the WSO2 Data Services Server binary distribution.
- Extract the zip archive. e.g., unzip wso2dataservices-2.6.2.zip -d
/opt
- 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"
- Execute the WSO2 Data Services Server starting script. e.g., cd
/opt/wso2dataservices-2.6.2/bin; sh wso2server.sh
- Check your WSO2 Data Services Server instance using the URL
https://localhost:9443/carbon/
Remove Installation
On
MS Windows
systems, to remove the Data Services Server Windows NT service;
-
Run the CARBON_HOME/bin/install.bat file and select the unistall option
Accessing the Management Console
Once WSO2 Data Services Server 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 Data Services Server 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 Data Services Server Management Console see the
User Guide