WSO2 ESB tooling provides capabilities of a complete Eclipse-based development environment for the ESB. You can develop services, features and artifacts as well as manage their links and dependencies through a simplified graphical editor via WSO2 ESB tooling.
There are 3 possible methods you can follow to install WSO2 ESB tooling.
Install WSO2 ESB 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 WSO2 ESB tooling on Eclipse Mars using the P2 URL
- Install WSO2 ESB tooling on Eclipse Mars using the P2 .zip file
The Install WSO2 ESB tooling on Eclipse Mars using the P2 URL and Install WSO2 ESB tooling 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 ESB tooling with pre-packaged Eclipse
Download the distribution based on your operating system from here, then extract and run the distribution.
If you get an error message about the file being damaged or that you cannot open the file when you try to start Eclipse on a Mac, change the Mac security settings as described below. Alternatively, you can run Eclipse from the command line instead of double-clicking the Eclipse icon.
These instructions are for Mac OS El Capitan. If you are running Mac OS Sierra, the Anywhere security setting is not available, so you must run Eclipse each time from the command line instead of double-clicking the Eclipse icon.
- 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 and can set your security settings back to the previous setting.
If you are running WSO2 ESB 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 WSO2 ESB tooling on Eclipse Mars using the P2 URL
- Make sure you have a compatible Eclipse IDE for Java EE Developers (Mars 2) distribution installed.
- Open Eclipse and click Help > Install New Software.
- On the dialog box that appears, click Add.
- Specify
ESB Tool
as the Name andhttp://product-dist.wso2.com/p2/developer-studio-kernel/4.1.0/esb-tools/releases/5.0.0/
as the Location 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.
Install WSO2 ESB tooling on Eclipse Mars using the P2.zip
file
- Make sure you have a compatible Eclipse IDE for Java EE Developers (Mars 2) distribution installed.
- Download the P2
.zip
file. - Open Eclipse and click Help > Install New Software .
- On the dialog box that appears, click Add.
- Specify
ESB 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.