4.13.4 Procedure for changing the option definition file for J2EE servers (usrconf.cfg)

You can change the following items in the option definition file for J2EE servers (usrconf.cfg):

System class path
Java heap memory usage for Java VM
Explicit memory block size for the Explicit Memory Management functionality of Java VM

The following describes the procedure.

Important: Do not edit anything not described in this procedure. Do not add any value not described here.

Start the editor as an administrator and then open the option definition file for J2EE servers (usrconf.cfg).
To change the settings of the Java VM Java heap memory usage and the Explicit memory block size for the Java VM Explicit Memory Management functionality, change the key values on the lines below the following comment lines:
```
##########################################################################
## When you change settings, please correct the following description.  ##
##########################################################################
```

To change the system class path setting, add the specification to a line below the following comment lines:

##########################################################################
## When you edit, please add description below.                         ##
##########################################################################

Execute the npstop command (stop) and npstart command (start) to restart Navigation Platform.

Organization of this subsection

(1) System class path
(2) Details about the Java heap memory usage for Java VM
(3) Details about the Explicit memory block size for the Explicit Memory Management functionality of Java VM

(1) System class path

Specify a user-created program, such as a User Plugin or user library, to be loaded by the System Class Loader on the J2EE server.

Specify a program that can be referenced from the entire J2EE server. Multiple programs can also be specified.

Key name: add.class.path
Specified value: Specify a system class path. To specify multiple paths, delimit them with a semicolon (;).
Default value: None

To Page Top

(2) Details about the Java heap memory usage for Java VM

For the Java heap memory usage for Java VM on the J2EE server, you must specify a value greater than the memory usage for Navigation Platform. Specify the same value for the minimum value and maximum value.

Important: You cannot omit the maximum and minimum values for the Java heap memory usage for Java VM on the J2EE server. Do not delete the add.jvm.arg key entered by default.

Key name

add.jvm.arg

Specified value

-Xmxmemory-usage-sizem

Specify the memory usage size in the range from 1024 to 1434. If you specify a value greater than 1434, the memory size will exceed the upper-limit for the OS memory size. Note that m at the end of the specified value indicates MB (megabytes).

Default value

-Xmx1024m

To Page Top

(3) Details about the Explicit memory block size for the Explicit Memory Management functionality of Java VM

For the maximum size of the Explicit heap for Java VM on the J2EE server, you must specify a value greater than the Explicit memory block size for Navigation Platform.

Important: You cannot omit the maximum size of the Explicit heap. Do not delete the add.jvm.arg key entered by default.

Note: User Plugin instances and session information containing the value of the ucnpOptions parameter are stored in the Explicit heap. Therefore, we recommend that you assume a case in which the Explicit heap must be expanded for the memory size required for User Plugin instances per user x maximum number of concurrently executing users.

Key name

add.jvm.arg

Specified value

-XX:HitachiExplicitHeapMaxSize=maximum-size-of-Explicit-heapm

Specify a value equal to or greater than 160 for the maximum size of the Explicit heap. Note that m at the end of the specified value indicates MB (megabytes).

Default value

-XX:HitachiExplicitHeapMaxSize=160m

To Page Top