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

Installing the API Manager Tooling Plug-In

Owned by Former user (Deleted)
Last updated: Jan 16, 2019 by Former user (Deleted)Version comment
4 min read

The API Manager tooling plug-in gives the capabilities of a complete Eclipse-based development environment for the API Manager. You can develop services, features, and artifacts, and manage their links and dependencies through a simplified graphical editor.

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

WSO2 API Manager supports OpenJDK as well as Oracle JDK. By default, some MacOS versions are shipped with JDK 1.9, which is not compatible with WSO2 API-M 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 API-M 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.

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

There are 3 possible methods you can use to install the tooling plug-in.

Install the plug-in with pre-packaged Eclipse

On the API Manager product page, click Download, click Download Tooling and then click on the respective link under Full Distribution to download the distribution according to your operating system under the Eclipse JavaEE Mars + API Manager Tooling 2.1.0 section. Note that you will be prompted to enter the email address here. 
 

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

  1. Make sure you have Eclipse IDE for Java EE Developers (Mars 2) installed.

    Note that its recomended to use Eclipse Mars, since the plug-in has been tested on this version.

  2. Open Eclipse and on the Help menu click Install New Software.
  3. Click Add in the dialog box that appears.
  4. Add the repository by entering API-M Tool as the name and http://product-dist.wso2.com/p2/developer-studio-kernel/4.1.0/apim-tools/releases/2.2.0/ as the location and click OK.

  5. Select the required software and click Next.
    Select WSO2 API Manager Tools and  WSO2 ESB Tools  check box. You need to install the WSO2 ESB Tools as WSO2 API-M tooling totally depends on WSO2 Enterprise Service Bus (WSO2 ESB).

    If you are using a fresh instance of Eclipse with no other WSO2 product tooling plug-ins installed, you need to select the Developer Studio checkboxes as well.

  6. Review the items to be installed and click Next.

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

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

  9. Select the WSO2 Developer Studio related certificates and click OK.

  10. Click OK to restart Eclipse to complete the installation.

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

  1. Make sure you have Eclipse IDE for Java EE Developers (Mars 2) installed. 
  2. On the API Manager product page, click Install. On the next page, scroll down and click Tooling under Additional Resources. to download the P2 .zip file.
  3. Open Eclipse and navigate to the Help menu and click Install New Software.
  4. On the dialog box that appears, click Add.
  5. Give APIM 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.