8.2.6 mserver.properties (Management Server environment settings file)

adminagent.connector.comm.state.cache_max_time

Specify a numeric value from 0 to 2147483 (units: seconds) for the maximum cache duration for the status of communication with the Administration Agent. When a value lesser than 0 is specified, the communication status is not cached.

Specify the value using an integer from 0 to 2147483.

60

06-50

com.cosminexus.mngsvr.agent.read_timeout

Specify an integer (units: seconds) from 1 to 2147483 for the Management Agent connection timeout period.

Specify the value using an integer from 1 to 2147483.

180

07-00

com.cosminexus.mngsvr.jp1event.alert

Specify whether to issue Alert level events.^#3

If you specify true:

Alert level events will be issued.

If you specify false:

Alert level events will not be issued.

Specify one of the following values:

• true

• false

false

07-00

com.cosminexus.mngsvr.jp1event.emergency

Specify whether to issue Emergency level events.^#3

If you specify true:

Emergency level events will be issued.

If you specify false:

Emergency level events will not be issued.

Specify one of the following values:

• true

• false

false

07-00

com.cosminexus.mngsvr.jp1event.critical

Specify whether to issue Critical level events.^#3

If you specify true:

Critical level events will be issued.

If you specify false:

Critical level events will not be issued.

Specify one of the following values:

• true

• false

false

07-00

com.cosminexus.mngsvr.jp1event.enabled

Specify whether to enable the functionality for issuing system JP1 events.^#3

If you specify true:

Enable the functionality for issuing system JP1 events.

If you specify false:

Disable the functionality for issuing JP1 events.

Specify one of the following values:

• true

• false

false

07-00

com.cosminexus.mngsvr.jp1event.error

Specify whether to issue Error level events.^#3

If you specify true:

Error level events will be issued.

If you specify false:

Error level events will not be issued.

Specify one of the following values:

• true

• false

false

07-00

com.cosminexus.mngsvr.jp1event.information

Specify whether to issue Information level events.^#3

If you specify true:

Information level events will be issued.

If you specify false:

Information level events will not be issued.

Specify one of the following values:

• true

• false

false

07-00

com.cosminexus.mngsvr.jp1event.notice

Specify whether to issue a Notice level event.^#3

If you specify true:

Notice level events will be issued.

If you specify false:

Notice level events will not be issued.

Specify one of the following values:

• true

• false

false

07-00

com.cosminexus.mngsvr.jp1event.warning

Specify whether to issue Warning level events.^#3

If you specify true:

Warning level events will be issued.

If you specify false:

Warning level events will not be issued.

Specify one of the following values:

• true

• false

false

07-00

com.cosminexus.mngsvr.log.display_number

Specify any one of the following numbers as the maximum number of display items that the mngsvr configuration function should display as log information in the log display screen^#3:

20, 60, 100, 200, 400

Specify 20, 60, 100, 200, or 400.

100

07-00

com.cosminexus.mngsvr.log.level

Specify the level of log output for the Management Server log.^#3

• 0: Normal operation.

• 10: similar to normal operation, waiting for recurrence.

• 20: Acquire debug level information suitable for use during system building or testing phases.

• 30: Acquire detailed error information that is suitable for use, when cause investigation is difficult

Specify 0, 10, 20, or 30.

0

07-00

com.cosminexus.mngsvr.log.rotate

Specify any of the following numbers, as the number of Management Server log files^#3:

1, 2, 4, 8, 16

Specify 1, 2, 4, 8, or 16.

4

07-00

com.cosminexus.mngsvr.log.size

Specify any one of the following sizes as the Management Server log file size^#3:

4096 (4 kilobytes), 65536 (64 kilobytes), 262144 (256 kilobytes), 524288 (512 kilobytes), 1048576 (1 megabyte), 2097152 (2 megabytes), 4194304 (4 megabytes), 16777216 (16 megabytes), 67108864 (64 megabytes)

Specify one of the following values:

• 4096 (4 kilobytes)

• 65536 (64 kilobytes)

• 262144 (256 kilobytes)

• 524288 (512 kilobytes)

• 1048576 (1 megabytes)

• 2097152 (2 megabytes)

• 4194304 (4 megabytes)

• 16777216 (16 megabytes)

• 67108864 (64 megabytes)

65536

07-00

com.cosminexus.mngsvr.logical_server_abnormal_stop.exit

Specify the operation to be executed in case of abnormal stop status of operations of the logical server managed by Management Server (automatic restart frequency is exceeded or automatic restart frequency setting is 0).

If you specify true:

KEOS10038-I is output and Management Server stops.

If you specify false:

Management Server continues processing.

Specify one of the following values:

