4.9 Host definition file for scale out

Organization of this section
(1) Format
(2) File storage location
(3) Functionality
(4) Specifiable elements
(5) Examples of coding

(1) Format

This file is in the XML format.

(2) File storage location

Store this file at any work location.

(3) Functionality

This is a definition file for scaling out the Web system of the host unit management model, built using the commands provided with the Smart Composer functionality. This file defines the Web system information of the re-produced destination host.

Copy and use the following template files:

Reference note
The character encoding in the template file is UTF-8.

(4) Specifiable elements

The host definition file for scaling out defines the host to be added and load balancer to be used in the Web system at the re-produced destination.

The structure of the host definition file for scaling out is as follows. Specify the <host-scaleout> and <web-system> tags in this format.

Organization of the host definition file for scale out

<host-scaleout xmlns="http://www.cosminexus.com/mngsvr/schema/HostScaleOut-2.5">
 <!-- Definition of the Web system at re-produced destination -->
 <web-system>
   <!-- Definition of Web system attributes -->
   <name>Web-system-name</name>
 </web-system>

 <!-- Definition of the re-produced destination host -->
 <host>
   <host-name>host-name-or-IP-address</host-name>
   <display-name>display-name-of-host</display-name>
   <description>comment-on-host</description>
   <agent-host>host-name-or-IP-address-of-Cosminexus-Administration-Agent</agent-host>
 </host>
</host-scaleout>

The following table lists and describes each tag and the default values:

Tag namesContentsDefault
web-system#1Defines the Web system at the re-produced destination.
Specify this tag to change the definition of the Web system at the re-produced destination. For defining the multiple Web systems, specify the <web-system> tag for each Web system.
None
name#1Specifies the name of the Web system at the re-produced destination for changing the settings.None
host#2Defines the re-produced destination host.
A host can be shared among multiple Web systems.
None
host-nameSpecifies the host name or IP address for operations. Specifies the host name within 32 characters. The permitted name is a combination of alphanumeric characters, underscore (_), and hyphen (-). Specifies the IP address in dot notations (xxx.xxx.xxx.xxx) where xxx is an integer in the range from 0 to 255.None
display-nameSpecifies the host display name within 128 characters. There are no restrictions on the permitted characters.None
descriptionSpecifies a comment about the host within 1,024 characters. There are no restrictions on the permitted characters.None
agent-hostSpecifies the host name or IP address of the Cosminexus Administration Agent. Specifies the host name within 32 characters. The permitted name is a combination of alphanumeric characters, underscore (_), and hyphen (-). Specifies the IP address in dot notations (xxx.xxx.xxx.xxx) where xxx is an integer in the range from 0 to 255.Value specified in the <host-name> tag
#1
You can omit the definition of the Web system at the re-produced destination, when the Cookie switching functionality of the load balancer is not used in the Web system at the re-produced source.
#2
If the host definition is omitted, the host name of the re-produced destination host is assumed to be the <host-name> tag, and the host will be defined.

(5) Examples of coding

The following table describes an example of items specified in the re-produced source host and re-produced destination host:

Table 4-3 Example of items specified in the re-produced source host and re-produced destination host

Setup itemsRe-produced source hostRe-produced destination host
Web system nameMyWebSystemMyWebSystem
Rules for assigning server IDs1001-10101011-1020
Host nameapsvAapsvA
IP address192.168.1.20192.168.1.21
Management IP address192.168.100.20192.168.100.21

The following example describes the scale out using the disk image created by duplicating the host apsvA. This is a coding example for scaling out the system to execute J2EE applications.

<?xml version="1.0" encoding="UTF-8"?>
<host-scaleout xmlns="http://www.cosminexus.com/mngsvr/schema/HostScaleOut-2.1">
 <!-- Definition of the Web system at the reproduction destination -->
 <web-system>
   <!-- Definition of Web system attributes -->
   <name>MyWebSystem</name>
 </web-system>
 <!-- Definition of reproduction destination host -->
 <host>
   <host-name>apsvA</host-name>
   <agent-host>192.168.100.21</agent-host>
 </host>
</host-scaleout>