HCSC server configuration definition file
Format
<?xml version="1.0" encoding="UTF-8" ?> |
Function
Specifies the configuration information for HCSC servers.
DTD
<!ELEMENT csc-setup-definition (cluster?,cosminexus-manager,reception?)> |
File storage location
service-platform-installation-directory\CSC\config\manager\templates\cscsvsetup.xml
Specifiable elements
(1) Definition of cluster
You can omit the cluster tag.
name cluster-name ~ <one-byte alphanumeric characters and underscores (_)> ((1 to 8 characters))
Specifies the cluster name. By setting up this tag, you can omit the -cluster option of the cscsvsetup command.
type cluster-type ~ <<LB>>
Specifies one of the following as the cluster type. You can omit this value in a load-balancing cluster configuration. Make sure that the value is specified in uppercase.
(2) Definition of cosminexus-manager
name Manager-name ~ <one-byte alphanumeric characters and underscores (_)> ((1 to 16 characters))
Specifies a unique identifier name for HCSC-Manager so that HCSC-Manager recognizes Manager. Specify a unique identifier name for each Manager (host) in HCSC-Manager.
ip-address IP-address-or-host-name-of-Manager ~ ((at least 1 character))
Specifies the IP address or the host name on which Management Server is running. From the second time onwards, the value gets overwritten if you change the settings and perform a re-setup.
port Port-number-of-Manager ~ ((1 to 65535))
Specifies the port number for connecting to the remote management function of Management Server.
Specifies the value of com.cosminexus.mngsvr.management.port. If no value is specified, specify 28099. From the second time onwards, the value gets overwritten if you change the settings and perform a re-setup.
id Management-Server-management-user-ID ~ ((at least 1 character))
Specifies the management user ID for Management Server.
password Management-Server-management-user-password ~ ((at least 1 character))
Specifies the management user password for Management Server. You can omit this tag. If the tag is omitted, the system assumes that no password is specified.
(3) Definition of csc-server
name HCSC-server-name ~ <one-byte alphanumeric characters and underscores (_)> ((1 to 8 characters))
Specifies the name of the HCSC server. By setting up this tag, you can omit the -csc option of the cscsvsetup command.
id user-ID-of-database-used-by-HCSC-server ~ ((at least 1 character))
Specifies the user ID of the database used by the HCSC server. The maximum string value and the specifiable characters depend on the database to be used. Make sure that you set up this element when you use a database. If no database is used, you can omit this element.
password password-of-database-used-by-HCSC-server
Specifies the password of the database used by the HCSC server. The maximum string value and the specifiable characters depend on the database to be used. Make sure that you set up this element when you use a database. If no database is used, you can omit this element.
j2ee-server-name name-of-J2EE-server-used-by-HCSC-server ~ ((at least 1 character))
Specifies the J2EE server name used to set up the HCSC server.
setup-properties HCSC-server-setup-definition-file-name
Specifies the name of the HCSC server setup definition file with a relative or an absolute path.
(4) Definition of soap-reception
Specify this element to invoke synchronous services (Web Services). Omit the soap-reception tag if you do not want to invoke synchronous services (Web Services).
ip-address IP-address-or-host-name-of-Web-server ~ <<the same IP address or host name as Manager>>
Specifies the IP address or the host name on which the Web server is running. You can omit this value if the IP address (or the host name) of the reception and Management Server is the same. From the second time onwards, the value gets overwritten if you change the settings and perform a re-setup.
port port-number-of-Web-server ~ ((1 to 65535))
Specifies the reception port number for the Web server. From the second time onwards, the value gets overwritten if you change the settings and perform a re-setup.
protocol protocol-type
Specifies one of the following as the Web server reception protocols. From the second time onwards, the value gets overwritten if you change the settings and perform a re-setup.
(5) Definition of jms-reception
Specify this element when the cluster type is the HA cluster and an asynchronous service (MDB(WS-R)) is to be invoked. You can omit the jms-reception tag if no asynchronous service (MDB(WS-R)) is to be invoked. If the cluster type is a load-balancing cluster, the value is ignored even if specified.
ip-address IP-address-or-host-name-of-Web-server ~ <<the same IP address or host name as Manager>>
Specifies the IP address or the host name on which the Web server is running. You can omit this value if the IP address (or the host name) of the reception and Management Server is the same. From the second time onwards, the value gets overwritten if you change the settings and perform a re-setup.
port port-number-of-Web-server ~ ((1 to 65535))
Specifies the reception port number for the Web server. From the second time onwards, the value gets overwritten if you change the settings and perform a re-setup.
protocol protocol-type
Specifies one of the following as the Web server reception protocols. From the second time onwards, the value gets overwritten if you change the settings and perform a re-setup.
rm-service-context-root service-context-root-for-RM ~ ((at least 1 character))
Specifies the service context root name for Reliable Messaging. From the second time onwards, the value gets overwritten if you change the settings and perform a re-setup.
(6) Definition of jms-physical-reception
Specify this element when the cluster type is a load-balancing cluster and an asynchronous service (MDB(WS-R)) is to be invoked. If you do not invoke an asynchronous service (MDB(WS-R)) or do not use Reliable Messaging, you must omit the jms-physical-reception tag. If the cluster type is the HA cluster, the value is ignored even if specified.
ip-address IP-address-or-host-name-of-Web-server ~ <<the same IP address or host name as Manager>>
Specifies the IP address or the host name on which the Web server is running. You can omit this value if the IP address (or the host name) of the reception and Management Server is the same. From the second time onwards, the value gets overwritten if you change the settings and perform a re-setup.
port port-number-of-Web-server ~ ((1 to 65535))
Specifies the reception port number for the Web server. From the second time onwards, the value gets overwritten if you change the settings and perform a re-setup.
protocol protocol-type
Specifies one of the following as the Web server reception protocols. From the second time onwards, the value gets overwritten if you change the settings and perform a re-setup.
rm-service-context-root service-context-root-for-RM ~ ((at least 1 character))
Specifies the service context root name for Reliable Messaging. From the second time onwards, the value gets overwritten if you change the settings and perform a re-setup.
(7) Definition of ejb-reception
Specify this element to invoke a SessionBean. If you do not want to invoke a SessionBean, omit the ejb-reception tag.
ip-address IP-address-or-host-name-of-NameServer ~ ((at least 1 character)) <<the same IP address or host name as Manager>>
Specifies the IP address or the host name on which the name server is running. You can omit this value if the IP address (or the host name) of the reception and Management Server is the same. From the second time onwards, the value gets overwritten if you change the settings and perform a re-setup.
port port-number-of-NameServer ~ ((1 to 65535))
Specifies the reception port number for the name server. From the second time onwards, the value gets overwritten if you change the settings and peform a re-setup.
Example of coding
An example of coding of the HCSC server configuration definition file is as follows:
<?xml version="1.0" encoding="UTF-8" ?> |
Usage
Specify the HCSC server configuration definition file in an argument of the -propfile option of the cscsvsetup command. For details on how to do this, see 3.1.3 Setting up an HCSC server in the uCosminexus Service Platform System Setup and Operation Guide.