Installation
How to install the JAddin framework
1. Prerequisites
- 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=256MB2. Installation
- Copy the
JAddin.classandJAddinThread.classfrom the installation package to your development environment. - Copy the
notes.jarfile from your HCL Notes or HCL Domino installation to your development environment.
3. Application Distribution
To distribute and install your add-in, you must create a JAR container which includes:
- a valid
MANIFEST.MFfile - The framework files
JAddin.classandJAddinThread.class. - Your application class (e.g.
AddinName.class)
MANIFEST.MF
Make sure that the last line of the file is terminated with a newline character.
1
Manifest-Version: 1.0
2
Class-Path: .
3
Main-Class: AddinName
Copied!
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.classThis example creates a new
AddinName.jar file with the application AddinName.class and the two JAddin framework files.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.4. Run Application
There are several ways to start the application:
Option 1: Program Document
The easiest and recommended way is to add a program document in the HCL Domino directory.
Sample Program Document
Option 2: Console Command
Enter the command
Load RunJava JAddin AddinName in the HCL Domino console.1
> Load RunJava JAddin HelloWorld
2
03.02.2019 09:31:47 JVM: Java Virtual Machine initialized.
3
03.02.2019 09:31:47 RunJava: Started JAddin Java task.
4
03.02.2019 09:31:47 HelloWorld: Started with parameters null
5
03.02.2019 09:31:47 HelloWorld: Running on Release 10.0.1 November 29, 2018
6
03.02.2019 09:31:47 HelloWorld: User code is executing...
7
03.02.2019 09:32:02 HelloWorld: User code is executing...
8
03.02.2019 09:32:17 HelloWorld: User code is executing...
9
03.02.2019 09:32:32 HelloWorld: User code is executing...
Copied!
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,...Last modified 10mo ago