Mindoo Blog - Cutting edge technologies - About Java, Lotus Notes and iPhone

  • Configure Eclipse 4.6.x with HCL Notes 12.0.1 FP1

    Karsten Lehmann  18 November 2022 22:29:22
    Once again I had to ask HCL development for setup instructions how to launch the HCL Notes Standard Client from an Eclipse IDE, this time for Notes 12.0.1 FP1.

    The instructions I had gotten earlier for Notes 10 have not changed much (I think there's one additional VM argument at the end of the list), but enough so that they did not work anymore.

    The document links to Eclipse Neon 4.6.3, but it's still working for me in later versions, I tried it with Eclipse 2020-09 (4.17.0, 64 bit).


    I used my local installation directory in the text below (C:\Program Files (x86)\HCL\Notes) and the plugin version for com.ibm.rcp.base in Notes 12.0.1 FP1.

    Of course these need to match your local environment.


    1. Download Eclipse Neon (4.6.3) or later from link below:

    http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-committers-neon-3-win32-x86_64.zip

    2. Get HCL Notes 12.0.1 FP1

    I used the instructions with the 32 bit Notes Client so far.

    3. Go to Windows => Preferences => Java => Installed JREs
    • Add => Standard VM =>
    • JRE home: C:\Program Files (x86)\HCL\Notes\jvm
    • JRE name: “Notes JRE”
    • Select the JRE to point to this and Apply

    4. Go to Windows => Preferences => Plug-in Development => Target Platform
    • Add => default => Target Content
    • Name: “Notes Target”

    4a. In Locations Tab:
    • Add => Directory => Location => C:\Program Files (x86)\HCL\Notes\framework\rcp\eclipse\plugins
    • Add => Directory => Location => C:\Program Files (x86)\HCL\Notes\framework\shared\eclipse\plugins
    • Finish
    • Select the Target platform to point to “Notes Target” and Apply

    4 b. In Content Tab:
    • go through the plugin list
    • for duplicate plugins, deactivate the older one
    • only relevant if you have installed a fixpack

    4 c. In Environment Tab:

    Please select following settings:
    • Operating System: win32
    • Windowing System: win32
    • Architecture: x86
    • Locale: en_US - English (United States)

    5. Go to Windows => Preferences => Run/Debug => String Substitution

    New => Add 2 strings (change plugin version and path based on your setup)


    5a. Name: rcp_home

    Value: C:\Program Files (x86)\HCL\Notes\framework

    5b. Name: rcp_base

    Value: C:\Program Files (x86)\HCL\Notes\framework\rcp\eclipse\plugins\com.ibm.rcp.base_10.0.0.20211117-0921


    OK

    Close this Preferences Window


    6. Put the following file inside the below plugin:

    C:\Program Files (x86)\HCL\Notes\framework\rcp\eclipse\plugins\com.ibm.rcp.base_10.0.0.20211117-0921


    rcp.security.properties



    7. Open Debug Configurations in the ‘Debug Perspective’ => Eclipse Configuration => New

    7a. In the Main tab:


    Name: NotesDebug

    Program to Run =>  Run a product => com.ibm.notes.branding.notes
    Java Runtime Environment => Runtime JRE => Select “Notes JRE” i.e. the one we added in step 3


    7b. In the Arguments tab:


    Program Arguments:

    -clean -console -debug -log -personality com.ibm.rcp.platform.personality -config notes


    VM Arguments:

    -Xquickstart
    -Xss384k
    -Xshareclasses
    -Drcp_home="${rcp_home}"
    -Drcp.install.config=user
    -Dosgi.install.area="${rcp_home}\eclipse"
    -Disa.ignoreESR=true
    -Dcom.ibm.pvc.osgiagent.core.logfileloc="${rcp_home}\rcp"
    -Dcom.ibm.pvc.webcontainer.port=0
    -Declipse.pluginCustomization="${rcp_home}\rcp\plugin_customization.ini"
    -Djava.security.properties="${rcp_base}\rcp.security.properties"
    -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,com.ibm.rds,com.ibm.cds
    "-Xbootclasspath/a:${rcp_base}\rcpbootcp.jar"
    -Xdump:system:events=user


    8. Apply => Debug – This will launch your Notes in Debug mode.

    Ensure that whenever you launch the Notes from Eclipse, there should be no other instance of Notes already running. If so, please close Notes and then launch from Eclipse to debug.