search

Installation

How to install the JAddin framework

hashtag
1. Prerequisites

  • HCL Domino 9.0.1 FP8 or higher (Java Virtual Machine 1.8+ requirement)

circle-exclamation

To avoid out-of-memory errors in the Java Virtual Memory (JVM), make sure the JVM heap size is set to at least 256 MB in the Notes.ini on the HCL Domino server, e.g. JavaMaxHeapSize=256MB

hashtag
2. Installation

  • Download and unzip the installation package.

  • Copy the JAddin.class and JAddinThread.class from the installation package to your development environment.

  • Copy the notes.jar file from your HCL Notes or HCL Domino installation to your development environment.

hashtag
3. Application Distribution

To distribute and install your add-in, you must create a JAR container which includes:

  • a valid MANIFEST.MF file

  • The framework files JAddin.class and JAddinThread.class.

  • Your application class (e.g. AddinName.class)

hashtag
MANIFEST.MF

Make sure that the last line of the file is terminated with a newline character.

hashtag
JAR container

There are several tools available to create JAR containers. The easiest way is to use the command line.

jar cvmf MANIFEST.MF AddinName.jar AddinName.class JAddin.class JAddinThread.class

This example creates a new AddinName.jar file with the application AddinName.class and the two JAddin framework files.

hashtag
Install Application

Copy the JAR container to the domino/ndext directory. This directory is automatically searched by the RunJava task for any Java classes to load.

hashtag
4. Run Application

There are several ways to start the application:

hashtag
Option 1: Program Document

The easiest and recommended way is to add a program document in the HCL Domino directory.

Sample Program Document

hashtag
Option 2: Console Command

Enter the command Load RunJava JAddin AddinName in the HCL Domino console.

hashtag
Option 3: Notes.ini

You may change the line starting with ServerTask= to include the task to be started, e.g.

ServerTasks=Replica,Router,Update,RunJava JAddin AddinName,AMgr,...

PreviousJAddin Java Framework for HCL Domino (Open Source)NextDebugging Tips

Last updated