This documentation is for WSO2 Enterprise Integrator version 6.0.0 . View documentation for the latest release in the 6.x.x family and the latest release in the 7.x.x family.

All docs This doc

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

WSO2 Enterprise Integrator (WSO2 EI) tooling provides capabilities of a complete Eclipse-based development environment for the EI. You can develop services, features and artifacts as well as manage their links and dependencies through a simplified graphical editor via WSO2 EI tooling. 

There are 3 two possible methods that you can follow to install WSO2 EI tooling.

Note

By default, some MacOS versions are shipped with JDK 1.9, which will not be compatible with WSO2 EI Tooling. Hence, you need to override it by installing Oracle JDK 1.8 and updating the folder path of the JDK 1.8 distribution in the Eclipse distribution when installing WSO2 EI Tooling.

For example, if you are using MacOS High Sierra (Version 10.13.4) with Oracle JDK 1.8.0_151, add the following properties to the <ECLIPSE_HOME>/Contents/Info.plist file.

Code Block
<string>-vm</string>
<string><JAVA_HOME>/Contents/Home/bin/java</string>

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

Anchor
pre_packaged
pre_packaged
Install WSO2 EI tooling with pre-packaged Eclipse

Download the distribution based on your operating system, extract and run it.

Tip

For earlier versions, click More Resources and then click Previous Releases.

Tip

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.

Note

These instructions are for Mac OS Capitan. If you are running Mac OS Sierra, you must run Eclipse each time from the command line instead of double-clicking the Eclipse icon because this security setting (i.e., the Anywhere option) is not available in it.

 


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

Thereafter, start Eclipse by double-clicking the Eclipse icon and set your security settings back to the previous setting.

Tip

If you are running WSO2 EI tooling on Ubuntu 16.04, add the following lines of code in the eclipse.ini file before the following line: --launcher.appendVmargs 

Code Block
--launcher.GTK_version
2

This makes you work smoothly with WSO2 EI. Also, this fix is required due to a known issue with the GTK version shipped with Ubuntu 16.04.

Anchor
P2
P2
Install WSO2 EI tooling on Eclipse Mars using the P2 URL

Note

For this, you need a compatible Eclipse IDE for Java EE Developers (Mars 2) distribution installed.

  1. Open Eclipse and click Help > Install New Software.
  2. On the dialog box that appears, click Add.
     
  3. Specify EI Tool as the Name and http://product-dist.wso2.com/p2/developer-studio-kernel/4.1.0/EI-tools/releases/5.0.0/ as the Location and click OK.
    Image Removed
  4. Select all the check boxes and click Next.

  5. Read and accept the license agreements and click Finish.

  6. If a security warning appears saying that the authenticity or validity of the software cannot be established, click OK.

  7. Restart Eclipse to complete the installation.

...

  1. Make sure you have a compatible Eclipse IDE for Java EE Developers (Mars 2) distribution installed.
  2. Download the P2 .zip file.
  3. Open Eclipse and click  Help > Install New Software .
  4. On the dialog box that appears, click  Add.
    Image Removed
  5. Specify EI Tool as the Name and click Archive.
  6. Navigate to the downloaded .zip file and click OK.

    Click Download Tooling and then click Install from P2 Repository to copy the URL of the P2 repository. 

    Tip

    For earlier versions, click More Resources and then click Previous Releases.

  7. Specify EI Tool as the Name, paste the URL you copied in the previous step as the Location and click OK.
    Add the P2 repository of EI ToolingImage Added
  8. Select all the check boxes and click Next.

  9. Read and accept the license agreements and click Finish.

  10. If a security warning appears saying that the authenticity or validity of the software cannot be established, click OK.

  11. Restart Eclipse to complete the installation.