8.2.5 mngagent.actual-server-name.properties (Management Agent property file)
- Organization of this subsection
(1) Format
The Management Agent property file has the J2SE property file format.
(2) File storage location
-
In Windows
Cosminexus-installation-directory\manager\config\
-
In UNIX
/opt/Cosminexus/manager/config/
(3) Keys that you can use for setting the names of Management domain and Management Agent
The specifiable keys and default values are described below. The domain names and agent names set in these keys are used as the default value for log file name.
Key name |
Contents |
Default value |
---|---|---|
Specify a character string for the management domain name. You can use ASCII alphanumeric characters (A to Z, a to z, 0 to 9), under scores (_), and hyphens (-). |
None |
|
Specifies a character string as the logical server name of the applicable node. You can use ASCII alphanumeric characters (A to Z, a to z, 0 to 9), under scores (_), and hyphens (-). |
None |
(4) Keys that you can use in log or trace settings
The specifiable keys and default values are described below.
Key name |
Contents |
Default value |
---|---|---|
Specify the log file name. Logging will not happen if you specify a null character string or a whitespace for this property. The actual log file name will be the specified file name (where n is a number from 1 to 4) with '.n.log' added. |
|
|
Specify a number from 4096 to 2147483647 for the upper size limit (in bytes) for each log file. If you specify a value outside the range, the value 65536 is used. |
65536 |
(5) Keys that you can use when you perform operation setup by specifying communication ports and IP addresses
The specifiable keys and default values are described below.
Key name |
Contents |
Default value |
---|---|---|
Set an integer from 1 to 65535 for the Management Agent communication port. Make sure that the port number is not the same as that of any other program. |
A value is allocated automatically from the available port numbers. |
|
Specify any value to set the IP address for the Management Agent. |
None |
(6) Precautions
-
The mngagent.actual-server-name.properties file is created in the following cases:
-
When the Smart Composer functionality is used for building a Web system
-
When preference information of the J2EE server is distributed by the management portal
When managing a J2EE server built without using these functions, create a setup file mngagent.actual-server-name.properties and specify the settings related to the Management Agent.
-
-
Specify a different file name for each server instance.
-
When multiple Management Agents having the values same as of mngagent.domain_name or mngagent.agent_name are invoked concurrently, the output is performed in the same log file by default, and hence, the log file contents might be destroyed. For invoking multiple J2EE servers on the same machine, specify a unique value for mngagent.agent_name.