8.2.11 Property file for issuing Management events
- Organization of this subsection
(1) Format
This file is a Management Server property file and has the J2SE property file format.
(2) File storage location
-
In Windows
Cosminexus-installation-directory\manager\config\mevent.Logical-server-name.properties
-
In UNIX
/opt/Cosminexus/manager/config/mevent.Logical-server-name.properties
(3) Functionality
This file defines the logical server that sends the Management event, the Management Server to which the event is sent, and the file that contains the list of message IDs to be reported.
(4) Specifiable keys
The following table describes the keys that you can specify, their contents, and the default values used when the specification is omitted:
|
Key name |
Contents |
Default value |
|---|---|---|
|
Specify the host to which the event is to be sent. Specify the host name or IP address of the Management Server to which the Management event is to be sent. You can use alphanumeric characters and symbols. When this property is not specified, the Management event is not issued. |
None |
|
|
Specify the port to which the event is to be sent. Specify an integer from 1 to 65535 for the HTTP port number of the Management Server to which the Management event is to be sent. When this property is not specified or when the specification is invalid, the Management event is not issued. |
None |
|
|
Specify the name of the logical server that issues the Management event. You can use alphanumeric characters and symbols. When this property is not specified, the Management event is not issued. If you specify a logical server name that does not exist, the Management event is ignored. |
None |
|
|
Specify the send timeout. Specify an integer from 10 to 600 (units: seconds) for the time period of awaiting a response from the Management Server, when a Management event is issued. When there is no response within the specified time period, it is considered as Management event issue failure. |
90 |
|
|
Specify the resend time limit. Specify an integer from 0 to 86400 (units: seconds) for the time limit for resending the Management event in the case of failure in issuing a Management event. The issuing of the Management event is repeated at resend intervals specified in the manager.mevent.retry.interval key, until the issue of the event is successful, or until the time specified in this key lapses. If you specify 0, the Management event is not resent. |
0 |
|
|
Specify an integer from 1 to 86400 (units: seconds) for the interval after which the Management event will be resent. |
10 |
|
|
Specify the message ID list file (as an absolute path) to be used for issuing the Management events. When the specified file is invalid, Management events are not issued. When omitted, the message ID registered in the default message ID list file is sent as Management event. For more details on the message ID list file for issuing the Management events, see 8.2.12 Message ID list file for issuing Management events. |
None |
|
|
Specify an integer from 1 to 1000 for the maximum number of Management events that can be concurrently issued. |
10 |
|
|
Specify the local address (host name or IP address) to be used when sending the Management event. You can use alphanumeric characters and symbols. When omitted, a local IP address is randomly allocated. |
None |
To create this file, see the following sample of the property file for issuing Management events.
-
In Windows
Cosminexus-installation-directory\manager\config\templates\mevent.properties
-
In UNIX
/opt/Cosminexus/manager/config/templates/mevent.properties
(5) Precautions
-
You need to specify a settings file for issuing Management events for each J2EE server instance. Do not specify the same file for multiple J2EE server instances running concurrently.
-
Management events are issued in the order of their occurrence. However, Management events whose issue has failed are re-issued only after the planned Management events have been issued.