3.4.3 User property file for J2EE server (usrconf.properties)

This subsection describes the details on the format of settings and the items to be set in the user properties file for J2EE server (usrconf.properties).

Organization of this subsection

(1) File storage folder

The following shows the folder storing the usrconf.properties 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.properties 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.properties file, and store the backup file in any folder.
Open the usrconf.properties file by using a text editor.
Modify the definitions to be changed.
Save the usrconf.properties 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.properties file, and store the backup file in any directory.
Open the usrconf.properties file by using a text editor such as vi.
Modify the definitions to be changed.
Save the usrconf.properties 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.properties file:

(omitted)
# Internal http server settings
ejbserver.http.port=port-number-for-the-internal-management-of-J2EE-server
(omitted)
# NIO HTTP Server settings
webserver.connector.ajp13.port=port-number-to-be-used-for-the-communication-between-HTTP-and-J2EE-servers
#webserver.connector.ajp13.max_threads=10
(omitted)
#ejbserver.rmi.naming.port=port-number-for-the-internal-management-of-J2EE-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) Port numbers for the internal management of a J2EE server

Specify the port numbers for the internal management of the J2EE server. The defaults are 22268 and 22269.

When you want to change a port number from its default, change the port number so that it is appropriate to the environment. Make sure that the setting value of ejbserver.rmi.naming.port matches the setting value of ejbserver.rmi.naming.port in the system properties file for server management commands (usrconf.properties). For details, see 3.4.5 System property file for server management commands (usrconf.properties).

(b) Port number to be used for communication between HTTP and J2EE servers.

Specify the port number of the port to be used for the communication between the HTTP and J2EE servers on the JP1/AJS3 for Cloud Service Applications server. The default is 22267.

When you want to change the port number from the default, change the port number so that it is appropriate to the environment. Make sure that the setting value of webserver.connector.nio_http.port matches the setting value of ProxyPass and ProxyPassReverse in the web server definition file (httpsd.conf).For details, see 3.4.2 Details on the settings in the HTTP server definition file (httpsd.conf).

To Page Top

(6) 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