We present the installation process for both Microsoft Windows (XP, Vista, 7) and Gnu/Linux (Ubuntu 10.04). In order to install the service orchestration engine on your local machine, you must execute the following steps:

Download and Install the J2SE Runtime Environment (JRE)

Microsoft Windows
1. Download the Java 2 Standard Edition Runtime Environment (JRE), release version 5.0 or later JavaSE.
2. Install the JRE according to the instructions included with the release.
3. Set an environment variable named JRE_HOME to the pathname of the directory into which you installed the JRE, e.g. c:\jre5.0 or /usr/local/java/jre5.0
Gnu/Linux
1. Install the sun-java packages
  >> sudo apt-get-repository “deb http://archive.canonical.com/ lucid partner”
2. Install the Java 2 Standard Edition Runtime Environment (JRE), release version 5.0 or 6.0
  >> sudo apt-get install sun-java6-bin
3. Alternatively, you may install the Java 6 SDK
  >> sudo apt-get install sun-java6-jdk

Download and install Apache Tomcat

Microsoft Windows
1. Download Tomcat 6.0 distribution Tomcat. There are two options:
  1. Install the binary distribution for the windows environment. For this purpose download one of the available Tomcat binary distributions for the windows environment.
    - Unpack the binary distribution into a convenient location so that the distribution resides in its own directory (conventionally named apache-tomcat-[version]). Set the CATALINA_HOME environment variable to the pathname of the directory into which you unpack the binary distribution. For the purposes of the remainder of this document, the symbolic name CATALINA_HOME is used to refer to the full pathname of the release directory.
  2. Install the Windows service installer. This is a Windows specific distribution that includes the Windows service wrapper and the compiled APR/native library for use with 32-bit/64-bit JVMs on both 32/64 bit Windows platforms. This way tomcat is used as a Windows service.
    Note: Due to a bug in the installer the apache tomcat icons on the start menu fail to start/stop the service. You can start/stop and configure Tomcat using the provided menu in the Windows toolbar. Because many users may find it confusing we recommend you to install the binary distribution as described in the previous step.
2. Start up Tomcat executing the command:
  >> $CATALINA_HOME\bin\startup.bat
  After start up, the default web applications included with Tomcat will be available at http://localhost:8080/
3. Shut down Tomcat using the command:
  >> $CATALINA_HOME\bin\shutdown
GNU/Linux
1. Install Tomcat 6.0 with the command:
  >> sudo apt-get install tomcat6
  The default installation will be in /var/lib/tomcat6/. For more details read the Ubuntu provided guide. Set CATALINA_HOME environment variable to point to the base path of the Tomcat installation location
2. Start up Tomcat executing the command:
  >> $CATALINA_HOME/bin/startup.sh
  After start up, the default web applications included with Tomcat will be available at: http://localhost:8080/
3. Shut down Tomcat using the command:
  >> $CATALINA_HOME/bin/shutdown.sh

Download and install Apache ODE engine

Microsoft Windows and GNU/Linux
1. Download the latest Apache ODE WAR distribution (apache-ode-war-1.3.4.zip) from the Apache ODE download site
2. Unzip the distribution somewhere on your disk and copy ode.war to Tomcat's webapp directory.
3. Start up Tomcat and ODE should be up and running. You should get the Axis2 welcome page under http://localhost:8080/ode.

Deployment of ODEDeploymentService

In this section we present the steps required for the deployment of the ODEDeploymentService. This service will run on top of Tomcat where ODE has been deployed and will support the deployment of service chains on the ODE engine. The ODEDeployment service receives from the user (i.e. this could be either process designer or anyone interested in deploying a process) as input a URL request providing a zip file, which contains the appropriate description files. The zip file is created by the user. We described how the user creates an appropriate zip file. The steps for deploying the service are the following:

Microsoft Windows and GNU/Linux
1. Open the ODEDeploymentService.war file and configure the WEB-INF\classes\com\s3lab\ode.properties file, contained into the .war. This file contains key-value entries which the user must set into system dependent values.
  - temporaryDirectory, is a user specified directory that will be used by the ODEDeploymentService to store the downloaded .zip files and to write the log file. This directory must have write permission.
  - deploymentDirectoryODE, is the user specified path to the ODE process deployment directory (ode/WEB-INF/processes). This directory is used by ODE to store the deployed processes.
2. Copy the ODEDeploymentService.war file to Apache Tomcat’s webapps directory. The service will be automatically deployed on Tomcat.

Process Deployment

To ensure the deployment of specified service chains to the Service Orchestration Engine compliance to the following rules should be ensured:

The process specification file (i.e. BPEL file) along with the WSDL files (and WSML files) of the related services should be valid XML (or RDFS) documents.
Encodings and Styles of all related operations should be properly specified. More details on the selection of the appropriate style/encodings are provided at the IBM article titled "Which style of WSDL should I use?"
The address of the process endpoint should adhere to the following format http://<server name>:<port>/ode/processes/<process path>

Monitoring

User's Environment Configuration