[Download] | [Documentation Home] | [Release Note]

Installation Guide

This installation guide provides information on,

  1. The prerequisites for WSO2 Task Server
  2. Installation instructions
  3. Starting up WSO2 Task Server, and
  4. Accessing the management console

This document explains how Task Server should be installed & run in standalone mode

Content

Introduction

WSO2 Task Server is a lightweight server to schedule remotely triggered web tasks

WSO2 Task 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 Task Server is distributed under the Apache License, version 2.0.

[Download WSO2 Task 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 256MB
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 Task Server in the Standalone Mode

Installing on Microsoft Windows

Installing using Binary Distribution

  1. Download the WSO2 Task Server binary distribution.
  2. Extract the zip archive.
  3. Set the JAVA_HOME environment variable to your Java installation.
  4. Execute the WSO2 Task Server starting script at CARBON_HOME/bin/wso2server.bat.
  5. Check your WSO2 Task Server instance using the URL https://localhost:9443/carbon/

You can use the install.bat file in the Task 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 Task 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 Task 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 Task Server instance using the URL https://localhost:9443/carbon/

Installing on Linux

  1. Using Binary Distribution

Installing using Binary Distribution

  1. Download the WSO2 Task Server binary distribution.
  2. Extract the zip archive. e.g., unzip wso2dataservices-3.0.0.zip -d /opt
  3. 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"
  4. Execute the WSO2 Task Server starting script. e.g., cd /opt/wso2dataservices-3.0.0/bin; sh wso2server.sh
  5. Check your WSO2 Task Server instance using the URL https://localhost:9443/carbon/

Remove Installation

On MS Windows systems, to remove the Task Server Windows NT service;

  • Run the CARBON_HOME/bin/install.bat file and select the unistall option

Accessing the Management Console

Once WSO2 Task 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 Task 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 Task Server Management Console see the User Guide