• true

• false

false

08-50

com.cosminexus.mngsvr.maintenance.log.filenum

Specify an integer from 1 to 16 for the number of Management Server maintenance log files.

Specify the value using an integer from 1 to 16.

2

06-70

com.cosminexus.mngsvr.maintenance.log.filesize

Specify an integer from 65536 to 2147483647 for the maximum file size (units: bytes) for the Management Server maintenance log file.

Specify the value using an integer from 65536 to 2147483647.

16777216

06-70

com.cosminexus.mngsvr.management.connector.enabled

Specify whether to enable an external connection to the Management Server remote management functionality.

If you specify true:

Enable an external connection to the Management Server remote management functionality.

If you specify false:

Disable an external connection to the Management Server remote management functionality.

Specify one of the following values:

• true

• false

false

07-60

com.cosminexus.mngsvr.management.enabled

Specify whether to enable the Management Server remote management functionality.

If you specify true:

Enable the Management Server remote management functionality.

If you specify false:

Disable the Management Server remote management functionality.

Specify one of the following values:

• true

• false

false

07-60

com.cosminexus.mngsvr.management.host

Specify the host name, or an IP address when the host for an external connection to Management Server remote management functionality is to be specified.

You can specify the IP address as a regular expression using meta characters. When the IP address is specified as a regular expression, the available local IP address that matches the expression is used.^#1

When the host is specified, add the java.rmi.server.hostname key in the mserver.properties file and specify the value similar to the java.rmi.server.hostname key. However, you cannot use the regular expression with meta characters in java.rmi.server.hostname.

When you specify a value to webserver.connector.http.bind_host, specify the similar value to this property.

Host name or IPv4 dotted notation

None

07-60

com.cosminexus.mngsvr.management.listen.port

Specify an integer from 0 to 65535 for the port number for client connection created at the time of external connection to the Management Server remote management functionality. If 0 is specified, a blank port number is automatically allocated.

Specify the value using an integer from 0 to 65535.

0

07-60

com.cosminexus.mngsvr.management.port

Specify an integer from 1 to 65535 for the external connection port number of the Management Server remote management functionality.

Specify the value using an integer from 1 to 65535.

28099

07-60

com.cosminexus.mngsvr.management.read_timeout

Specify an integer from 1 to 2147483 for the read timeout period (unit: second) at the time of an external connection to the Management Server remote management functionality.

Specify the value using an integer from 1 to 2147483.

180

07-60

com.cosminexus.mngsvr.management_user_account.enabled

Specify whether to enable the account of the Management Server user.

If you specify true:

Execute the login authentication process of Management Server.

If you specify false:

Do not execute the login authentication process of Management Server. You can log in without entering the management user account in the Login screen of management portal. You can also omit specification of -u and -p that are common arguments in the commands used by Manager.

Specify one of the following values:

• true

• false

true

08-50

com.cosminexus.mngsvr.on_start

Specify whether to perform batch startup of the logical servers, when the Management Server starts.^#3

If you specify true:

Batch startup of logical servers is performed.

If you specify false:

Batch startup of logical servers is not performed.

Specify one of the following values:

• true

• false

false

07-00

com.cosminexus.mngsvr.snapshot.auto_collect.enabled

Specify whether to collect a snapshot log when an error occurs or when a batch restart is performed.

If you specify true:

Snapshot log will be collected.

If you specify false:

Snapshot log will not be collected.

Specify one of the following values:

• true

• false

true

06-50

com.cosminexus.mngsvr.snapshot.collect.point

Specify the timing for snapshot log collection.

If you specify before_stop:

Snapshot log will be collected before stopping the logical server.

If you specify j2ee_restart:

Snapshot log will be collected before re-starting the J2EE server.

Specify one of the following values: Note that the value is not case sensitive.

• before_stop

• j2ee_restart

before_stop

06-50

com.cosminexus.mngsvr.sys_cmd.abnormal_end.enabled

Specify whether to use the functionality for executing error detection command by the system.

If you specify true:

The functionality for executing error detection command is enabled.

If you specify false:

The functionality for executing error detection command is disabled.

Specify one of the following values:

• true

• false

true

06-50

com.cosminexus.mngsvr.sys_cmd.abnormal_end.timeout

Specify an integer from -1 to 2147483647 (in seconds) for the waiting time for completion of the following processings:

• Commands executed during error detection by the system

• Collection of performance analysis trace

When the command or the collection of performance analysis trace does not complete even after the specified time has elapsed, the executed command or collection is ignored and the processing is continued.

When you specify -1, the processing will wait for execution of the command or collection to complete.

If a value outside the range of -1 to 2147483647 is specified, the default value is used.

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

