cmx_build_system (Build a Web system)

Format

Function

This command builds Web systems. Additionally, this command also changes parameters of the built system.

When you build a Web system, if a logical server name is not defined in the Easy Setup definition file, the logical server name is defined on Management Server. Note that when you build the Web system according to the registered information model, the logical server name is defined when the cmx_build_model command is executed. The following are the rules for defining the logical server name on Management Server:

Rules for defining the logical server name
The logical server name is defined in the following format:
Format

cmx_web-System-name_Service-unit-name_Type_Serial-number

Type depends on the logical server type. The following table describes the relationship between the logical server type and type:

Table 8-10 Relationship between the logical server type and type

Logical server typeType
Logical Web serverHTTP
Logical J2EE serverJ2EE
Logical performance tracerPRF
Logical SFO serverSFO
Logical CTM domain managerCTMDM
Logical CTMCTM
Logical Smart AgentSA
Logical user serverUSER
Basically 01 is set as serial-number. However, when multiple logical servers are deployed such as the system that uses CTM, a unique number is assigned.
Real server name when ACOS is used
When using ACOS as the load balancer, the cmx_build_system command creates a real server with the following name as the real server showing the destination to which the load balancer distributes requests; therefore, make sure that you do not delete the real server by mistake:
Format

cmx_rs_IP-address-of-Web-server-machine

Arguments

-s web-system-name
Specifies the Web system name.
The specified Web system is built from the registered information model.
If you omit this option, the value that is set in the cmx.websystem.name key of the .cmxrc file or the cmxclient.properties file is used. Note that if the cmx.websystem.name key is not specified in the .cmxrc file and the cmxclient.properties file, and if you execute the cmx_build_system command by omitting the -s option, an error occurs.
The -s option is invalid, when the -f option is specified.
-lb
This option is valid only when the type of load balancer used is BIG-IPv9, BIG-IPv10.1, and BIG-IPv10.2.
Specifies whether to initialize the virtual server of load balancer. Specify this option to scale out Web systems that use the load balancer built with the host-based management model.
  • keepvs
    Initializes the virtual server of the load balancer. You specify this option, when multiple hosts share the virtual server of the load balancer.
  • deletevs
    Initializes the virtual server of the load balancer.
If you omit this option, the value set in the cmx.lb key of the .cmxrc file or the cmxclient.properties file will be used. Note that if the cmx.lb key is not specified in the .cmxrc file and the cmxclient.properties file and if you omit the -lb option, deletevs is used. For the .cmxrc file, see 4.3 .cmxrc (Client settings property file) in the uCosminexus Application Server Definition Reference Guide. For the cmxclient.properties file, see 4.4 cmxclient.properties (Client common settings property file) in the uCosminexus Application Server Definition Reference Guide.
-sd
The setting information of only that logical server, for which the setting information is not distributed, is distributed to the server of each host. Set up this option when you do not want to distribute the setting information to the server of each host forcefully (overwrite).
-ns
You specify this option to build the system containing the logical server that is not associated with the Web system using the registered information model.
When you specify this option, you must use the cmx_build_model command to register the information model. For details on the cmx_build_model command, see cmx_build_model.
-change
You specify this option to change parameters.
This option re-generates the Web system information model according to the contents of the Easy Setup definition file that is specified in the -f option. This option also re-builds the Web system on the basis of the information model.

Input examples

Return values

0:
The command terminated normally.
1:
The command terminated with a warning.
64:
The command terminated abnormally.

Notes

When you specify the -change option, note the following points: