Configure Eclipse 3.5 for Notes 9

Please note: This is an update of my Configure Eclipse 3.5 for Notes 8.5.3 to work with Notes 9. If you experience any issues please let me know.

When using the below description see you need to know three pieces of information for your Notes installation: install_id, rcp.base_version and rcp.path. Below is a table with this information for various releases on Notes.

Notes version Description
Notes 9 Public Beta
rcp.home=<Notes binary diretory>\framework

The binary Notes directory is in my Windows example C:\Notes9 and in my Ubuntu example /opt/ibm/lotus/notes.

Step-by-step instructions (Windows)

  1. Download the latest build of Eclipse 3.5 from
  2. Unzip and make the Eclipse IDE ready.
  3. Note the install path of your Notes 9. If you have a space in the path name I suggest using the 8:3 name instead (e.g. c:\progra~1\notes9 instead of c:\Program Files\Notes9). In the following I will refer to this location as <Notes>.
  4. Start Eclipse 3.5
  5. Add the Notes 9 JVM
    1. Select “Window\Preferences” from the menu
    2. Select “Java\Installed JREs”
    3. Click “Add”
    4. Select “Standard VM”
    5. Specify <Notes>\jvm
    6. Name the JVM “Notes 9”
    7. Click “Finish”
    8. Click “OK”
  6. Configure the target platform
    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 “<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 “<Notes>\framework\shared\eclipse”
    7. Now your target platform should look like this
    8. Click OK
  7. 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.1
      2. Run a product:
      3. Runtime JRE: Notes 9
    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=(see table above)
        • rcp.base_version=(see table above)
        • rcp.home=(see table above)
      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: <Notes>\Data\workspace\.config\config.ini
    7. Click “Apply”
    8. Click “Close”