svn commit: r1730197 - /axis/axis2/java/core/trunk/src/site/markdown/tools/eclipse/plugin-installation.md

[ve...@apache.org]

Author: veithen
Date: Sat Feb 13 12:38:25 2016
New Revision: 1730197

URL: http://svn.apache.org/viewvc?rev=1730197&view=rev
Log:
AXIS2-5738: Add general debugging instructions for the Axis2 Eclipse plugins.

Modified:
    axis/axis2/java/core/trunk/src/site/markdown/tools/eclipse/plugin-installation.md

Modified: axis/axis2/java/core/trunk/src/site/markdown/tools/eclipse/plugin-installation.md
URL: http://svn.apache.org/viewvc/axis/axis2/java/core/trunk/src/site/markdown/tools/eclipse/plugin-installation.md?rev=1730197&r1=1730196&r2=1730197&view=diff
==============================================================================
--- axis/axis2/java/core/trunk/src/site/markdown/tools/eclipse/plugin-installation.md (original)
+++ axis/axis2/java/core/trunk/src/site/markdown/tools/eclipse/plugin-installation.md Sat Feb 13 12:38:25 2016
@@ -60,3 +60,22 @@ procedure to install the Axis2 plugins:
 2.  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:
+
+1.  Start Eclipse with the `-console` option.
+
+2.  In the console, use `ss axis2` to check if the plugin has been installed and to
+    identify its bundle ID.
+
+3.  If the plugin has not been installed, use the `install` command (with a `file:` URL
+    pointing to the plugin) to force its installation.
+
+4.  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.