Installation

This page describes how to install Developer Studio into Eclipse. It contains the following sections:

Prerequisites

Developer Studio	You can install Developer Studio in the following ways: Via Eclipse Market Place Using the downloaded binary file or directly from the web Using the downloaded complete installation distribution (without Eclipse being installed)
Java Runtime Environment/JDK	Oracle Java SE Development Kit (JDK) 1.7.0_45 or later. JDK 1.8 is not supported yet. After Developer Studio is installed, start Eclipse and make sure that the correct Java version is shown in Eclipse > Preferences > Java > Installed JREs.
IDE	Eclipse WTP 3.1.0 or higher. If you are planing to install offline, we recommend you use Eclipse IDE for Java EE Developers (Kepler SR2). Note that Helios SR2 is NOT supported.
Java Heap Memory	1 GB (Minimum)
Java PermGen Memory	512 MB (Minimum)
Processor	2 GHz Core 2 Duo (Minimum)
WSO2 Carbon Server	3.0.1 or later.
Disk Space	Approximately 1 GB

Upgrading from a previous version

If your Eclipse instance has Carbon Studio 1.x (the predecessor to Developer Studio) or Developer Studio 2.x installed, you should install a new instance of Eclipse for use with Developer Studio 3.7.0 and specify a new workspace.

If you do not want to install a second instance of Eclipse, you must remove all the features from the previous release (described below) before installing Developer Studio 3.7.0 and specify a new workspace for 3.7.0 configurations. Developer Studio 2.x configurations cannot be migrated to use the Developer Studio 3.x functionality.

If you do not have Carbon Studio 1.0.x or Developer Studio 2.x installed, skip ahead to Install Developer Studio.

It is possible to import existing projects from a previous version of Developer Studio to the current version.

Remove Carbon Studio 1.x and Developer Studio 2.x features

For best results, you should install Developer Studio 3.7.0 on a new instance of Eclipse instead of installing it on an existing instance, and specify a new workspace for 3.7.0. If you need to install Developer Studio 3.7.0 on your existing Eclipse instance and it has Carbon Studio 1.x or Developer Studio 2.x installed, you must remove these features before installing Developer Studio 3.7.0.

To remove previous features:

In Eclipse, click Help -> Install New Software, and then click the already installed? link.
Select all the features related to the following products and click Uninstall:

- Application Server
- Business Process Server
- Carbon
- Complex Event Server
- Data Services
- Enterprise Service Bus
- Governance Registry
- Smooks
- User Management Core Tools
- WSO2

Review the features to be uninstalled and click Finish.
Restart Eclipse.

You have now successfully uninstalled Carbon Studio 1.x and Developer Studio 2.x features and are ready to install Developer Studio 3.x as described in the next section.

Setting JAVA_HOME

Install Developer Studio

This section provides instructions for installing Developer Studio. If you have Eclipse already installed, follow the quick installation or the custom installation. The complete installation describes how to install Developer Studio without having Eclipse separately installed.

If you want to use App Factory via Developer Studio, and you install Developer Studio via the Eclipse Market Place, the downloaded P2 zip file, or the Online P2 Repository (instead of the complete installation distribution), you need to update your Egit plugin before you use the App Factory tooling feature. To update your Egit plugin, go to http://download.eclipse.org/egit/updates/ via Eclipse.

Quick installation

This section describes how to use Eclipse Marketplace to quickly install Developer Studio into a running instance of Eclipse using all the default options. Go to http://marketplace.eclipse.org/content/wso2-developer-studio, drag the Install icon to your Eclipse workbench window, and then accept all the defaults in the wizard to install Developer Studio.

Custom installation

This section describes how to install Developer Studio using a downloaded distribution or using the Online P2 Repository.

Start Eclipse, click Help -> Install New Software, and then click Add. The Add Repository dialog box appears.
Type developer-studio for the name, and then do one of the following:
- If you downloaded the Developer Studio binary file, click Archive and specify the downloaded archive's location.
- If you did not download Developer Studio and want to install it directly from the web, type the following path as the location: http://dist.wso2.org/p2/developer-studio/releases/3.7.0
Click OK.
Developer Studio appears in the list.
Click the check box next to WSO2 Developer Studio, and click Next.
Review the items to be installed and click Next.
Accept the license agreement and click Finish.
If a security warning appears during installation, click OK, select the Eclipse and Developer Studio certificates, and click OK again.
When prompted, restart Eclipse.

Complete installation

This section describes how to install Developer Studio using the complete installation distribution.

Download the Eclipse + Developer Studio 32-bit or 64-bit complete installation distribution file.
Start Eclipse by double-clicking the Eclipse icon in <DevStudio_Home>.

To start Eclipse on a Mac for the first time, open a terminal and execute the following commands:

cd <DevStudio_Home>/Eclipse.app/Contents/MacOS/
chmod +x eclipse
./eclipse

Thereafter, Eclipse can be started by double-clicking the Eclipse icon in <DevStudio_Home>.

You can now access the Developer Studio features.