Blog

Configuring Eclipse for Domino Debug Plugin

  |   Blog   |   1 Comment

Some time ago Niklas Heidloff blogged about three kinds of XPages developers – those who just use drag and drop with SSJS / JavaScript; those who use Java but only in an NSF; and those who develop with Java outside the NSF. For some time I’ve been doing some development outside the NSF, but after discussions with some other developers, I’m beginning to see the benefits of moving all Java outside the NSF. It may add some deployment challenges, but will also save a lot on reusability.

As I say, I’ve been using Eclipse for some time for plugin development and debugging of Java agents. For a few versions of Eclipse I’ve had the XPages SDK installed and debugged accordingly. But I had not got round to installing the Domino Debug Plugin. So last week I finally took the plunge.

However, in the YouTube video for installing it, Niklas talks about downloading an old version of the Java runtime in order for some packages of the Extension Library to compile correctly. After a bit of hunting around and following the screenshots on his video, it looks like that’s no longer available.

But after reaching out to the community, Nathan Freeman pointed me to an easier alternative by configuring Eclipse to point to the Domino (or Notes) runtime’s javaw.exe file. In the Eclipse folder there is a configuration file called eclipse.ini. Now my file looks like this, with the relevant line ringed:

eclipse ini

There are a couple of gotchas to watch out for.

Firstly, it didn’t work if I added this at the end of the config file, after the “-Xmx512m” line, even if I added a blank line afterwards. I guess this is probably because the vm setting needs to be used before vmargs. Whatever the reason, adding it immediately before -vmargs worked.

The second gotcha is that the filename doesn’t accept spaces. Here I’m running Windows 7 and my Domino server is installed under “Program Files”, so I have to use the abbreviated format “progra~1”. Opening a command prompt and typing “dir /x” will give the abbreviated names (thanks, Declan!). From the same command prompt in Windows you can use the “cd” command to change directories and navigate down to check the relevant abbreviation is correct.

Now I can load and debug my extensions from Eclipse, which I can see being extremely useful.

AUTHOR - Paul Withers

Paul Withers has been an IBM Champion since 2011, has been an OpenNTF Board Member since 2013, has worked with XPages since 2009, co-authored XPages Extension Library and was technical editor for Mastering XPages 2nd Edition. He is one of the developers on OpenNTF Domino API as well as contributor to a variety of other OpenNTF projects.

1Comment

Post A Comment