Installing the DSS Tooling Plug-In

The DSS tooling plug-in is based on WSO2 Developer Studio Kernel, which gives the capabilities of a complete Eclipse-based development environment for the DSS. You can develop services, features and artifacts and manage their links and dependencies through a simplified graphical editor.

You can install multiple WSO2 product plug-ins on top of the same Eclipse instance.

There are 3 ways to install the tooling plug-in.

Install WSO2 DSS tooling with pre-packaged Eclipse - This method uses a complete plug-in installation with pre-packaged Eclipse, so that you do not have to install Eclipse separately.
Install the plug-in on Eclipse Mars using the P2 URL
Install the plug-in on Eclipse Mars using the P2.zip file

The Install the plug-in on Eclipse Mars using the P2 URL and Install the plug-in on Eclipse Mars using the P2.zip file methods require you to install Eclipse Mars separately in your system, if you do not have it already

Install WSO2 DSS tooling with pre-packaged Eclipse

Download the distribution based on your operating system from here, then extract and run the distribution.

If you are not able to start Eclipse on a Mac, change the security settings in Mac as follows:

Go to System Preferences, click Security & Privacy, and then click the General tab.
Under Allow apps downloaded from, click Anywhere.

Thereafter, you should be able to start Eclipse by double-clicking the Eclipse icon.

If you are running WSO2 DSS tooling on Ubuntu 16.04, be sure to add the following lines of code in the eclipse.ini file before the line --launcher.appendVmargs, so that you can work with WSO2 ESB tooling smoothly:

--launcher.GTK_version
2

This fix is required due to a known issue with the GTK version shipped with Ubuntu 16.04.

Install the plug-in on Eclipse Mars using the P2 URL

Make sure you have Eclipse IDE for Java EE Developers (Mars SR2) installed.
Open Eclipse and click Help > Install New Software.
On the dialog box that appears, click Add.
Give DSS Tool as the name and http://product-dist.wso2.com/p2/developer-studio-kernel/4.1.0/dss-tools/releases/3.5.1 as the location and click OK.
Select all the check boxes and click Next.

When installing multiple WSO2 product plug-ins in the same Eclipse instance, you do not need to select the Developer Studio Kernel check boxes each time.
Read and accept the license agreements and click Finish.
If a security warning appears saying that the authenticity or validity of the software cannot be established, click OK.
Restart Eclipse to complete the installation.

Install the plug-in on Eclipse Mars using the P2`.zip` file

Make sure you have Eclipse IDE for Java EE Developers (Mars SR2) installed.
Download the P2 .zip file from http://product-dist.wso2.com/downloads/data-services-server/3.5.1/wso2dss-tooling-composite-p2-3.5.1.zip.
Open Eclipse and click Help > Install New Software.
On the dialog box that appears, click Add.
Give DSS Tool as the name and click Archive.
Navigate to the downloaded .zip file and click OK.
Select all the check boxes and click Next.
Read and accept the license agreements and click Finish.
If a security warning appears saying that the authenticity or validity of the software cannot be established, click OK.
Restart Eclipse to complete the installation.