![[Contents]](FIGURE/CONTENT.GIF)
uCosminexus Service Platform, Setup and Operation Guide
![[Glossary]](FIGURE/GLOSS.GIF)
![[Index]](FIGURE/INDEX.GIF)
![[Back]](FIGURE/FRONT.GIF)
![[Next]](FIGURE/AFTER.GIF)
When performing setup by using the Easy Setup functionality for the HCSC production environment, use the template files to create the definition files. Also, when changing the set up information, change the created definition file. Note that the template files are stored in the following directory:
<Service Platform installation directory>\CSC\config\manager\templates\hsetup\esb
The following table describes whether the definition files and template files to be used with the Easy Setup functionality for the HCSC production environment are provided. Note that this subsection describes the items that are edited when the definition files are created or changed, and the items for which values different from default values are set up in the Easy Setup functionality for the HCSC production environment. For details on the items and definition files other than those described here, see the manual description locations listed in the "Reference manual" and "Reference section" columns in the table.
Table 3-32 Table Provision of definition files and template files used with the Easy Setup functionality for the HCSC production environment
| No. | Definition file name | Creatability during setup | Changeability | Existence of template file | Reference manual | Reference section |
|---|---|---|---|---|---|---|
| 1 | Manager configuration file (manager.cfg) | M | -- | Yes | Application Server Definition Reference Guide | 10.10 |
| 2 | Administration Agent property file (adminagent.properties) | M | -- | Yes | 10.2 | |
| 3 | Management Server environment configuration file (mserver.properties) | M | -- | Yes | 10.7 | |
| 4 | Client common settings property file (cmxclient.properties) | M | -- | Yes | 4.4 | |
| 5 | Client common definition file (mngsvrutilcl.properties) | M | -- | Yes | 10.17 | |
| 6 | snapshot log primary delivery target definition file (snapshotlog.conf) | Y | -- | No | 12.2 | |
| 7 | snapshot log secondary delivery target definition file (snapshotlog.2.conf) | Y | -- | No | 12.2 | |
| 8 | Server definition file (SOAP Communication Infrastructure) (c4websv.cfg) | M | -- | Yes | Application Server SOAP Application Development Guide | 10.2 |
| 9 | Common definition file (SOAP Communication Infrastructure) (c4webcom.cfg) | M | -- | Yes | 10.4 | |
| 10 | HCSC-Manager definition file (cscmng.properties) | M | -- | Yes | Service Platform Reference Guide | HCSC-Manager definition file |
| 11 | HCSC-Manager command definition file (csccmd.properties) | M | -- | Yes | HCSC-Manager command definition file | |
| 12 | HCSC server configuration definition file (cscsvsetup.xml) | M | -- | Yes | HCSC server configuration definition file | |
| 13 | HCSC server setup definition file (cscsvsetup.properties) | M | -- | Yes | HCSC server setup definition file | |
| 14 | HCSC server runtime definition file (cscsvconfig.properties) | M | -- | Yes | HCSC server runtime definition file | |
| 15 | User-defined reception runtime definition file (cscurcptnconfig_id.properties) | A | Y# | Yes | user-defined reception runtime definition file | |
| 16 | Service-information change definition file (cscadpconfig.properties) | A | Y# | Yes | Service-information change definition file | |
| 17 | Easy Setup definition file (SOA.xml) | M | Y# | Yes | Application Server Definition Reference Guide | 4.6 |
| 18 | HTTP Server definition file (httpsd.conf) | A | x | No | HTTP Server | Specific location not applicable. |
| 19 | cscsetup command definition file (cscsetup.properties) | Y | -- | Yes | Service Platform Reference Guide | cscsetup command definition file |
| Information to be changed | Definition file to be changed |
|---|---|
| Service information | Service-information change definition file (cscadpconfig.properties) |
| Definition information for user-defined receptions | User-defined reception runtime definition file (cscurcptnconfig_id.properties) |
| Definition information for servers | Easy Setup definition file (SOA.xml) |
The format for describing the definition files in this subsection is as follows:
| Item name | Default value | Values specified in the Easy Setup functionality for the HCSC production environment | Description |
|---|---|---|---|
| com.cosminexus.manager.log.dir# | <Manager installation directory>¥log | -- | Specifies the Manager log output directory. |
| Item name | Default value | Values specified in the Easy Setup functionality for the HCSC production environment | Description |
|---|---|---|---|
| com.cosminexus.manager.log.compatible | true | false | Specifies the upward compatibility of Manager log. |
| Item name | Default value | Values specified in the Easy Setup functionality for the HCSC production environment | Description |
|---|---|---|---|
| adminagent.adapter.port# | 20295 | 20295 | Specifies the port number used by Administration Agent. Must match the value of <agent-port> under <host> in the Easy Setup definition file (SOA.xml). |
| adminagent.snapshotlog.log_dir# | <directory specified in com.cosminexus.manager.log.dir of manager.cfg >¥snapshot | -- | Specifies the snapshot log output destination directory as a character string. |
| adminagent.j2ee.watch.interval | 10 | 10 | Specifies the operation confirmation interval for J2EE servers in seconds. |
| adminagent.hws.watch.interval | 10 | 10 | Specifies the operation confirmation interval for HTTP Server in seconds. |
| adminagent.j2ee.watch.retry_count | 1 | 1 | Specifies the retry count when the operation confirmation processing fails during the confirmation of J2EE server operations. |
| adminagent.hws.watch.retry_count | 1 | 1 | Specifies the retry count when the operation confirmation processing fails during the confirmation of HTTP Server operations. |
| adminagent.j2ee.watch.start_time | 45 | 45 | Specifies the time period from the execution of the start command to the start of operation confirmation when the J2EE server is started, in seconds. |
| adminagent.hws.watch.start_time | 0 | 0 | Specifies the time period from the execution of the start command to the start of operation confirmation when HTTP Server is started, in seconds. |
| adminagent.j2ee.watch.timeout | 60 | 60 | Specifies the time until timeout during the confirmation of J2EE server operations, in seconds. |
| adminagent.hws.watch.timeout | 60 | 60 | Specifies the time until timeout during the confirmation of HTTP Server operations, in seconds. |
| Item name | Default value | Values specified in the Easy Setup functionality for the HCSC production environment | Description |
|---|---|---|---|
| adminagent.adapter.allowedHosts | -- | localhost | Specifies the host name or IP address that is allowed access to the server. |
| adminagent.adapter.bind_host | localhost | -- | Specifies the host name or IP address to be used for communication with Administration Agent. |
| adminagent.hws.watch.method | HEAD | OPTIONS | Specifies the HTTP method for confirming the HTTP Server operations when 2 is specified in adminagent.hws.watch.level. |
| adminagent.snapshotlog.num_snapshots | 10 | 4 | Specifies the number of snapshot log files for each logical server, collected as primary data. |
| adminagent.snapshotlog.listfile.2.num_snapshots | 10 | 4 | Specifies the number of snapshot log files for each logical server, collected as secondary data. |
| adminagent.j2ee.process.console_log.enabled | false | true | Specifies whether to output the console output information of a J2EE server to the console log. |
| Category | Item name | Default value | Values specified in the Easy Setup functionality for the HCSC production environment | Description |
|---|---|---|---|---|
| Settings for the port number used by Management Server | webserver.connector.ajp13.port# | -- | 28009 | Specifies the port number for internal communication of Management Server. |
| webserver.connector.http.port# | -- | 28080 | Specifies the HTTP port number for Management Server connection. This value must match the value of cmx.connect.host in the client common settings property file (cmxclient.properties), and the value of mngsvrutil.connect.host in the client common definition file (mngsvrutilcl.properties). | |
| webserver.shutdown.port# | -- | 28005 | Specifies the port number for receiving the Management Server termination requests. | |
| ejbserver.naming.port# | 28900 | 28900 | Specifies the port number to be used for internal management by Management Server. | |
| webserver.connector.http.permitted.hosts# | When not defined: * When not set up: localhost |
* | Specifies the host that is allowed to access Management Server and IP address or host name of the Administration Agent operating host. | |
| Settings for operations of error detection commands | com.cosminexus.mngsvr.management.port# | 28099 | 28099 | Specifies the external connection port number for the Management Server remote management function. |
| com.cosminexus.mngsvr.management.listen.port# | 0 | 0 | Specifies the port number for client connection, which is created during an external connection to the Management Server remote management function. | |
| Settings for the HCSC operation mode | ejbserver.server.edition.settingforce | Smart | -- | Specifies whether Management Server is to be used from HCSC-Manager.
|
| Category | Item name | Default value | Values specified in the Easy Setup functionality for the HCSC production environment | Description |
|---|---|---|---|---|
| Settings for operations of error detection commands | com.cosminexus.mngsvr.management.enabled | false | true | Specifies whether to enable the Management Server remote management function. |
| com.cosminexus.mngsvr.management.connector.enabled | false | true | Specifies whether to enable the external connection to the Management Server remote management function. | |
| com.cosminexus.mngsvr.management.host | -- | localhost | Specifies the host name or IP address when fixing the host of the external connection to the Management Server remote management function. | |
| java.rmi.server.hostname | -- | localhost | Specifies the host name or IP address when fixing the host of the external connection to the Management Server remote management function. |
| Item name | Default value | Values specified in the Easy Setup functionality for the HCSC production environment | Description |
|---|---|---|---|
| cmx.apply_user# | -- | SYSTEM, Administrator | Specify the user ID of the OS for the client that applies this file. |
| cmx.connect.host# | -- | localhost: 28080 | Specifies the host name and port number that is assumed when the -m option of the common arguments is omitted. This value must match the value of webserver.connector.http.port in the Management Server environment configuration file (mserver.properties), and the value of mngsvrutil.connect.host in the client common definition file (mngsvrutilcl.properties). |
| Item name | Default value | Values specified in the Easy Setup functionality for the HCSC production environment | Description |
|---|---|---|---|
| cmx.connect.userid | -- | admin | Specifies the user ID that is assumed when the -u option of the common arguments is omitted. |
| cmx.connect.passwd | -- | admin | Specifies the password that is assumed when the -p option of the common arguments is omitted. |
| cmx.verbose | false | true | Specify true to set the -verbose option of the common arguments as the default, and specify false to set the -noverbose option as the default. |
| cmx.websystem.name | -- | SOA | Specifies the Web system name used when the -s option of the following commands is omitted:
|
| Item name | Default value | Values specified in the Easy Setup functionality for the HCSC production environment | Description |
|---|---|---|---|
| mngsvrutil.apply_user# | -- | SYSTEM,Administrator | Specifies the user who applies the client common definition file in the OS user when executing the mngsvrutil command or adapter command. |
| mngsvrutil.connect.host# | -- | localhost: 28080 | Specifies the host name and port number of Management Server specified in the -m option of the mngsvrutil command. This value must match the value of webserver.connector.http.port in the Management Server environment configuration file (mserver.properties), and the value of cmx.connect.host in the client common settings property file (cmxclient.properties). |
| Item name | Default value | Values specified in the Easy Setup functionality for the HCSC production environment | Description |
|---|---|---|---|
| mngsvrutil.connect.password | -- | admin | Specifies the password to be specified in the -p option of the mngsvrutil command. |
| mngsvrutil.connect.userid | -- | admin | Specifies the user ID to be specified in the -u option of the mngsvrutil command. |
| mngsvrutil.target_name | -- | J2EEServer | Specifies the logical server name or host name to be specified in the -t option of the mngsvrutil command. |
| Category | Item name | Default value | Values specified in the Easy Setup functionality for the HCSC production environment | Description |
|---|---|---|---|---|
| Directory to be collected | %val%# | -- | -- | Specifies the output destination of the HCSC-Manager log file. If cscmng.log.dir is customized in cscmng.properties, the following two values must be added. If cscmng.log.dir is not customized, the log file output destination is already specified, so the values need not be added.
|
| Category | Item name | Default value | Values specified in the Easy Setup functionality for the HCSC production environment | Description |
|---|---|---|---|---|
| Directory for collection | %val%# | -- | -- | Specifies the output destination for the backup file of HCSC-Manager. If cscmng.backup.dir is customized in cscmng.properties, the following two values must be added. If cscmng.backup.dir is not customized, the backup file output destination is already specified, so the values need not be added.
|
| %val%# | -- | -- | Specifies the location for allocating the repository. If cscmng.repository.dir is customized in cscmng.properties, the following three values must be added. If cscmng.repository.dir is not customized, the repository allocation location is already specified, so the values need not be added.
|
| Category | Item name | default value | Values specified in the Easy Setup functionality for the HCSC production environment | Description |
|---|---|---|---|---|
| Log settings | c4web.logger.aplog_error_record | NONE | ALL | Specifies the settings for the output of application log when an error occurs. |
| Category | Item name | Default value | Values specified in the Easy Setup functionality for the HCSC production environment | Description |
|---|---|---|---|---|
| Repository settings | cscmng.repository.root# | <Service Platform installation directory>¥CSC¥repository | -- | Specifies the root directory of the repository with the absolute path. |
| Log settings | cscmng.log.dir# | <Service Platform installation directory>¥CSC¥log¥manager | -- | Specifies the log output destination directory with the absolute path. |
| Environment backup | cscmng.envbackup.dir# | Current directory | -- | Specifies the output destination directory for the environment backup file when the environment is backed up with cscenvbackup. |
| Category | Item name | Default value | Values specified in the Easy Setup functionality for the HCSC production environment | Description |
|---|---|---|---|---|
| Settings for HCSC server operation | cscmng.server.HCSC.system | -- | WebServer,PRF | Specifies the logical servers to be managed in the HCSC system. |
| Category | Item name | Default value | Values specified in the Easy Setup functionality for the HCSC production environment | Description |
|---|---|---|---|---|
| Common command definitions | csc.all.user | -- | admin | Specifies the default values for the arguments common to all the commands. |
| csc.all.pass | -- | admin | ||
| csccompoconfig common definitions | csc.compoconfig.operation | -- | get | |
| csc.compoconfig.csc | -- | HCSC | ||
| csccompodeploy common definitions | csc.compodeploy.csc | -- | HCSC | |
| csccompostart common definitions | csc.compostart.csc | -- | HCSC | |
| csccompostop common definitions | csc.compostop.csc | -- | HCSC | |
| csccompoundeploy common definitions | csc.compoundeploy.csc | -- | HCSC | |
| cscrcptnstart common definitions | csc.rcptnstart.csc | -- | HCSC | |
| cscrcptnstop common definitions | csc.rcptnstop.csc | -- | HCSC | |
| cscresinfo common definitions | csc.resinfo.csc | -- | HCSC | |
| cscstatus common definitions | csc.status.csc | -- | HCSC | |
| csc.status.type | -- | system | ||
| cscsvconfig common definitions | csc.svconfig.operation | -- | get | |
| csc.svconfig.csc | -- | HCSC | ||
| cscsvstart common definitions | csc.svstart.csc | -- | HCSC | |
| cscsvstop common definitions | csc.svstop.csc | -- | HCSC | |
| csc.svstop.force | -- | Not set up |
| Category | Item name | Default value | Values specified in the Easy Setup functionality for the HCSC production environment | Description |
|---|---|---|---|---|
| Definition of manager | <port>port number of Manager</port># | 28099 | 28099 | Specifies the port number for connecting to the remote management function of Manager. This value must match the value of com.cosminexus.mngsvr.management.port in Management Server environment configuration file (mserver.properties). |
| Category | Item name | Default value | Values specified in the Easy Setup functionality for the HCSC production environment | Description |
|---|---|---|---|---|
| Definition of cluster | <name>Cluster name</name> | -- | Cluster | Specifies the cluster name. |
| Definition of manager | <name>Manager name</name> | -- | Manager | Specifies the HCSC-Manager-specific distinguished name used by HCSC-Manager to identify Manager. |
| <ip-address>IP address of Manager</ip-address> | -- | localhost | Specifies the IP address where Management Server is started. | |
| <id>Management User ID of Manager</id> | -- | admin | Specifies the Management User ID of Management Server. | |
| <password>Management User password of Management Server</password> | -- | admin | Specifies the Management User password of Management Server. | |
| Definition of csc-server | <name>HCSC server name</name> | -- | HCSC | Specifies the HCSC server name. |
| <j2ee-server-name>Name of J2EE server that sets up the HCSC server </j2ee-server-name> | -- | J2EEServer | Specifies the name of the J2EE server where HCSC server is set up. | |
| <setup-properties>HCSC server setup definition file name</setup-properties> | -- | cscsvsetup.properties | Specifies the name of the HCSC server setup definition file with the relative path, or absolute path. | |
| Definition of soap-reception | <ip-address> IP address of %Web server</ip-address> | -- | localhost | Specifies the IP address where the Web server is running. |
| <port>Port number of %Web server</port> | -- | 80 | Specifies the reception port number of the Web server. | |
| <protocol>Protocol type</protocol> | -- | http | Specifies the Web server reception protocol. |
| Category | Item name | Default value | Values specified in the Easy Setup functionality for the HCSC production environment | Description |
|---|---|---|---|---|
| Related to setup configuration | db-use | -- | OFF | Specifies whether to use a database with HCSC server. |
| rm-use | -- | OFF | Specifies whether to use Reliable Messaging with HCSC server. | |
| Related to standard receptions | request-ejb | -- | OFF | Specifies whether to use the standard synchronous reception (SessionBean). |
| request-soap | -- | ON | Specifies whether to use the standard synchronous reception (Web service). | |
| request-jms | -- | OFF | Specifies whether to use the standard asynchronous reception (MDB (WS-R)). | |
| request-dbq | -- | OFF | Specifies whether to use the standard asynchronous reception (MDB and (DB queue)). | |
| Related to user-defined receptions | request-userdef-soap | -- | ON | Specifies whether to use SOAP receptions. |
| Category | Item name | Default value | Values specified in the Easy Setup functionality for the HCSC production environment | Description |
|---|---|---|---|---|
| Data transformation | xmltelegram-namespace-complement | -- | ON | Specifies whether to complement the name space declaration corresponding to the name space prefix specified for the attribute values in an XML message for the XML messages flowing in the HCSC server. |
| Item name | Default value | Values specified in the Easy Setup functionality for the HCSC production environment | Description |
|---|---|---|---|
| user-defined-reception-soap.threads.maximum# | 10 | 20 | Specifies the maximum number of concurrent executions of the SOAP reception. |
| user-defined-reception-soap.exclusive.threads# | 0 | 0 | Specifies the number of dedicated threads of the SOAP reception. |
| user-defined-reception-soap.queue-size# | 8192 | 10 | Specifies the pending queue size of the SOAP reception. |
| Category | Item name | Default value | Values specified in the Easy Setup functionality for the HCSC production environment | Description |
|---|---|---|---|---|
| Service information of the SOAP adapter | Cluster.<service ID>.WebService.url#1 | Value specified during service adapter development | -- | Specifies the URL to be used for invoking a service component. |
| Cluster.<service ID>.WebService.c4web.application.socket_read_timeout#2 | 300 | -- | Specifies the read timeout value for the service adapter socket in seconds. |
| Category | Parameters to be specified in <param-name> | Default value | Values specified in the Easy Setup functionality for the HCSC production environment | Content specified in <param-value> |
|---|---|---|---|---|
| Service unit definition/ HTTP Server definition/ common configuration definitions for logical servers | mstartup.force.watchtime | 60 | 60 | Specifies the forced-stop monitoring time for the logical servers in seconds. |
| mstartup.restartcnt | 1 | 1 | Specifies the auto-restart count for the logical servers. | |
| mstartup.retrywait | 60 | 60 | Specifies the auto-restart retry interval for logical servers in seconds. | |
| mstartup.start.watchtime | 60 | 60 | Specifies the start monitoring time for logical servers in seconds. | |
| mstartup.watchtime | 60 | 60 | Specifies the stop monitoring time for logical servers in seconds. | |
| Service unit definition/ HTTP Server definition/ configuration definition for HTTP Server/ Web server definitions | Listen#1 | -- | 80 | Specifies the IP address and port number that receives the request. |
| ThreadsPerChild#2 | 40 | 50 | Specifies the number of server threads to be started.Specify this definition only in Windows. | |
| Service unit definition/ HTTP Server definition/ configuration definition for HTTP Server/ redirector operation definition for HTTP Server | JkLogFileDir#1 | logs | -- | Specifies the log file output destination directory. In Windows, use "¥" as the path separation character. Note that forward slash (/) cannot be specified. |
| JkTraceLogFileDir#1 | logs | -- | Specifies the output destination directory for maintenance trace log files. In Windows, use "¥" as the path separation character. Note that forward slash (/) cannot be specified. | |
| Service unit definition/ HTTP Server definition/ configuration definition for HTTP Server/ worker definition | worker.default.cachesize#2 | 64 | 40 | Specifies the number of worker connections that are reused by the redirector. Specify this definition only in Windows. |
| worker.default.port#1 | -- | 8007 | Specifies the worker port number. This value must match the value of webserver.connector.ajp13.port in the Easy Setup definition file (SOA.xml). | |
| worker.default.receive_timeout#2 | 3600 | 3600 | Specifies the communication timeout value in seconds. | |
| Service unit definition/ HTTP Server definition/ configuration definition for HTTP Server/ HTTP Server log output definition | CustomDivideFileNum#1 | 8 | 8 | Specifies the number of divided log files. |
| HttpsdLogFileDir#1 | logs | -- | Specifies the output destination directory for the log output by the Web server. In Windows, use "¥" as the path separation character. Note that forward slash (/) cannot be specified. | |
| Service unit definition/ J2EE server definition/ common configuration definitions for logical servers | mstartup.force.watchtime | -- | 60 | Specifies the forced-stop monitoring time of the logical server in seconds. |
| mstartup.restartcnt | -- | 1 | Specifies the auto-restart count of the logical server. | |
| mstartup.retrywait | -- | 60 | Specifies the auto-restart retry interval of the logical server in seconds. | |
| mstartup.start.watchtime | -- | 600 | Specifies the start monitoring time for logical servers in seconds. | |
| mstartup.watchtime | -- | 60 | Specifies the stop monitoring time of the logical servers in seconds. | |
| user.env.variable | -- | Not set | Specifies the environment variables for starting the server. | |
| JAVACOREDIR=%val%#1 | -- | -- | Specifies the output destination for the JavaVM thread dump. In Windows, use "¥" as the path separation character. Note that forward slash (/) cannot be specified. | |
| Service unit definition/ J2EE server definition/ J2EE server configuration definition/ user properties/ parameters beginning with ejbserver.http | ejbserver.http.port#1 | 8080 | 8080 | Specifies the port number of the simple web server. |
| Service unit definition/ J2EE server definition/ J2EE server configuration definition/ user properties/ parameters beginning with ejbserver.management | ejbserver.management.JVM.stats_monitor.FullGCCount.interval | 600 | 600 | Specifies the threshold value monitoring interval, in the monitoring of the full garbage collection frequency, in seconds. |
| ejbserver.management.JVM.stats_monitor.FullGCCount.threshold | 10 | 10 | Specifies the frequency that forms the threshold value, in the monitoring of the full garbage collection frequency. | |
| ejbserver.management.statistics.interval | 60 | 60 | Specifies the statistics collection interval in seconds. | |
| ejbserver.management.stats_file.dir#1 | <work directory>¥ejb¥<server name>¥stats | -- | Specifies the output destination directory of the statistics file. In Windows, use "¥" as the path separation character. Note that forward slash (/) cannot be specified. | |
| ejbserver.management.stats_file.num#1 | 7 | 8 | Specifies the number of statistics files. | |
| Service unit definition/ J2EE server definition/ J2EE server configuration definition/ user properties/ parameters beginning with ejbserver.naming | ejbserver.naming.port#1 | 900 | 900 | Specifies the port of the CORBA Naming Service that the J2EE server uses as a naming service. |
| Service unit definition/ J2EE server definition/ J2EE server configuration definition/ user properties/ parameters beginning with ejbserver.rmi | ejbserver.rmi.naming.port#1 | 23152 | 23152 | Specifies the port number of the RMI registry used by the J2EE server. |
| ejbserver.rmi.remote.listener.port#1 | 0 | 0 | Specifies the port for receiving requests when statistics is collected by a JMX client (such as Administration Agent, JP1/Performance Management - Agent Option for uCosminexus Application Server). | |
| Service unit definition/ J2EE server definition/ J2EE server configuration definition/ user properties/ parameters beginning with ejbserver.watch | ejbserver.watch.defaultRequestQueue.threshold | 80 | 80 | Specifies the threshold value that outputs an alert message. |
| Service unit definition/ J2EE server definition/ J2EE server configuration definition/user property/ parameters beginning with vbroker | vbroker.se.iiop_tp.scm.iiop_tp.listener.port#1 | 0 | 0 | Specifies the communication port to be set up for each J2EE server. |
| Service unit definition/ J2EE server definition/ J2EE server configuration definition/ user properties/ parameters beginning with webserver.connector | webserver.connector.ajp13.max_threads#2 | 10 | 20 | Specifies the number of concurrent executions for the Web container to process requests. |
| webserver.connector.ajp13.port#1 | 8007 | 8007 | Specifies the port number to be used for communication with the Web server. This value must match the value of worker.default.port in Easy Setup definition file (SOA.xml). | |
| Service unit definition/ J2EE server definition/ J2EE server configuration definition/ JavaVM option definition | -Xms%val%#2 | 256m | 1024m | Specifies the initial Java heap size. |
| -Xmx%val%#2 | 512m | 1024m | Specifies the maximum Java heap size. | |
| XX:PermSize=%val%#2 | 128m | 128m | Specifies the initial size of Permanent area. | |
| XX:MaxPermSize=%val%#2 | 128m | 128m | Specifies the maximum size of Permanent area. | |
| ejb.public.directory#1 | <work directory>¥ejb¥<server name>¥logs | -- | Specifies the work directory of the J2EE server. The J2EE server is started, considering the specified directory as the work directory. In Windows, use "¥" as the path separation character. Note that forward slash (/) cannot be specified. | |
| ejb.server.log.directory#1 | <work directory>¥ejb¥<server name>¥logs | -- | Specifies the log file output destination directory. In Windows, use "¥" as the path separation character. Note that forward slash (/) cannot be specified. | |
| Service unit definition/ PRF definition/ common configuration definitions for logical servers | mstartup.force.watchtime | 600 | 60 | Specifies the forced-stop monitoring time for logical servers in seconds. |
| mstartup.restartcnt | 1 | 1 | Specifies the auto-restart count for logical servers. | |
| mstartup.retrywait | 0 | 0 | Specifies the auto-restart retry interval for logical servers in seconds. | |
| mstartup.start.watchtime | 60 | 60 | Specifies the start monitoring time for logical servers in seconds. | |
| mstartup.watchtime | 600 | 600 | Specifies the stop monitoring time for logical servers in seconds. | |
| Service unit definition/ PRF definition/ PRF configuration definition | prfspool#1 | &{cosminexus.home}/PRF/spool | -- | Specifies the PRF trace output directory. In Windows, use "¥" as the path separation character. Note that forward slash (/) cannot be specified. |
| Host definition | -- | 20295 | 20295 | Specifies the Administration Agent port number in <agent-port>#1#3 under <host>. This value must match the value of adminagent.adapter.port in the Administration Agent property file (adminagent.properties). |
| Category | Parameters specified in <param-name> | Default value | Values specified in the Easy Setup functionality for the HCSC production environment | Content specified in <param-value> |
|---|---|---|---|---|
| Web system definition | -- | -- | SOA | Specifies the name for identifying the Web system in <name># under <web-system>. |
| Physical tier definition | -- | -- | combined-tier | Specifies the type of physical tier in <tier-type># under <tier>. |
| Service unit definition | -- | -- | Unit | Specifies the name for identifying the service unit, in <name># under <unit>. |
| -- | -- | localhost | Specifies the host name set in <name-name> in the host definition, the host name defined in the already set up Web system, or @myhost, in <host-ref># under <unit>. | |
| -- | -- | combined-tier | Specifies the type of physical tier to which the host specified in <host-ref> belongs, in <hosts-for># under <unit>. | |
| Service unit definition/ HTTP Server definition | -- | cmx_<Web system name>_<service unit name>_<type>_<serial number> | WebServer | Specifies the name for identifying the logical server or cluster, in <logical-server-name># under <define-server>. |
| -- | -- | web-server | Specifies the type of logical server defining the configuration, in <logical-server-type># under <define-server>. | |
| Service unit definition/ HTTP Server definition/ configuration definition for HTTP Server/ Web server definitions | KeepAliveTimeout | 15 | 3 | Specifies the request waiting time for a KeepAlive connection in seconds. |
| Service unit definition/ HTTP Server definition/ configuration definition for HTTP Server/ redirector operation definition for HTTP Server | JkMount | /* [J2EE server name] (for combined-tier and http-tier) | /* default | Specifies the URL pattern which is to be transmitted to the Web container server, during a request to HTTP Server. |
| Service unit definition/ HTTP Server definition/ configuration definition for HTTP Server/ worker definition | worker.default.type | -- | ajp13 | Specifies the worker type. |
| worker.default.host | -- | localhost | Specifies the host name or IP address of the worker. | |
| worker.list | -- | default | Specifies the list of worker names. | |
| Service unit definition/ HTTP Server definition/ configuration definition for HTTP Server/ HTTP Server log output definition | HttpsdErrorMethod | Div | Wrap | Specifies the error log output format. |
| HttpsdRequestMethod | Div | Wrap | Specifies the request log output format. | |
| Service unit definition/ J2EE server definition | -- | cmx_<Web system name>_<service unit name>_<type>_<serial number> | J2EEServer | Specifies the name for identifying the logical server or cluster in <logical-server-name># under <define-server>. |
| -- | -- | j2ee-server | Specifies the type of logical server defining the configuration, in <logical-server-type># under <define-server>. | |
| Service unit definition/ J2EE server definition/ common configuration definitions for logical servers | mstartup.no | -- | 80 | Specifies an integer as the order for starting the servers during a batch start operation. |
| Service unit definition/ J2EE server definition/ J2EE server configuration definition/ user properties/ parameters beginning with ejbserver.ext | ejbserver.ext.method_observation.interval | -- | 10 | Specifies whether to use the functionality for monitoring the business application execution time. Also, specifies the time interval for monitoring whether a running request has timed out, and the time interval for canceling a timed out request (method), in seconds. |
| Service unit definition/ J2EE server definition/ J2EE server configuration definition/ user properties/ parameters beginning with ejbserver.jndi | ejbserver.jndi.global.enabled | true | false | Specifies whether to register an object with the Portable Global JNDI name for the naming service, when the application starts. |
| Service unit definition/ J2EE server definition/ J2EE server configuration definition/ user properties/ parameters beginning with ejbserver.manager | ejbserver.manager.agent.MEventAgent.enabled | true | false | Specifies whether to enable the Management event issuing functionality. |
| Service unit definition/ J2EE server definition/ J2EE server configuration definition/ user properties/ parameters beginning with ejbserver.rmi | ejbserver.rmi.naming.host | -- | localhost | Specifies the host name or IP address of the RMI registry to be used as the service provider by J2EE server, in a multi-homed host environment. |
| Service unit definition/ J2EE server definition/ J2EE server configuration definition/ user properties/ parameters beginning with ejbserver.server | ejbserver.server.threaddump.filenum | 256 | 4 | Specifies the maximum number of thread dump files to be used when the J2EE server detects an error and voluntarily outputs a thread dump. |
| Service unit definition/ J2EE server definition/ J2EE server configuration definition/ user properties/ parameters beginning with webserver.connector | webserver.connector.ajp13.bind_host | -- | localhost | Specifies the IP address or host name to be used for Web server integration. |
| Service unit definition/ J2EE server definition/ J2EE server configuration definition/ JavaVM option definition | add.jvm.arg | -- | + | Specifies the output format of the extended verbosegc information in -XX:%val%HitachiCommaVerboseGC. |
| -- | + | Specifies whether to use the Explicit Memory Management functionality in -XX:%val%HitachiUseExplicitMemory. | ||
| Service unit definition/ J2EE server definition/ J2EE server configuration definition/ JavaVMsystem property | ejbserver.container.security.disabled | false | true | Specifies whether to enable the Enterprise Bean access control functionality. |
| ejbserver.ctm.enabled | true | false | Specifies whether to use the CTM functionality. | |
| ejbserver.rmi.stateless.unique_id.enabled | false | true | Specifies whether invocation is not needed for the invocation of the remove method of Stateless Session Bean. | |
| Service unit definition/ J2EE server definition/ J2EE server configuration definition/ Extension parameter of J2EE container | add.class.path | -- | <cosminexus.home>¥c4web¥lib¥hitsaaj.jar | Specifies the SOAP Communication Infrastructure as the communication base. |
| Service unit definition/ J2EE server definition/ J2EE server configuration definition/ SecurityManager | use.security | true | false | Specifies whether to use SecurityManager in the J2EE server startup options. |
| Service unit definition/ PRF definition | -- | cmx_<Web system name>_<service unit name>_<type>_<serial number> | PRF | Specifies the name for identifying the logical server or cluster, in <logical-server-name># under <define-server>. |
| -- | -- | performance-tracer | Specifies the type of logical server defining the configuration, in <logical-server-type># under <define-server>. | |
| Service unit definition/ PRF definition/ common configuration definitions for logical servers | mstartup.no | 0 | 0 | Specifies the order for starting the servers during a batch start operation. |
| Service unit definition/ PRF definition/ PRF configuration definition | PrfTraceLevel | STANDARD | 00030000 | Specifies the trace collection level of the performance tracer. |
| Host definition | -- | -- | localhost | Specifies the name or IP address for identifying the server, in <host-name># under <host>. |
| -- | Value specified in <host-name> | localhost | Specifies the host name or IP address of Administration Agent in <agent-host># under <host>. |
| Category | Item name | Default value | Values specified in the Easy Setup functionality for the HCSC production environment | Description |
|---|---|---|---|---|
| Host that is permitted to connect to Web server | <Location %val%># | -- | / | Specified to define a directive for the requests to a location indicated by a specific URL. |
| Order %val%# | -- | deny,allow | Specifies the evaluation order for setting up the Allow directive and Deny directive. | |
| Deny from %val%# | -- | all | Specified to control the clients that can access the Web server. | |
| Allow from %val%# | -- | localhost | Specified to control the clients that can access the Web server. |
| Item name | Default value | Values specified in the Easy Setup functionality for the HCSC production environment | Description |
|---|---|---|---|
| owner#1#2 | Superuser | -- | Specifies the owner to be set up in Component Container Administrator. |
| group#1#2 | Superuser | -- | Specifies the group to be set up in Component Container Administrator. |
Table 3-33 Table Set values when the owner and group values are not specified
| OS | File owner | Group name |
|---|---|---|
| Linux | root | root |
| HP-UX | root | sys |
| AIX | root | system |
All Rights Reserved. Copyright (C) 2015, Hitachi, Ltd.