The Management Agent property file has the J2SE property file format.
This file specifies the port number that will be used by the Management Server and the settings for error detection command operations. To change the port number of the Management Server without restarting it, you do so by editing this file.
The following table describes the keys that you can specify, their contents, and the default values that are used when they are omitted:
Key name | Contents | Specifiable value | Default | VR |
---|---|---|---|---|
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.
| Specify one of the following values:
| false | 07-00 |
com.cosminexus.mngsvr.jp1event.emergency | Specify whether to issue Emergency level events.
| Specify one of the following values:
| false | 07-00 |
com.cosminexus.mngsvr.jp1event.critical | Specify whether to issue Critical level events.
| Specify one of the following values:
| false | 07-00 |
com.cosminexus.mngsvr.jp1event.enabled | Specify whether to enable the functionality for issuing system JP1 events.
| Specify one of the following values:
| false | 07-00 |
com.cosminexus.mngsvr.jp1event.error | Specify whether to issue Error level events.
| Specify one of the following values:
| false | 07-00 |
com.cosminexus.mngsvr.jp1event.information | Specify whether to issue Information level events.
| Specify one of the following values:
| false | 07-00 |
com.cosminexus.mngsvr.jp1event.notice | Specify whether to issue a Notice level event.
| Specify one of the following values:
| false | 07-00 |
com.cosminexus.mngsvr.jp1event.warning | Specify whether to issue Warning level events.
| Specify one of the following values:
| 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: 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.
| 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: 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: 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:
| 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).
| Specify one of the following values:
| 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.
| Specify one of the following values:
| false | 07-60 |
com.cosminexus.mngsvr.management.enabled | Specify whether to enable the Management Server remote management functionality.
| Specify one of the following values:
| 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.
| Specify one of the following values:
| true | 08-50 |
com.cosminexus.mngsvr.on_start | Specify whether to perform batch startup of the logical servers, when the Management Server starts.
| Specify one of the following values:
| false | 07-00 |
com.cosminexus.mngsvr.snapshot.auto_collect.enabled | Specify whether to collect snapshot log when an error occurs or when batch restart is performed.
| Specify one of the following values:
| true | 06-50 |
com.cosminexus.mngsvr.snapshot.collect.point | Specify the timing for snapshot log collection.
| Specify one of the following values: Note that the value is not case sensitive.
| 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.
| Specify one of the following values:
| 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:
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 | Specify any one of the following numbers as the maximum number of performance analysis trace files maintained in the Management Server: 1, 2, 4, 8, 16 | Specify 1, 2, 4, 8, or 16. | 2 | 07-00 |
com.cosminexus.mngsvr.usr_cmd.abnormal_end.enabled | Specify whether to use the functionality for executing user-created error detection command.
| Specify one of the following values:
| 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.
| Specify one of the following values:
| false | 08-50 |
com.cosminexus.mngsvr.vmi.enabled | Specify whether Management Server must function as a virtual server manager.
| Specify one of the following values:
| 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.
| Specify one of the following values:
| 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.
| 0 to 2147483 | 0 | 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.
| Smart | Smart | 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 blank 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
| 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:
| None | 07-10 |
webserver.connector.http.permitted.hosts | 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:
|
| 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.
| The following strings can be specified:
|
| 08-00 |
After starting Management Server, you can also change the port number from Network settings of Cosminexus Management Server settings in the management portal. However, when changing the port number, the comment written in the mserver.properties file is deleted.