com.atlassian.confluence.content.render.xhtml.migration.exceptions.UnknownMacroMigrationException: The macro 'next_previous_link3' is unknown.

Installing WSO2 ESB Tooling

Owned by Former user (Deleted)
Last updated: May 23, 2017
3 min read

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.

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 complete tooling distribution for WSO2 ESB 5.0.0 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.

 

  1. Go to System Preferences, click Security & Privacy, and then click the General tab.
  2. 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

  1. Make sure you have a compatible Eclipse IDE for Java EE Developers (Mars 2) distribution installed.
  2. Open Eclipse and click Help > Install New Software.
  3. On the dialog box that appears, click Add.

     
  4. Specify ESB Tool as the Name and http://product-dist.wso2.com/p2/developer-studio-kernel/4.1.0/esb-tools/releases/5.0.0/ as the Location and click OK.

  5. Select all the check boxes and click Next.

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

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

  8. Restart Eclipse to complete the installation.

Install WSO2 ESB tooling on Eclipse Mars using the P2.zip file

  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.

  5. Specify ESB Tool as the Name and click Archive.
  6. Navigate to the downloaded .zip file and click OK.
  7. Select all the check boxes and click Next.

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

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

  10. Restart Eclipse to complete the installation.
com.atlassian.confluence.content.render.xhtml.migration.exceptions.UnknownMacroMigrationException: The macro 'next_previous_links2' is unknown.