Hitachi

uCosminexus Application Server Definition Reference Guide


4.9.1 Parameters common to all logical servers

The following table describes the parameters that can be commonly specified in each logical server.

In the table below, Default value means the value that is assumed when the parameter is not specified. VR is the version of Application Server on which parameters are introduced or changed.

Table 4‒6: Parameters common to all logical servers

Value of param-name

Value of param-value

Specifiable value

Default value

VR

additional.startcmd#1

Specifies the options to be added to the start command.

Specify alphanumeric characters and signs ($%'=^+_@:,./).

Alternatively, specify a string from 1 to 256 consecutive hyphen (-) or double backslashes (\\).

None

06-50

07-00

mstartup.force.watchtime

Specifies the time for monitoring forced termination of the logical server in seconds. When 0 is specified, monitoring is not performed. Specify 0, 60, 300, 600, or 1800.

When thread dump is output during the forced termination of a J2EE server and if the forced termination monitoring time is shorter than the time at which thread dump output ends, note that the J2EE server process will end before the thread dump output finishes completely.

Specify 0, 60, 300, 600, or 1800.

60

07-60

mstartup.no

Specifies the starting order of the server during batch start as an integer. For not executing the batch start, specify -1.

Specify the value using an integer from -1 to 999.

  • Performance tracer: 0

  • Smart Agent: 10

  • Naming Service: 20

  • CTM domain manager: 30

  • CTM: 40

  • J2EE server: 80

  • Web server: 90

  • User server: 900

07-50

mstartup.premised.serverName#2

Specifies the premise logical server.

Specify a string within 128 characters using alphanumeric characters, underscore (_), and hyphen (-).

None

07-50

mstartup.restartcnt

Specifies the automatic restart count for logical servers.

Specify 0, 1, 5, 10, or 1000.

Specify 0, 1, 5, 10, or 1000.

1

06-50

mstartup.retrywait

Specifies the automatic restart retry interval for logical servers, in seconds. Specify 0, 60, 300, 600, or 1800.

Specify 0, 60, 300, 600, or 1800.

60

06-50

mstartup.start.watchtime

Specifies the logical server start monitoring time, in seconds.

Specify 0, 60, 300, 600, or 3600.

When 0 is specified, monitoring is not performed.

Specify 0, 60, 300, 600, or 3600.

600

06-50

07-00

mstartup.watchtime

Specifies the logical server termination monitoring time, in seconds.

Specify 0, 60, 300, 600, or 1800.

When 0 is specified, monitoring is not performed.

In some cases, HWSGracefulStopTimeout directive settings are required. See 4.8.4 Notes on setting the HWSGracefulStopTimeout directive and the Manager stop watch time in the manual uCosminexus Application Server System Setup and Operation Guide.#6

Specify 0, 60, 300, 600, or 1800.

60

06-50

realservername#3

Specifies the name of the real server. Make sure that you specify a unique name within the same host. This value cannot be changed after executing the cmx_build_system command.

Specify a string within 128 characters beginning with an alphanumeric character and having alphanumeric characters, underscore (_), and hyphen (-).

logical-server-name

06-50

07-00

user.env.variable

Specifies the environment variable used for starting the server. #4 To specify multiple values, specify multiple <param-value> tags.

When specifying environment variable values, you can include the names of environment variables that have already been defined. The following is an example of specifying the value of an environment variable by including the name of an environment variable that has already been defined.

PATH=%{PATH};C:\userlib

The environment variable that has already been defined is indicated by using the format %{variable-name}. When the logical server starts, %{variable-name} is replaced by the value of the environment variable that has already been defined.

Specify any string.

None#5

07-50

#1

Cannot be specified in the logical user server.

If you want to add multiple startup options, specify multiple options demarcated by spaces in one param-value tag.

(Example)

<param-name>additional.startcmd</param-name>

<param-value>-CTMClientConnectCount 128 -CTMEntryCount 256</param-value>

#2

Cannot be specified in the logical performance tracer.

#3

Can only be specified in the logical Web server, and logical J2EE server.

#4

To specify multiple values, specify multiple <param-value>.

(Example)

<param-name>user.env.variable</param-name>

<param-value>AAA=1024</param-value>

<param-value>BBB=2048</param-value>

#5

If user.env.variable is not specified, the default environment variable is set up in the logical server. For details on environment variables set up in the logical server by default, see 4.1.13 Check points on setting environment variables of the logical server in the uCosminexus Application Server System Setup and Operation Guide.

#6

When specifying a value other than 0 for the Web server, specify a value that is larger than the value of the KeepAliveTimeout parameter defined for the Web server. For details about the Web server definitions, see 4.10.2 Parameters used for setting up the definitions for the Web server.