4.1.19 Easy Setup definition file (when using J2EE applications)
Easy Setup definition file is an XML format file for defining the Web systems set up by using the Smart Composer functionality commands.
- Organization of this subsection
(1) Configuration of easy setup definition file
Set the following configuration of a Web system in the Easy Setup definition file:
-
Web system property definition (definition of the <web-system> tag)
-
Load balancer definition (definition of the <load-balancer> tag)#1
-
Cookie switching definition (definition of the <cookie-switching> tag of the <load-balancer> tag)#2
-
Virtual server definition (definition of the <virtual-server> tag of the <load-balancer> tag)
-
-
Physical tier definition (definition of the <tier> tag)
-
Definition for each type of logical server belonging to the physical tier (definition of the <configuration> tag of the <tier> tag)
-
Definition for using the database (definition of the <configuration> tag of the <tier> tag)#3
-
-
Service unit definition (definition of the <unit> tag)
-
Definition of the hosts constituting the service unit (definition of the <allocation-host> tag of the <unit> tag)
-
Definition for each logical server of the physical tier to which the hosts belong (definition of the <define-server> tag of the <allocation-host> tag of the <unit> tag)
-
-
Definition of hosts (definition of the <host> tag)
#1 You need not describe the definition of load balancer (definition of the <load-balancer> tag) if you do not perform the load balancer settings, or the start/close of the actual server port by using the Smart Composer functionality.
#2 Definition of cookie switching is necessary when using the Cookie switching functionality of the load balancer. Due to this setting, a series of HTTP requests are processed on one Web Server or the J2EE server. Also, if you are using the Cookie switching functionality of the load balancer, specify Web Server.container.server_id.enabled=true in the Web container settings of the J2EE server in the physical tier definition (<tier> tag).
#3 For the definition to use the database, see 4.1.6 Setting the database connection environment (setting HiRDB), 4.1.7 Setting the database connection environment (setting Oracle), or 4.1.8 Setting the database connection environment (Setting SQL Server).
The following figure shows the mapping between the configuration information of the system for executing the J2EE applications, and the definition of the Easy Setup definition file:
As shown in the above figure, in addition to the configuration and environment settings of the logical server you can also define the load balancer and hosts in the Easy Setup definition file. You can opt not to specify the host definition when using the hosts of a configured Web system.
For details on tags and parameters of the Easy Setup definition file, see 4.3 Easy Setup definition file in the uCosminexus Application Server Definition Reference Guide.
(2) Tags used in configuration definitions and scope of application
Define the settings for operations of the logical server and for using the functions in the configuration of the logical server. You can define the logical server configuration for all logical servers as well as for each logical server. To set a common definition for all the logical servers, define in the physical tier, and to set the definition for each logical server, define in the service unit. If you define in the physical tier, a common configuration is set for all the logical servers allocated to the hosts belonging to that particular physical tier. If you specify same parameters in the configuration definition of physical tier and service unit, the parameters are applied in the preference order of service unit definition, and then physical tier definition. For the contents automatically set by the Management Server, see Appendix E Contents Set Automatically by Management Server.
The following figure shows the scope of application of the configuration definition of the logical servers:
The following table describes the main tags of the Easy Setup definition file used in the configuration definition.