Installation Guide

This document explains how WSO2 Developer Studio should be installed in to Eclipse.

Content

Introduction

WSO2 Developer Studio is a fully tooling environment which facilitate you to develop, test, debug and deploy WSO2 Carbon Artifacts.

Prerequisites

Java Runtime Environment 1.6 (For instructions on setting up the JRE in different operating systems, visithttp://java.sun.com)
IDE Eclipse WTP 3.1.0 or higher (If you are planing to install offline, we recommend you to use Eclipse IDE for Java EE Developers)
WSO2 Developer Studio 2.0.1-with dependencies
WSO2 Carbon Server 3.0.1 or later
Disk Space Approximately 300MB

Download and Install (Offline Installation)

We assume you have already downloaded WSO2 Developer Studio binary distribution from the download page and you are using Eclipse IDE for Java EE Developers.

If you download WSO2 Developer Studio With Dependencies version, you can go ahead with the Offline Installation.

Latest Developer Studio release includes several third party Eclipse plugins.

Start Eclipse and Go to Help -> Install New Software .



New Server Runtime

Next click on the button Add to add the WSO2 Eclipse IDE Tools P2 Repo



New Server Runtime

If you have already downloaded the WSO2 Developer Studio binary distribution select the downloaded ZIP archive from the file system by clicking on the Archive button.



New Server Runtime

If you wish to install tools online type the update site url http://dist.wso2.org/p2/developer-studio/releases/2.0.1



New Server Runtime

Click OK to add the site.



New Server Runtime

If you want, you may uncheck/untick Contact all update sites during install to find required software to stop Eclipse from installing updates of existing eclispe features

Note: Sometimes you may have to leave the check box ticked/checked in case the Eclipse distribution you are using is missing some of the WTP features required for the Developer Studio Features If you download WSO2 Developer Studio Without Dependencies version, you need to leave the checkbox ticked. If you download the WSO2 Developer Studio With Dependencies version, you can go ahead and un-tick "Contact all update sites during install to find required software" option. Select WSO2 Developer Studio Feature from the list or select all the features Then click on the button Next

Then click on Next on the wizard page which allows you to review the the items to be installed.



New Server Runtime

Click Next and then accept the license agreement and click Finish .



New Server Runtime

Accept the security warning while installation.



New Server Runtime

When the installation is done, it will ask to restart the workspace.

Once Eclipse is reloaded, you will see that the Welcome page has been updated with WSO2 Developer Studio related links.



New Server Runtime

If you click on Open Dashboard link, you will see all the project types and samples that are available with WSO2 Developer Studio.



New Server Runtime

Same options are available if you click on the Developer Studio top menu item.



New Server Runtime

If you go to Fie -> New -> Other , you will see a category called WSO2 where it lists all the features that are available with WSO2 Developer Studio.



New Server Runtime

Now you have successfully installed WSO2 Developer Studio.

Online installation

For online installation of all the WSO2 Eclipse Tools use the update site url: http://dist.wso2.org/p2/developer-studio/releases/2.0.1

Start Eclipse and Go to Help -> Install New Software .



New Server Runtime

Click Add and point update site url as below. Then click OK.



New Server Runtime

It will list all the features available with WSO2 Developer Studio.



New Server Runtime

Choose the features you want to install and follow the same steps as listed above in offline installation.

Install on top of Carbon Studio 1.0.x family

If your Eclipse Instance has Carbon Studio 1.0.x installed, before installing WSO2 Developer Studio 2.0.1, you have to remove Carbon Studio 1.0.x features.

To remove 1.0.x related features, go to Help -> About Eclipse.



New Server Runtime

Click on Installation Details button. Now you will see that all the installed features are listed.



New Server Runtime

Select all the features related to Carbon Studio 1.0.x family, and select Uninstall....



New Server Runtime

Confirm the features to be un-installed by click Finish.



New Server Runtime

Once the un-installation is completed, restart the eclipse instance. Now you have successfully un-installed Carbon Studio 1.0.x features.

Now follow the steps in Download and Install (Offline Installation) to install Developer Studio 2.0.1 features.