WSO2 Data Services Server Setup

This is a pretty easy install. Download the dataservices server installation binary and unzip it. Put the unzipped server directory wherever you like to put your applications.

Create a user to run the application, e.g. 'wso2', and chown the application directory so this user owns it.

Install Java. I use the latest Oracle 1.6 JDK. Create an environment file somewhere that sets the values of various environment variables expected by the JVM. For example (adjust to suit your setup):

unset CLASSPATH
export JAVA_HOME=/local/apps/java
export JAVA_OPTS='-server -Xmx384M -Xms384M -XX:NewSize=64m -XX:MaxNewSize=64m -XX:SurvivorRatio=2 -XX:PermSize=64m -XX:MaxPermSize=128m -XX:+UseAdaptiveSizePolicy -XX:+UseConcMarkSweepGC -XX:+UseParNewGC -Xloggc:/var/log/wso2ds/gc.log -XX:+PrintGCDetails -XX:+PrintGCTimeStamps -Djava.awt.headless=true -Djava.net.preferIPv4Stack=true'
export LANG=en_US.UTF-8
export LC_ALL=en_US.UTF-8

This is the configuration I'm using on my laptop. On a server I'd allocate a lot more memory.

A simple init script to start and stop the WSO2 Data Services Server might look like the following. Of course you'll have to adjust the environment variables at the top to suit your installation.

#!/bin/bash

USER=wso2
CONFDIR=/local/etc/wso2
APPDIR=/local/apps/wso2ds
ENVSH=${CONFDIR}/environment.sh
SCRIPT=${APPDIR}/bin/wso2server.sh

start () {
    echo -n "Starting Carbon Framework..."
    echo
    su - ${USER} -c "source $ENVSH && ${SCRIPT} start"
    echo
}

console () {
    echo -n "Starting Carbon Framework OSGi Console..."
    echo
    su - ${USER} -c "source $ENVSH && ${SCRIPT} -DosgiConsole"
    echo
}

stop () {
    echo -n "Stopping Carbon Framework..."
    echo
    source $ENVSH
    ${SCRIPT} stop
    echo
}

restart () {
    echo -n "Restarting..."
    echo
    stop
    sleep 5
    start
}

case "$1" in
  start)
    start
    ;;
  console)
    console
    ;;
  stop)
    stop
    ;;
  restart)
    restart
    ;;
  *)
    echo "Usage: $0 {start|stop|console|restart}"
    exit 1
esac

exit 0

As soon as you get the WSO2 Data Services Server running, you should change the admin password.

You'll need to install the PostgreSQL JDBC driver in order to connect to the database. I used postgresql-8.4-701.jdbc4.jar. Put the driver in {wso2}/lib/endorsed.