3.4.8 Details on the settings in the option definition file for J2EE server (usrconf.cfg)
This subsection describes the details on the format of settings and the items to be set in the option definition file for J2EE server (usrconf.cfg).
- Organization of this subsection
(1) File storage folder
The following shows the folder storing the usrconf.cfg file.
JP1/AJS3-Web-Console-installation-folder\uCPSB\CC\server\usrconf\ejb\ajs3web
(2) File-editing procedure
The following describes the procedure for editing the usrconf.cfg file. If you are operating in a cluster environment, follow the edit procedure to set the same definitions for the secondary node as those set for the primary node.
-
Stop the JP1/AJS3 Web Application Server service.
-
Back up the usrconf.cfg file, and store the backup file in any folder.
-
Open the usrconf.cfg file by using a text editor.
-
Modify the definitions to be changed.
-
Save the usrconf.cfg file by using UTF-8 encoding.
-
Start the JP1/AJS3 Web Application Server service.
(3) When the setting takes effect
When the JP1/AJS3 Web Application Server service starts
(4) Format
The following shows the format of settings in the usrconf.cfg file:
(omitted) # java vm options #add.jvm.arg=-Xms256m add.jvm.arg=-Xmx the maximum size of Java heap available to applications on the Web Console server (omitted)
Note that lines beginning with a hash mark (#) are comment lines.
(5) Setting items
The following describes the items to be set:
(a) The maximum size of Java heap available to applications on the Web Console server
Specify the maximum size of the Java heap available to applications on the Web Console server.
- Specifiable values
-
512 to 5120(units:megabytes)
- Default value
-
2048(units:megabytes)
- Recommended value
-
Default value
Always end the specified size value with the character "m".
If you change the maximum size from the default, specify a maximum size appropriate for system operation. For the memory requirements, see the Release Notes.
(6) Examples
The following shows an example of definitions in the usrconf.cfg file:
(omitted) # java vm options #add.jvm.arg=-Xms256m add.jvm.arg=-Xmx512m (omitted)
(7) Notes
-
Do not change the settings of items other than those explained herein.
-
If a setting is invalid, the JP1/AJS3 Web Application Server service cannot start.
A setting is invalid in the following circumstances:
-
If the value specified as the maximum Java heap size is in the wrong format (character or symbol)
-
If a value other than a natural number is specified as the maximum Java heap size, such as a negative value or decimal
-
-
If you specify the same setting multiple times as follows, the largest value takes effect:
Example:
add.jvm.arg=-Xmx512m add.jvm.arg=-Xmx1024m
-
Do not specify a maximum Java heap size that is larger than the physical memory size. If you specify a value larger than the physical memory size, the JP1/AJS3 Web Application Server service might not start.