User`s guide

IBM Lotus Notes, Domino, Domino Designer 8 Release Notes
Domino for System i
Java JVM property settings on a per Domino server basis
A property in the NOTES.INI file can be used to specify JVM Properties for the Domino server. This
property, JavaUserOptionsFile, specifies a text file which contains the properties to add to the JVM. This
text file can be either ASCII or EBCDIC and have up to 256 properties specified. Each entry must be in
the form of "property=value" and be on a separate line.
Any property that can be set with the -D Java option is valid. Domino already provides a way of adjusting
the stack sizes, etc.
If Domino specifies a property, and that property is also specified in the JavaUserOptionsFile, the
JavaUserOptionsFile value is used. For example, if Domino specifies the property "Foo=1", and the
JavaUserOptionsFile specifies "Foo=2", the JVM is created with "Foo=2".
Note There are currently 2 exceptions to this:
j
ava.class.path and java.library.path. Domino will link the
values specified in the JavaUserOptionsFile to what Domino is already setting for these two properties.
Multiple Domino servers can share the same options file.
One use of this feature is easier enablement of Java applications that have native methods. In order for
the System.load() or System.loadLibrary() to find the service program, that service program must be in the
current path. In this case, the administrator would have to know what directories the Domino for iSeries
code uses. With this change, the administrator can set the JavaUserOptionsFile in the NOTES.INI and in
the referenced file specify "
j
ava.library.path=/QSYS.LIB/PGMAPP.LIB" where PGMAPP.LIB is the library
containing the service program loaded by the java application.
For example:
In the server's NOTES.INI the following line is added:
JavaUserOptionsFile=/PGMApp/JvmOptions.properties
The file "/PGMApp/JvmOptions.properties" could have the following:
java.library.path=/QSYS.LIB/PGMAPP.LIB
java.class.path=/PGMApp/bin/PGMApp.jar
PGMApp.debug=0
PGMApp.serverName=Server1
Domino Server
NAB does not contain cross certificates for authentication
Although cross certificates are created when you set up your first server, the Name and Address Book
(NAB) does not contain cross certificates capable of authenticating you when you set up an additional
server.
Workaround
1.
Manually copy the
names.nsf/admin4.nsf/server.id/
file and the cross certifier locally to the
newly-installed server.
2.
Set up the additional server again.
97