600

06-50

com.cosminexus.mngsvr.trace

If the management command (mngsvrutil) is used to collect performance analysis traces or CTM statistics, use this key to specify the maximum number of files to be held by Management Server.

The maximum number of files is managed for each of the management domains, hosts, and logical servers.^#3

1, 2, 4, 8, 16

Specify 1, 2, 4, 8, or 16.

4

07-00

com.cosminexus.mngsvr.usr_cmd.abnormal_end.enabled

Specify whether to use the functionality for executing user-created error detection command.

If you specify true:

The functionality for executing error detection command is enabled.

If you specify false:

The functionality for executing error detection command is disabled.

Specify one of the following values:

• true

• false

false

06-50

com.cosminexus.mngsvr.usr_cmd.abnormal_end.timeout

Specify an integer from -1 to 2147483647 (units: seconds) for the period of awaiting completion of execution of the user-created error detection command.

When the command does not complete even after the specified time has elapsed, ignore the executed command, and continue the processing.

When you specifty 0, the processing will continue without waiting for the completion of the command.

When you specify -1, the processing will wait for the command execution to complete.

If a value outside the range of -1 to 2147483647 is specified, the default value is used.

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

60

06-50

com.cosminexus.mngsvr.vmx.enabled

Specifies whether to operate the Management Server as a virtual server manager in the 08-50 mode.

If you specify true:

The Management Server operates as the virtual server manager in the 08-50 mode. Note that the logical server using Management Server must not be built or operated. If a function other than virtual server manager in the 08-50 mode is used when true is specified, the operation is not guaranteed.

If you specify false:

The Management Server does not operate as the virtual server manager in the 08-50 mode.

Specify one of the following values:

• true

• false

false

08-50

com.cosminexus.mngsvr.vmi.enabled

Specify whether Management Server must function as a virtual server manager.

If you specify true:

Management Server functions as the virtual server manager. Note that the logical server using Management Server must not be built or operated. If a function other than virtual server manager is used when true is specified, the operation is not guaranteed.

If you specify false:

The Management Server operates as the Management Server.

Specify one of the following values:

• true

• false

false

08-53

com.cosminexus.mngsvr.upload_app.enabled

Specifies whether to enable the functionality for uploading the application files from the management portal to the host on which the Management Server is running.

If you specify true:

Enables the functionality for uploading the application files from the management portal to the host on which the Management Server is running.

If you specify false:

Disables the functionality for uploading the application files from the management portal to the host on which the Management Server is running.

Specify one of the following values:

• true

• false

true

08-70

com.cosminexus.mngsvr.upload_app.directory

Specifies the directory for uploading the application files from the management portal to the host on which the Management Server is running.

You specify the directory name as an absolute path.

Cosminexus-installation-directory/manager/apps

08-70

com.cosminexus.mngsvr.upload_app.maxsize

Specifies the maximum size (unit: bytes) of application files that can be uploaded from the management portal to the host on which the Management Server is running.

Specify a size of 1024 bytes (1 KB) or more.

If you specify 0, the size of files that can be uploaded is not restricted.

0 to 9223372036854775807

314572800 (300MB)

08-70

com.cosminexus.mngsvr.snapshot.auto_collect.timeout

Specifies the timeout value (unit: seconds) until the primarily sent data and secondarily sent data of the snapshot log is completely collected when an error is detected in the logical server.

If 0 is specified

Timeout will not occur.

If a value between 1 and 2147483 is specified

If the collection of the snapshot log is not completed even after the elapse of specified number of seconds, the Management Server cancels snapshot log collection.

0 to 2147483

• Default: 0

• Initial value: 3600

08-70

ejbserver.naming.port

Specifies the port number used for internal communication of the Management Server, when the Management Server is used from HCSC-Manager.

The port number is enabled only when the Management Server is used from HCSC-Manager.

1 to 65535

28900

09-00

ejbserver.server.edition.settingforce

Specifies whether to use the Management Server from HCSC-Manager.

When the Management Server is not used from HCSC-Manager, either specify Smart in this key or omit the specification of this key.

When this key is omitted, it is assumed that Smart is specified.

• When Smart is specified:

  The Management Server is not used from HCSC-Manager. Note that if you specify Smart, the ejbserver.naming.port key settings are ignored.

• No value is specified: The Management Server is used from HCSC-Manager.

Note

When nothing is specified, it is assumed that only key is specified and value is not specified.

Specification example:

ejbserver.server.edition.settingforce=

Smart

Smart

09-00

ejbserver.rmi.logger.filenum

Specify an integer from 2 to 16 for the number of RMI communication log files of the Management Server.

