Installation
How to install the JAddin framework
Last updated
Was this helpful?
How to install the JAddin framework
Last updated
Was this helpful?
HCL Domino 9.0.1 FP8 or higher (Java Virtual Machine 1.8+ requirement)
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
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.
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
)
Make sure that the last line of the file is terminated with a newline character.
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.
Copy the JAR container to the domino/ndext
directory. This directory is automatically searched by the RunJava task for any Java classes to load.
There are several ways to start the application:
The easiest and recommended way is to add a program document in the HCL Domino directory.
Enter the command Load RunJava JAddin AddinName
in the HCL Domino console.
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,...