Lotus: How to run Lotus Notes 8.0 from an Eclipse IDE

THEMES: Lotus\Notes/Domino 8 | Lotus\Composite Appl...
YEAR: 2007
Login Login
User: Anonymous


LABEL: Composite Application | Lotus Notes 8 | Lotus Notes API
ORGANIZATIONS: IBM
THINGS: Eclipse
 

Comments/attachments: Close
 
Resources
How to run Lotus Notes 8.0 from an Eclipse IDE
http://www-03.ibm.com/developerworks/blogs/page/CompApps?entry=how_to_run_lotus_notes1&ca=drs-bl

Some of our tutorials give instructions on how to launch Notes8 from within your eclipse IDE. This requires quite a few manual steps, however the instructions have recently become simpler because of a few changes in the platform. You can now use the following instructions (the old instructions still work, but they include a few unecessary steps).

In these instructions we will use <notes_install_dir> to denote the name of the directory where Notes 8.0 is installed. By default this will be “C:\Program Files\IBM\Lotus\notes”.

1.

Start Eclipse IDE
2.

Set target platform.
From within Eclipse IDE

*

Select Window > Preferences
*

Expand Plug-in Development
*

Select Target Platform
*

In the Location edit control, type <notes_install_dir>\framework\eclipse
*

Click the Reload button
*

Click OK



3.

Create an additional Installed JRE
From within Eclipse IDE

*

Select Window > Preferences
*

Expand Java
*

Select Installed JREs
*

Click Add...
*

For JRE name, enter a name of your choosing: something like Notes JRE (Note: We will refer to this as Notes JRE later in this document when we use this.It is probably easiest if you are new at this just to use this name.)
*

Enter <notes_install_dir>\framework\rcp\eclipse\plugins\com.ibm.rcp.j2se.win32.x86_1.5.0.<version number> for the JRE Home Directory. (Note: This should populate the lower part of the popup with many jar files)



4.

Create a new runtime configuration.
From within Eclipse IDE

*

Select Run >Run...
*

Select Eclipse Application
*

Right click and select New
*

Enter a Name: (e.g Notes)
*

Select Clear workspace data before launching
*

Under Program to Run, select Run a product,
*

For Run a product, select com.ibm.notes.branding.notes
*

In the Runtime JRE, select Notes JRE



*

Select the Arguments tab and put the following text in the Program arguments text box:
-personality com.ibm.rcp.platform.personality
-product com.ibm.notes.branding.notes
-debug
-console
*

Put in the VM arguments text box (Note: these are all taken from the <notes_install_dir>\framework\rcp\eclipse\plugins\com.ibm.rcp.base_<version>\rcpinstall.properties):
-Xshareclasses
-Drcp.home=${rcp.home}
-Drcp.install.config=user
-Dosgi.install.area=${rcp.home}\eclipse
-Dcom.ibm.pvc.osgiagent.core.logfileloc=${rcp.home}\rcp
-Dcom.ibm.pvc.webcontainer.port=0
-Declipse.pluginCustomization=${rcp.home}\rcp\plugin_customization.ini
-Declipse.registry.nulltoken=true
-Djava.protocol.handler.pkgs=com.ibm.net.ssl.www.protocol
-Djava.util.logging.config.class=com.ibm.rcp.core.internal.logger.boot.LoggerConfig
-Dosgi.hook.configurators.exclude=org.eclipse.core.runtime.internal.adaptor.EclipseLogHook
-Dosgi.framework.extensions=com.ibm.rcp.core.logger.frameworkhook
-Xbootclasspath/a:${rcp.home}\rcp\eclipse\plugins\com.ibm.rcp.base_${rcp.base_version}\rcpbootcp.jar;



*

Click the "Variables..." button located below the "VM arguments" window (caution: there are two buttons in this dialog with the same label, so be sure you click on the right one)
*

Click Edit Variables...
*

Click the button labelled "New..."
*

Enter rcp.home for the Name:
*

In the value field you should enter the path if the framework directory below where you installed notes and click “OK”. If <notes_install_dir> contains spaces you need to enclose the path within quotation marks (e.g. “C:\Program Files\IBM\Lotus\notes\framework”)
*

Click the button labelled "New..." again
*

Enter rcp.base_version for the Name:
*

Enter the version of the com.ibm.rcp.base plugin that is installed for the value and click “ok”.. You can find out the version of the plugin by looking in a directory <notes_install_dir>\framework\rcp\eclipse\plugins\ and look for a sub-directory whose name is com.ibm.rcp.base_<version> (e.g. if the directory name is com.ibm.rcp.base_6.1.1.200707190021 the version is 6.1.1.200707190021).

*



Click “ok” and then “cancel” to the select variable dialog (if you accidentally click "ok" in the "select variable" dialog it will add a variable such as ${build_project} into the text in the VM arguments text box - you will need to manually delete this variable before you launch).


After entering these configuration details you just click "OK" to run or debug Hannover. The details of the launch configuration will be saved withn your workspace so that subsequently you will see an option to Run\Notes or Debug\Notes.