This short howto should explain how to prepare a system which could be used to build eclipse plugins.




  • Windows XP Servicepack 2
  • Lotus Notes Admin & Designer Client 8.5.1
  • Eclipse 3.4.2
  • (Optional: Sun Java SDK VM)



1.) Prepare the System.

  1. Download the latest build of Eclipse 3.4 from (currently its 3.4.2).
  2. Unzip eclipse to "C:\Eclipse".
  3. Install the Lotus Notes Admin & Developer client to "C:\Lotus\Notes".
  4. Now you could start Eclipse.


Note: If you couldn´t start eclipse because of a missing Java VM install the Sun Java SDK VM.



2.) Add the Lotus Notes JVM to Eclipse


  1. Select "Window\Preferences" from the menu
  2. Select "Java\Installed JREs"
  3. Click "Add"
  4. Select "Standard VM"
  5. Click the browse button and browse to the "JVM" directory in your Lotus Notes Installation. For me this is "C:\Lotus\Notes\jvm"
  6. Name the JVM "Notes 8.5"
  7. In "Default VM Arguments" specify "-Xint"
  8. Click "Finish"
  9. Click "OK"


3.) Configure the target platform in Eclipse

  1. Select "Window\Preferences" from the menu
  2. Select "Plug-in Development\Target Platform"
  3. Check "Group plug-ins by location"
  4. In the location field specify "C:\Lotus\Notes\framework\rcp\eclipse"
  5. Click the "Reload" button
  6. Click the "Add..." button
    1. Select "File System" and click Next
    2. Click the "Add..." button and navigate to "C:\Lotus\Notes\framework\shared\eclipse"
  7. Now your target platform should have two entrys.
  8. Click OK



4.) Create a launch configuration


  1. Click the arrow next to the Run button (the green arrow) and select "Run Configurations..."
  2. Right-click "Eclipse Application" and select "New"
  3. "Main"-tab
    1. Name: Notes 8.5
    2. Run a product:
    3. Runtime JRE: Notes 8.5
  4. "Arguments"-tab
    1. Program arguments:
    2. VM arguments:
    3. Click the "Variables..." button
    4. Click the "Edit Variables..." button
    5. Add the following variables
      • install_id=1255551475820
      • rcp.base_version=
      • rcp.home=C:\Lotus\Notes\framework
    6. Click "OK"
    7. Click "Cancel"
  5. "Plug-ins"-tab
    1. Launch with: plug-ins selected below only
  6. "Configuration"-tab
    1. Configuration file: Use an existing config.ini file as a template
    2. Location: C:\Lotus\Notes\Data\workspace\.config\config.ini
  7. Click "Apply"
  8. Click "Close"

Source from: with minimal changes so that it fits to my environment and that I could use this content as basis for other howtos.