4.1.21 Notes on setting the Easy Setup definition file (when using J2EE applications)

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

To Page Top

(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

To Page Top

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

Figure 4‒4: Example of a host connected to multiple network segments

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

  # The operational host is the host specified in the <host-name> tag of the Easy Setup Definition file. The management host is the host specified in the <agent-host> tag of the Easy Setup Definition file.

To Page Top