4.4.1 Details of configuration change definition files

Organization of this subsection

(1) Format
(2) File storage location
(3) Functionality
(4) Specifiable elements

(1) Format

This file is in the XML format.

To Page Top

(2) File storage location

Store this file at any work location.

To Page Top

(3) Functionality

These are definition files used to change the configuration of a Web system built using commands of the Smart Composer functionality. There are two configuration change definition files, one for changing logical server parameters, and the other for adding a service unit or a host.

Copy and use the following template files:

For changing logical server parameters:

In Windows

Cosminexus-installation-directory\manager\config\templates\cmxmodcombinedmodel.xml
In UNIX

/opt/Cosminexus/manager/config/templates/cmxmodcombinedmodel.xml

Note:: The configuration change definition file for changing the logical server parameters is used for compatibility with the earlier versions. For changing the logical server parameters, use the Easy Setup definition file.

For adding a service unit or a host:

In Windows

Cosminexus-installation-directory\manager\config\templates\cmxaddcombinedmodel.xml
In UNIX

/opt/Cosminexus/manager/config/templates/cmxaddcombinedmodel.xml

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

To Page Top

(4) Specifiable elements

In the configuration change definition files, you can specify some of the tags that are specified in a Easy Setup definition file.

The following describes the difference between a configuration change definition file and a Easy Setup definition file.

(a) Configuration change definition file for changing logical server parameters

This subsection shows the structure of a configuration change definition file for changing logical server parameters. Specify the <model-modification> and <web-system> tags in this format.

Structure of a configuration change definition file for changing logical server parameters

<model-modification xmlns="http://www.cosminexus.com/mngsvr/schema/ModelModification-2.5">
  <!--  Definition of the Web system subject to configuration change -->
  <web-system>
    <!-- Definition of the Web system attributes subject to configuration change -->
    <name>Web-system-name</name>
 
    <!-- Logical server definition for physical tier for which parameters are to be changed -->
    <tier>
      <tier-type>type-of-physical-tier</tier-type>
      <configuration>
        <logical-server-type>type-of-logical-server</logical-server-type>
        <param>
          <param-name>parameter-name</param-name>
          <param-value>parameter-value-1</param-value>
             :
          <param-value>parameter-value-n</param-value>
        </param>
        <param>
           :
      </configuration>
      <configuration>
         :
    </tier>
    <tier>
       :
 
    <!-- Logical server definition for service unit for which parameters are to be changed -->
    <unit>
      <name>service-unit-name</name>
      <allocated-host>
        <host-ref>host-name-or-IP-address-of-host-configuring-the-service-unit</host-ref>
        <hosts-for>type-of-physical-tier-to-which-the-component-host-belongs</hosts-for>
        <define-server>
          <logical-server-type>type-of-logical-server</logical-server-type>
          <configuration>
            <param>
              <param-name>parameter-name</param-name>
              <param-value>parameter-value-1</param-value>
                 :
              <param-value>parameter-value-n</param-value>
            </param>
            <param>
               :
          </configuration>
          <configuration>
             :
      </allocated-host>
      <allocated-host>
          :
    </unit>
    <unit>
       :
  </web-system>
  <web-system>
     :
</model-modification>

The following describes how this file is different from a Easy Setup definition file in each definition.

Definition of Web system attributes
- For the Web system name in the <name> tag, specify the name of the Web system whose configuration is to be changed.
Definition of physical tier

Specify this definition if you are changing the configuration for a type of logical server in the physical tier.
- Make sure that you define the <configuration> tag. However, this tag can be omitted if the configuration of the physical tier is created by using the cmx_trans_param command to expand an abstract parameter.
- You can omit the <param-value> tag. When this tag is omitted, the system deletes all parameter values that have been set and restores the default values.
Definition of service unit

Specify this definition if you are changing the configuration for a specific logical server in a service unit.
- If the <j2ee-server-count> tag is specified in the physical tier definition in the Web system for CTM, make sure to specify the <server-no> tag for changing the configuration of the specific J2EE server.
- You can omit the <param-value> tag. When this tag is omitted, the system deletes all parameter values that have been set and restores the default values.

For details about the tags that can be specified for each definition, see 4.7 Tags that can be specified in the Easy Setup definition file and the configuration change definition files.

(b) Configuration change definition file for adding a service unit or a host

This subsection shows the structure of a configuration change definition file for adding a service unit or a host. Specify the <unit-addition> and <web-system> tags in this format.

Structure of a configuration change definition file for adding a service unit or a host

<unit-addition xmlns="http://www.cosminexus.com/mngsvr/schema/UnitAddition-2.5">
  <!-- Definition of the Web system subject to configuration change -->
  <web-system>
    <!-- Definition of the Web system attributes subject to configuration change -->
    <name>Web-system-name</name>
    <addition-mode>addition-mode</addition-mode>
 
    <!-- Definition of service unit to be added -->
    <unit>
      <name>service-unit-name</name>
      <display-name>display-name-of-service-unit</display-name>
      <description>comment-on-service-unit</description>
      <allocated-host>
        <host-ref>host-name-or-IP-address-of-host-configuring-the-service-unit</host-ref>
        <hosts-for>type-of-physical-tier-to-which-component-host-belongs</hosts-for>
        <define-server>
          <logical-server-name>logical-server-name</logical-server-name>
          <display-name>display-name-of-logical-server</display-name>
          <description>comment-on-logical-server</description>
          <logical-server-type>type-of-logical-server</logical-server-type>
          <configuration>
            <param>
              <param-name>parameter-name</param-name>
              <param-value>parameter-value-1</param-value>
                : 
              <param-value>parameter-value-n</param-value>
            </param>
            <param>
              : 
          </configuration>
          <configuration>
            : 
      </allocated-host>
      <allocated-host>
         : 
    </unit>
    <unit>
      : 
  </web-system>
  <web-system>
    : 
 
  <!-- Definition of host to be added -->
  <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-Administration-Agent</agent-host>
    <agent-port>port-number-of-Cosminexus-Administration Agent</agent-port>
  </host>
  <host>
    : 
</unit-addition >

The following describes how this file is different from a Easy Setup definition file in each definition.

Definition of Web system attributes
- For the Web system name in the <name> tag, specify the name of the Web system whose configuration is to be changed.
- To implement scale out using JP1/SC/DPM, specify "DEPLOYED" in the <addition-mode> tag. The <addition-mode> tag can only be specified in the configuration change definition file for adding service units and hosts.
Definition of service unit
- The same as for a Easy Setup definition file.
Definition of host
- The same as for a Easy Setup definition file.

For details about the tags that can be specified for each definition, see 4.7 Tags that can be specified in the Easy Setup definition file and the configuration change definition files.

To Page Top