4.3 .cmxrc (client setting properties file)

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

(1) Format

This file is in the Java properties format.

(2) File storage location

The file is stored in the home directory of an OS user who executes commands.

(3) Functionality

This file is used to set default values for common arguments of the commands provided by the Smart Composer functionality. You use this file to set default values for an individual client.

Copy and use the following template files:

(4) Specifiable keys

The following table lists the specifiable keys. Note that Default value is the value that is assumed when a parameter is not specified.

VR is the version of Application Server on which parameters are introduced or changed.

Key nameContentsSpecifiable valueDefault valueVR
cmx.connect.host#1Sets host names and IP addresses to be assumed when the -m option is omitted in common arguments.
The IP address can be specified as a regular expression using meta characters. If the IP address is specified as a regular expression, the matching IP address will be used from the available local IP addresses.#2
The values that can be specified are as follows:
  • Host name
  • IPv4 address
None06-50
cmx.connect.useridSets the user ID to be assumed when the -u option is omitted in the common arguments.
Specification of this key is ignored if the functionality to omit the management user account is enabled.
User ID of management user account of Management ServerNone06-50
cmx.connect.passwdSets the password to be assumed when the -p option is omitted in the common arguments.
Specification of this key is ignored if the functionality to omit the management user account is enabled.
Management user account password of Management ServerNone06-50
cmx.waitSets true to treat the -wait option in the common argument as the default, and false to treat the -nowait option as the default.The following strings can be specified:
  • true
  • false
false06-50
cmx.verboseSets true to treat the -verbose option in the common argument as the default, and false to treat the -noverbose option as the default.The following strings can be specified:
  • true
  • false
false06-50
cmx.websystem.nameSpecifies the Web system name when the -s option of the following commands is omitted:
  • cmx_build_system#3
  • cmx_define_application#4
  • cmx_define_resource
  • cmx_delete_serverref#4
  • cmx_delete_system
  • cmx_deploy_application#4
  • cmx_deploy_resource
  • cmx_list_model#5
  • cmx_list_status
  • cmx_resume_lb#4
  • cmx_start_application#4
  • cmx_start_resource
  • cmx_start_target
  • cmx_stop_application#4
  • cmx_stop_resource
  • cmx_stop_target
  • cmx_test_lb#4
  • cmx_undefine_application#4
  • cmx_undefine_resource
  • cmx_undeploy_application#4
  • cmx_undeploy_resource
Web system nameNone07-50
cmx.lb#4Specifies operations for the virtual server of the load balancer, when the -lb option of the cmx_delete_system command is omitted.
  • keepvs:The virtual server is not deleted.
  • deletevs:The virtual server is deleted.
The following strings can be specified:
  • keepvs
  • deletevs
None07-10
cmx.encodingSpecifies a character encoding assumed when the -encoding option of the cmx_export_model command is omitted.
For details about specifiable values, see cmx_export_model (EasySetup definition file output) in the uCosminexus Application Server Command Reference Guide.
Character encoding nameUTF-807-50
cmx.indentSpecifies the indent size assumed when the -indent option of the cmx_export_model command is omitted.
For details about specifiable values, see cmx_export_mode l(EasySetup definition file output) in the uCosminexus Application Server Command Reference Guide.
Integers from 0 to 8207-50
cmx.myhostSpecifies the host name of the management server machine assumed when the -myhost option of the cmx_export_model command is omitted.
For details about specifiable values, see cmx_export_mode l(EasySetup definition file output) in the uCosminexus Application Server Command Reference Guide.
Host nameNone07-50
#1
In the following cases, if a value is specified in webserver.connector.http.bind_host of mserver.properties, also specify the same value in the cmx.connect.host key:
  • When operating the system for executing J2EE applications in the host unit management model
  • In the system for executing batch applications
#2
If the IP address subnet used in the communication with the Administration Agent in the management domain is fixed, and if the IP address to be specified is coded as 192\\.168\\.0\\..+, the IP address matches with the IP address starting with 192.168.0. (for example, 192.168.0.32 or 192.168.0.128), so the setup file can be distributed to all the hosts and can be used without modifications. For details on the regular expressions, check the specifications for the java.util.regex.Pattern class in Java.
If multiple IP addresses matching with the specified regular expression are detected, the IP address with the smallest value is used. For example, if 192.168.0.32 and 192.168.0.128 are detected, 192.168.0.32 will be used. In this case, the used IP address is not always the intended IP address, therefore, make sure to code a regular expression such as 192\\.168\\.0\\.1.. to match with only one IP address.
Note the following points for specifying the IP address as a regular expression:
  • When specifying a backslash (\), specify a double backslash (\\). A double backslash (\\) will replace a single backslash (\).
  • Do not specify a colon (:). The text after the colon is considered as a port number.
If a value is specified in webserver.connector.http.bind_host of mserver.properties, specify the same value.
#3
If the -f option is specified when the cmx_build_system command is executed, the key settings are not applied.
#4
Cannot be used in the system for executing batch applications.
#5
When the cmx.websystem.name key is set up, and if you use the cmx_list_model command for acquiring all the registered Web system information models, specify the -all option.

(5) Examples of coding

cmx.connect.host=localhost:28080
cmx.connect.userid=admin
cmx.connect.passwd=p1574809
cmx.wait=true
#cmx.verbose=false
cmx.websystem.name=MyWebSystem
cmx.lb=deletevs

(6) Precautions