WSO2 Tungsten (Standalone) Installation Guide

This guide provides information on the standalone installation of WSO2 Tungsten. Prerequisites of WSO2 Tungsten and installation instructions including how to start Tungsten server & access Tungsten Management Console are laid down here.

Download Tungsten (Standalone) version.

Your feedback on WSO2 Tungsten is most appreciated. Please send them to our Mailing Lists.

Content

System Requirements

Java Runtime Environment 1.4 or 1.5 (For instructions on setting up the JRE in different operating systems, visit http://java.sun.com)
Memory No minimum requirement
Disk No minimum requirement.

Approximately 40 MB will be used for war distribution
Operating System Tested on Windows XP, Linux, Mac OS X, Fedora core, Ubuntu, Gentoo

Installing on Microsoft Windows

Note: WSO2 Tungsten 1.0 release successfully tested only on Windows XP

There are two methods of installation on MS Windows Operating System.

  1. Using the Installation Wizard (WSO2 Tungsten 1.0 Setup wizard)
  2. Using the Binary Distribution

Running Installation Wizard

Download the tungsten-java-1.0.msi

Execute the msi and follow the instructions on the WSO2 Tungsten 1.0 Setup wizard

The first page of the installation wizard is as follows

Figure1:Installation Wizard Page1

Click on Next and it will lead you to the next page of the installation wizard which contains the End-User License Agreement.

Figure2:Installation Wizard Page2-EULA

Select check box to accept the terms in the license agreement which will enable the Next button. Clicking on Next button will lead you to the Custom Setup page shown below. Custom Setup page will allow you to select the features you want to be installed.

Figure3:Installation Wizard Page3-Custom Setup

Browse button will take you to the page below where you can select the location or the destination folder of Tungsten.

Figure4:Installation Wizard Page3-Browse for Location

Clicking Disk Usage button on Custom Setup page will take you to the page below. This will give you information on the disk sizes of the volumes on your computer, free disk space, and amount required for the selected WSO2 Tungsten features.

Figure5:Installation Wizard Page4-Disk Space Requirements

By clicking on Custom Setup Page's Next button you go to the Ready to Install page below. By clicking on Install button WSO2 Tungsten 1.0 can be installed.

Figure6:Installation Wizard Page5-Ready to install

Once installation is complete and set up is exited by clicking on the Finish button on the WiX setup wizard, you'll be able to view WSO2 Tungsten on programs list on the start menu of the MS Windows. Shortcut to Tungsten 1.0 will also appear on the Desktop.

On the programs list of the start menu WSO2 Tungsten will have options to start Tungsten server, or add/remove Tungsten as a Network (NT) Service to Windows Services.

Figure7:Programme on start menu

Once you add Tungsten as a NT Service to Windows services you can start service from Services in Administrative tools of the Control Panel.

Figure8:Network service

Installing using Binary Distribution

The following steps will take you through the installation for MS Windows Operating System

  1. Download the Tungsten binary distribution.
  2. Extract the zip archive.
  3. Set JAVA_HOME environment variable to your Java installation.
  4. Execute the Tungsten starting script. eg: C:\tungsten-java-1.0\bin\tungsten.bat
  5. Check your Tungsten service using this URL https://localhost:9443

Installing on Linux

Again, there are two methods of installation on Linux:

  1. Using Binary Distribution
  2. Using Binary Installers (deb/rpm)

Installing using Binary Distribution

  1. Download the Tungsten binary distribution.
  2. Extract the zip archive . eg: unzip tungsten-java-1.0.zip -d /opt
  3. Set JAVA_HOME environment variable to your Java installation using export command or by editing /etc/profile. eg : export JAVA_HOME="/opt/j2sdk"
  4. Execute the Tungsten starting script. eg: cd /opt/tungsten-java-1.0/bin; sh tungsten.sh
  5. Check your Tungsten service using this URL https://localhost:9443

Installing using Binary Installers (deb/rpm)

The following steps will take you through the binary distribution installation.

  1. Download the Tungsten deb or RPM binary
  2. Install Debian binary ( deb ) eg: dpkg -i tungsten-java-1.0.deb (To install deb/rpm, log in to the system as root user.)
  3. Install RPM binary ( rpm ) eg: rpm -Uvh tungsten-java-1.0.rpm
  4. Execute the Tungsten binary from shell. eg: /usr/bin/tungsten

Troubleshooting Installation

When trying to execute Tungsten binary from shell. eg: /usr/bin/tungsten (after WSO2 Tungsten 1.0 has been installed), if an error message saying 'Permission denied' pops up, then check the file permission of the tungsten.sh script and set execution permission.

Modify/ Repair/ Remove Installation

In MS Windows systems use

  1. "Add or Remove programs" utility on Control Panel to change or remove Tungsten installation
  2. or return to tungsten-1.0.msi, execute & follow the instructions as seen below.

Figure9:modify_repair_remove

In Debian Linux system use dpkg utility to remove the Tungsten installation. eg : dpkg -r tungsten

In Redhat Linux systems use rpm utility to remove the Tungsten installation. e: rpm -e tungsten

Accessing Tungsten Management Console

Once Tungsten 1.0 is successfully installed, in order to access Tungsten Management Console first run/ start Tungsten server, then launch web browser and point it to the URL https://localhost:9443/ (if you are using the default settings). This will take you to the Sign In page of Tungsten Management Console seen as below

Note: Tungsten server by default has two listeners, HTTP and HTTPS. The HTTP listener opens on port 9762, while the HTTPS listener opens on port 9443. The admin client only works through the HTTPS port.

Figure10:mgtconsole

For details on Tungsten Management Console see Administrator's Guide