Uninstalling Java extensions (“plugins”)

Introduction

Yesterday I tried to install the OpenLog logger plugin in my development environment (Notes 9.0.x) to add some more common logging procedures to an Xapp (XPages application).

Unfortunately the installation failed and I received an error message ‘no accessible features found for this plugin’. The plugin was not available under application management so from there I could not undo the installation and deleting the plugin from the data\workspace… resulted in an error when starting up Designer.

So I feared a new setup of my development environment but luckily the first result after the query ‘lotus designer remove installed plugin’ was at help. I just repeat them here so I know I have stored it somewhere:

Complete guide to manually uninstalling “plugins” from Lotus IBM Notes

The complete steps to manually uninstalling a Java extension is therefore as follows:

  1. Close Lotus Notes
  2. Open the “features”-directory (<Notes data dir>\workspace\applications\eclipse\features)
  3. Locate the Eclipse features to uninstall.
  4. For each Eclipse feature you need to open it and edit the feature.xml file. Locate the <plugin>-tags and fine the names of the referenced plugins. Note that there might be more than one. Combining the plugin id and the plugin version will give the full filename of the plugin (<plugin id>_<plugin version>.jar).
  5. Delete the Eclipse features you’re uninstalling.
  6. Open the “plugins”-directory (<Notes data dir>\workspace\applications\eclipse\plugins).
  7. Delete the plugin JAR-file(s) you recorded in the step above.
  8. Open the directory containing the platform.xml file (<Notes data dir>\workspace\.config\org.eclipse.update).
  9. Edit platform.xml and go to the end of the file.
  10. Remove each entry you see for the features you deleted in the step above.
  11. Save and close the file.
  12. Since Lotus Notes also keeps a record of which Java extensions to load it’s best to start Notes with some parameters to make it recompute the Java extension registry: notes.exe -RPARAMS -clean

Good news

I posted the problems I experienced on the OpenNTF project page and Paul Withers answered he is working on a newer version of the plugin. Hopefully that one will work brilliantly in Notes 9 clients…

One thought on “Uninstalling Java extensions (“plugins”)

  1. Paul Withers (@PaulSWithers) 2015-November-20 / 9:52 am

    I’m glad that worked. I had forgotten the platform.xml, which is the configuration that tells DDE (in reality Eclipse) that the feature is installed and where it is. I’m not sure if it’s less robust because it’s an older version of Eclipse, or if the problem would still exist if DDE were running in the latest Eclipse container. Sometimes it’s too easy to jump to the “old Eclipse” complaint.

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s