4.7 Configuration change definition files

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

(1) Format

This file is in the XML format.

(2) File storage location

Store this file at any work location.

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

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

For details about the tags that can be specified for each definition, see 4.10 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.

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