4.1.21 Notes on setting the Easy Setup definition file (when using J2EE applications)
This subsection describes the notes on setting up the Easy Setup definition file.
- Organization of this subsection
(1) Settings for enabling functions of Application Server
Default values are set in the configuration definition of the Easy Setup definition file. The default settings might include the disabled items depending on the functions of Application Server to be used. In such cases, add or change the parameters or values of the Easy Setup definition file to enable the functions. You cannot define some of the items in the settings items set for using the functions by using the Easy Setup definition file. Define the items that cannot be set using the Easy Setup definition file, by using a different user definition file.
For example, if you want to change the settings of naming services, transactions, connections, containers, logs, and security of the J2EE server, or if you want to change the start options for JavaVM of the J2EE server, change the settings by using the Easy Setup definition file. Use the text editor to set the parameter name to be changed and the changed values in the Easy Setup definition file. However, you cannot change the settings of the security policy of the J2EE server and the property of the Web application by using the Management Server. Use the text editor for editing the User definition files (server.policy, hitachi_web.properties) other than the Easy Setup definition file, and change the operation settings.
- Important note
-
For editing the server.policy, or the hitachi_web.properties, the setup of the J2EE server to be edited needs to be complete. Also, to change the operation settings in UNIX, the root permissions (when Component Container Administrator is not set), or Component Container Administrator permissions (when Component Container Administrator is set) are required.
(2) Direct settings of httpsd.conf in the AllText parameter
This section describes the notes on direct setting of httpsd.conf in the AllText parameter, if you specify text for the SetBy parameter in the <configuration> tag of the logical web server (Web Server) while creating the Easy Setup definition file.
-
The Management Server checks the operation of the Web Server by using the value of Listen directive described at the end of httpsd.conf. When you describe multiple Listen directives in the AllText parameter, describe the values used for checking the operations at the end.
-
You might need to set the HWSGracefulStopTimeout directive. For details, see 4.8.4 Notes on setting the HWSGracefulStopTimeout directive and the Manager stop watch time.
-
Edit the snapshot log collection definition file, and not the AllText parameter, to change the items of the Web Server for which you want to collect the snapshot log. The default item for the log collection is: Cosminexus-HTTP-Server-installation-directory/servers/HWS_actual-server-name-of-logical-Web Server/logs.
-
If you specify the following Include directive in the AllText parameter, a warning message is output when setting up the Web system. If you specify text by using the SetBy parameter, do not specify the following Include directive:
Include Cosminexus-HTTP-Server-installation-directory/servers/HWS_actual-server-name-of-logical-Web Server/conf/httpsd_manager.conf
(3) Notes on environment settings to connect the host to multiple network segments
This section describes the notes on the environment settings for connecting the host to multiple network segments.
As the following figure shows, if a host is connected to multiple network segments and possesses multiple IP addresses, then ensure that the IP addresses or the host names are set properly.
If the system configuration is same as in the figure above, specify the following settings in the host definition of the Easy Setup definition file:
-
Set one of the following in the <host-name> tag:
-
IP address of the network for server-to-server communication, or for communication between the server and the load balancer
-
Host name of the network for server-to-server communication, or for communication between the server and the load balancer
-
-
Set one of the following in the <agent-host> tag:
-
IP address of the network for the communication between the Management Server and other servers
-
Host name of the network for the communication between the Management Server and other servers
-
-
Specify the host name or the IP address by using the parameters in the following table and determine the network segment to be used. The following table describes the fixed parameters used in the respective logical servers
Table 4‒10: Parameters to be fixed Target logical servers
Parameters
Target hosts#
Web server
Listen
Operational host
J2EE server
mngagent.connector.host
Management host
vbroker.se.iiop_tp.host
Operational host
webserver.connector.http.bind_host
Operational host
webserver.connector.nio_http.bind_host
Operational host
Naming Service
ns.bind.host
Operational host or management host (selected by user)
CTM
ctm.NsBindHost
Operational host