Eclipse plugin installation
Introduction
This document provides instructions for installating of the two Eclipse plugins provided by Axis2
(Service Archive Generator and Code Generator Wizard).
The two plugins should work on Eclipse version 3.1 and upwards, and require at least Java 1.5.
The plugins have dependencies on bundles that are installed by default in the Eclipse IDE for Java EE Developers
edition, but not in the Eclipse IDE for Java Developers edition. It is therefore recommended
to use the EE edition.
The installation procedure is the same for both plugins, but depends on the Eclipse
version being used. To determine which procedure to use, check if there is a
dropins
folder in the Eclipse installation directory. This folder is used
by the p2 provisioning system introduced in recent Eclipse version. It should be
present starting with Eclipse version 3.4.
Installation using the dropins directory
If your Eclipse version uses p2, use the following procedure to install the Axis2 plugins:
-
Download the ZIP file for the plugin you want to install.
-
Extract the content of the
plugins
folder in the ZIP archive into thedropins
folder (i.e. do not create aplugins
folder underdropins
).
As explained here,
it is possible to use other directory layouts in the dropins
folder.
Installation on older Eclipse versions
If you have an older Eclipse version that doesn't support p2 yet, use the following procedure to install the Axis2 plugins:
-
Download the ZIP file for the plugin you want to install.
-
Extract the content of the ZIP archive into the Eclipse installation directory. This should add one or more JAR files and/or directories to the existing
plugins
folder.
Debugging
If a plugin doesn't show up in the Eclipse UI, use the following debugging procedure:
-
Start Eclipse with the
-console
option. -
In the console, use
ss axis2
to check if the plugin has been installed and to identify its bundle ID. -
If the plugin has not been installed, use the
install
command (with afile:
URL pointing to the plugin) to force its installation. -
Use the
start
command (with the bundle ID as argument) to attempt to start the bundle. If the plugin doesn't show up in the UI, then this command will typically fail with an error message explaining the reason.
Please use this procedure before opening a bug report.