This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.
Installing the API Manager Tooling Plug-In
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 or newer, 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.
There are 2 possible methods you can use to install the tooling plug-in.
- Install the plug-in 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 Oxygen using the P2 URL - This method requires you to install Eclipse Oxygen separately in your system if you do not have it already.
Install the plug-in with pre-packaged Eclipse
On the API Manager tooling page, click DOWNLOAD under Developer Studio and click the respective link under Full Distribution to download the distribution according to your operating system. Note that you are prompted to enter your email address here. Â
Install the plug-in on Eclipse Oxygen using the P2 URL
Make sure you have Eclipse IDE for Java EE Developers (Oxygen 3A) installed.
Note that its recommended to use Eclipse Oxygen, since the plug-in has been tested on this version.
- Open Eclipse and on the Help menu click Install New Software.
- Click Add in the dialog box that appears.
Add the repository by enteringÂ
API-M Tool
as the name andhttp://product-dist.wso2.com/p2/developer-studio-kernel/4.3.0/apim-tools/releases/2.5.0/
as the location and click OK.Note that the 2.5.0 API-M tooling release is compatible with API-M 2.6.0 as well.
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.
Review the items to be installed 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.
Select the WSO2 Developer Studio related certificates and click OK.
- Click OK to restart Eclipse to complete the installation.