3.4.4 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
(2) File-editing procedure
(3) When the setting takes effect
(4) Format
(5) Setting items
(6) Examples
(7) Notes

(1) File storage folder

The following shows the folder storing the usrconf.cfg file.

In Windows:: JP1/AJS3-for-Cloud-Service Applications-installation-folder\uCPSB\CC\server\usrconf\ejb\ajs3csa
In Linux:: /opt/jp1ajs3csa/uCPSB/CC/server/usrconf/ejb/ajs3csa

To Page Top

(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.

(a) In Windows

Stop the JP1/AJS3 CSA HTTP Server service and then stop the JP1/AJS3 CSA 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.
Start the JP1/AJS3 CSA Web Application Server service and then start the JP1/AJS3 CSA HTTP Server service.

(b) In Linux

Execute the following command to stop the JP1/AJS3 CSA HTTP Server service and the JP1/AJS3 CSA Web Application Server service.
```
/etc/opt/jp1ajs3csa/jajs_csa_stop
```
Back up the usrconf.cfg file, and store the backup file in any directory.
Open the usrconf.cfg file by using a text editor such as vi.
Modify the definitions to be changed.
Save the usrconf.cfg file.
Execute the following command to start the JP1/AJS3 CSA HTTP Server service and the JP1/AJS3 CSA Web Application Server service.
```
/etc/opt/jp1ajs3csa/jajs_csa
```

To Page Top

(3) When the setting takes effect

When the JP1/AJS3 CSA Web Application Server service starts

To Page Top

(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 JP1/AJS3 for Cloud Service Applications server
(omitted)

Note that lines beginning with a hash mark (#) are comment lines.

To Page Top

(5) Setting items

The following describes the items to be set.

(a) The maximum size of Java heap available to applications on the JP1/AJS3 for Cloud Service Applications server

Specify the maximum size of the Java heap available to applications on the JP1/AJS3 for Cloud Service Applications 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.

To Page Top

(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=-Xmx2048m
(omitted)

To Page Top

(7) Notes

Do not change the settings of items other than those explained herein.
If a setting is invalid, the JP1/AJS3 CSA Web Application Server service cannot start.

To Page Top