If you specify a non-numeric value, or a numeric value outside the range, or if you do not specify a string, a message is output and the default value will be set.

Specify an integer from 2 to 16.

4

09-00

ejbserver.rmi.logger.filesize

Specify an integer from 8192 to 2147483647 (units: bytes) for the size of the RMI communication log files of the Management Server.

Specify an integer from 8192 to 2147483647.

1048576

09-00

java.rmi.server.hostname

Specify the host name or an IP address when the host for an external connection to Management Server remote management functionality is to be specified.

For details about the settings for this property, see com.cosminexus.mngsvr.management.host.

Also, in an environment in which the global IP address and local IP address are converted, such as the NAT (IP masquerade), specify the host name (not the IP address) regardless of whether com.cosminexus.mngsvr.management.host is specified. In this case, if the IP address is specified in com.cosminexus.mngsvr.management.host, you must specify the host name indicating that IP address.

Host name or IPv4 dotted notation

None

07-60

mngsvr.jp1event.event_server_name

Specify a value same as the address set for the ports key in the event server settings file (conf) of the JP1/Base event service that is being used. If multiple addresses are specified for the ports key, choose any one of the specified addresses.

When using an event service that has the value '0.0.0.0' (default value) specified for the ports key address, either omit this key or specify the host name of the local machine or localhost.

Host name or IPv4 dotted notation

localhost

06-70

mngsvr.myhost.name

Specify the IP address accessible from the host to which the logical server is allocated, or specify the host name indicating that IP address in the name of the host to which the logical server is allocated.

Specify this key when the host that operates Management Server has multiple IP addresses and the host name might not be converted to the intended IP address.

When omitted or when null characters are specified, the loopback address gets converted into the local host name that can be acquired, and the local host name is used. If the local host name cannot be acquired, the loopback address is used.

You can specify the IP address as a regular expression using meta characters. When the IP address is specified as a regular expression, the available local IP address that matches the expression is used.^#1

Precautions

When you specify a value to webserver.connector.http.bind_host, specify the similar value to this property.

Host name or IPv4 dotted notation

None

06-50

webserver.connector.ajp13.port

Specify the port number used for Management Server internal communication.

The value set during installation is 28009.

If the port number is not specified, an attempt to start the Management Server fails.

Specify the value using an integer from 1 to 65535.

None

05-00

webserver.connector.http.bind_host

You can select an optional IP address when using the Management Server on a host having multiple physical network interfaces or a host that allocates multiple logical IP addresses to one physical network interface. However, you cannot specify the loopback address.

If a value is not specified, connections are received for all the local addresses.

You can specify the IP address as a regular expression using meta characters. When the IP address is specified as a regular expression, the available local IP address that matches the expression is used.^#1

Specify one of the following values:

• IPv4 address

• Host name (String within 255 characters specified using single byte alphanumeric characters or symbols (_.-))

None

07-10

webserver.connector.http.permitted.hosts^#2

Specify the IP address or host name of the hosts that will be allowed access to the Management Server and the host that executes the Administration Agent. This property applies to the access from a management portal (Web browser), Management Server remote management function, or management command (mngsvrutil). Moreover, you must also specify the IP address or host name of the hosts that are to be managed by the Management Server. If you operate a logical server of a host that is not specified in this property, problems like a timeout or incomplete operations may occur.

Note that when the key is omitted, there are no access restrictions. When omitting the values or when entered values are invalid, only local host can be accessed.

When specifying multiple hosts, demarcate the IP addresses or the host names with a comma (,). If there are no access restrictions, specify only an asterisk (*). The single-byte space before and after the IP address or the host name is ignored.

Specify one of the following values:

• IPv4 address or host name

  If you want to specify multiple addresses or names, separate with a comma (,).

  Specify a string within 255 characters specified using alphanumeric characters or symbols (_.-) for the host name.

• * (asterisk)

• Default: *

• Initial value: localhost

06-00

webserver.connector.http.port

Specify the HTTP port number for connecting to the Management Server.

The value set during installation is 28080.

If the port number is not specified, an attempt to start the Management Server fails.

Specify the value using an integer from 1 to 65535.

None

05-00

webserver.shutdown.port

Specify the port number for receiving the Management Server termination request.

The value set during installation is 28005.

If the port number is not specified, an attempt to start the Management Server fails.

Specify the value using an integer from 1 to 65535.

None

05-00

com.cosminexus.mngsvr.compat.operation_app

Specify how the applications will be managed. Note that this item is for compatibility.

If you specify true:

Operation cannot be guaranteed.

If you specify false:

V8 mode

Note:

Do not edit this key manually.

Specify false.

• Default: true

• Initial value: false

08-00