10.2 adminagent.properties (Administration Agent property file)

Organization of this section
(1) Format
(2) File storage location
(3) Functionality
(4) Specifiable keys

(1) Format

J2SE property file format.

The adminagent.properties is a property file of the Administration Agent.

(2) File storage location

(3) Functionality

Specify the settings related to the Administration agent.

(4) Specifiable keys

The specifiable keys and default values are described below. Note that "Default" refers to the value or operation assumed when the key is not specified. "VR" refers to the Application Server version introduced or changed by the key.

Key nameContentsSpecifiable valueDefault valueVR
{adminagent.adapter.allowedHostsSpecify a host name or an IP address that can access to the server.
To specify multiple IP addresses, demarcate using commas (,) and you do not insert any spaces. You can specify the IP address as a regular expression using meta characters. When an IP address is specified as a regular expression, the Administration Agent uses an available local IP address that matches the expression. If multiple IP addresses exist, all the IP addresses that match the expression will be granted the access permission.
Note that when you specify an IP address as a regular expression, you cannot specify multiple values using commas (,).
The values that can be specified are as follows:
  • Host name
  • IPv4 address
None05-05
adminagent.adapter.bind_hostSpecify the host name or the IP address that will be used for communicating with the Administration Agent. You can choose any of the IP addresses for communication, when using Administration Agent on a host that has multiple physical network interfaces or a host that has multiple logical IP addresses assigned for a single physical network interface.
If an invalid value is specified, the Administration Agent will terminate abnormally.
You can specify the IP address as a regular expression using meta characters. When the IP address is specified as a regular expression, the Administration Agent uses an available local IP address that matches the expression.#1
The values that can be specified are as follows:
  • Host name
  • IPv4 address
None06-00
adminagent.adapter.portSpecify port numbers used by the server functionality.Specify the value using an integer from 1 to 65535.2029505-05
adminagent.cluster.localaddress.checkSpecify whether to stop the standby node during node switching in the Application Server.
During node switching in the Application Server, if the logical server and Administration Agent in the standby node are not stopped, this key will stop the logical server and Administration Agent.
If you specify true:
The running logical server and Administration Agent in the standby node are stopped during the node switching in the Application Server.
The local address is checked and if the cluster IP address is not specified, the logical server will be stopped and then the Administration Agent will be stopped.
If you specify false:
The running logical server and Administration Agent in the standby node are not stopped during the node switching in the Application Server.
Specify one of the following values:
  • true
  • false
false07-10
adminagent.finalization.stop_serversSpecify whether to stop the logical server when the Administration Agent terminates.
If you specify true:
All the logical servers will be stopped in the Administration Agent termination processing.
If you specify false:
The logical servers will not be stopped in the Administration Agent termination processing.
Specify one of the following values:
  • true
  • false
false06-50
adminagent.forcestop.threaddumpSpecify whether to output the thread dump when the J2EE server and the SFO server are terminated forcefully. J2EE servers and SFO servers are the only logical servers to which the above setting are applicable.
If you specify true:
Thread dump will be output. In such cases, the forced termination processing is same as the case when the cjstopsv command is executed with the -fd option.#2
If you specify false:
Thread dump will not be output.
Specify one of the following values:
  • true
  • false
false06-50
adminagent.forcestop.threaddump.intervalSpecify an integer from 1 to 2147483647​ (unit: seconds) for the interval to confirm the completion of thread dump output, when settings are specified to output thread dump during the forced termination of the J2EE server and the SFO server.
When the value outside the range of 1 to 2147483647​ is specified, the default value will be set.
Specify the value using an integer from 1 to 2147483647​.106-50
adminagent.forcestop.threaddump.timeoutSpecify an integer from -1 to 2147483647​ (Unit: seconds) for the thread dump output waiting time, when Do not monitor is set for Forced stop monitoring time for the J2EE server and the SFO server settings.
When you specify -1, the completion of thread dump output is awaited.
When you specify the value outside the range of -1 to 2147483647​, the default value will be set.
If the thread dump process does not complete even after the specified time has elapsed, the J2EE server and the SFO server are terminated forcefully.#2
Specify the value using an integer from -1 to 2147483647​.4506-50
adminagent.hws.groupWhen using Cosminexus HTTP Server, specify the group name of the user starting Cosminexus HTTP Server.
When omitted, start with the group name of the Administration Agent.
This key is for UNIX.#3
Group nameNone08-00
adminagent.hws.ownerWhen using Cosminexus HTTP Server, specify the name of the user starting Cosminexus HTTP Server.
When omitted, start with the user name of the administration agent.
Note that this key is used for UNIX. #3
User nameNone08-00
adminagent.hws.sys_cmd.abnormal_end.traceinfoSpecify whether to collect the Web server internal trace, when executing the command for error detection.
If you specify true:
The internal trace will be collected.
If you specify false:
The internal trace will not be collected.
Specify one of the following values:
  • true
  • false
true07-00
adminagent.hws.watch.methodSpecify the HTTP method for checking the operation of Cosminexus HTTP Server when 2 is specified in adminagent.hws.watch.level. For the specifiable method, you can specify either "HEAD" or "OPTIONS". #4
If you specify "HEAD":
Accesses the URL specified in the key adminagent.hws.watch.url and checks whether returns any response.
If you specify "OPTIONS":
Checks whether the Web server can receive HTTP methods.
If "/*" is specified in the URL pattern to be mapped to the redirector, all the URLs will be redirected to the Web container of the J2EE server. Therefore, when specifying "/*" in the URL pattern to be mapped to the redirector, Hitachi recommends that you specify "OPTIONS" and do not access the URL.
Specify one of the following values:
  • HEAD
  • OPTIONS
HEAD#506-50
adminagent.hws.watch.urlSpecify the URL for confirming the operations of Cosminexus HTTP Server, when "HEAD" is specified in adminagent.hws.watch.method. The Administrator Agent will determine the status of Hitachi Web Server from the response of this URL, so specify a URL that is actually accessible. Note that you specify the URL as an absolute path starting with "http" or as a relative path from the root context. When building multiple Web servers on the same host, specify the URL as a relative path.
(Example of specification)
When you specify http://HostA:80/index.html:
adminagent.hws.watch.url=http://HostA:80/index.html
When you specify http://localhost:port-nmber/index.html (in a multiple server configuration):
adminagent.hws.watch.url=index.html
URLRoot context (http://localhost:port-number/)06-00
adminagent.j2ee.process.console_event.enabledSpecify whether to display the console output information of the J2EE server to the Eclipse Plug-in using Management Server.
If you specify true:
The console output information will be output to the Eclipse Plug-in using Management Server.
If you specify false:
The console output information will not be output to the Eclipse Plug-in using Management Server.
The key adminagent.process.consolelog.enabled must be set to true.
Since this consumes resources, Hitachi recommends that the key be set to false in operations that do not use Eclipse Plug-ins using Management Server.
Specify one of the following values:
  • true
  • false
false07-10
adminagent.j2ee.process.console_log.enabledSpecify whether to output the console output information for the J2EE server in the console log.
If you specify true:
The console output information will be output to the console log.
If you specify false:
The console output information will not be output to the console log.
The key adminagent.process.consolelog.enabled must be set to true.
Specify one of the following values:
  • true
  • false
false07-10
adminagent.j2ee.sys_cmd.abnormal_end.javatraceSpecify whether to acquire J2EE server stack trace when executing the command for error detection.
If you specify true:
The stack trace will be acquired.
If you specify false:
The stack trace will not be acquired.
Specify one of the following values:
  • true
  • false
true07-00
adminagent.j2ee.sys_cmd.abnormal_end.threaddumpSpecify whether to collect the J2EE server thread dump when executing the command for error detection.
If you specify true:
The J2EE server thread dump will be collected.
If you specify false:
The J2EE server thread dump will not be collected.
Specify one of the following values:
  • true
  • false
true06-50
adminagent.jp1event.event_server_nameSpecify 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 notationlocalhost06-70
adminagent.jp1event_enabledSpecify whether JP1 events will be issued from the Administration Agent.
If you specify true:
JP1 events will be issued.
If you specify false:
JP1 events will not be issued.
Specify one of the following values:
  • true
  • false
false06-70
adminagent.log.filenumSpecify an integer from 1 to 16 for the number of log files.Specify the value using an integer from 1 to 16.405-05
adminagent.log.filesizeSpecify a numeric value from 65536 to 2147483647​ for the maximum size of each log file (units: bytes).Specify the value using an integer from 65536 to 2147483647​.6553605-05
adminagent.log.levelSpecify an integer from -1 to 1000 for the level of log output.
  • -1: No log will be output.
  • 0: Normal operation: Normal operation.
  • 10: Normal operation (verbose): same as normal operation, waiting for recurrence.
  • 20: Recurrence test: Acquires debug level information used in the system environment setup or test phases.
  • 30: Error investigation: Suitable for acquiring detailed error information for errors that are difficult to investigate.
Specify the value using an integer from -1 to 1000.005-05
adminagent.lsinfo_dirSpecify the directory where the logical server information file will be output. If the specified directory does not exist, create it.
When you restart the Administration Agent, the Administration Agent will use this information to once again manage the logical servers being managed before the Administration Agent stops and make them operable. This directory is created when starting the logical server and is deleted after the logical server has stopped.
Directory name (absolute path)Manager-installation-directory/spool/lsinfo06-50
adminagent.maintenance.log.filenumSpecify an integer from 1 to 16 for the number of maintenance log files.Specify the value using an integer from 1 to 16.406-70
adminagent.maintenance.log.filesizeSpecify an integer from 65536 to 2147483647​ for the maximum size of each maintenance log file (units: bytes).Specify the value using an integer from 65536 to 2147483647​.16777216​06-70
adminagent.prftrace_dirSpecify a character string for the path name of the directory to which the trace based performance analysis file is temporarily output. If no directory is specified, the specified directory is created.
Note:
The trace based performance analysis file is temporarily output in the following cases:
  • When the system error detection command is executed due to the abnormal termination of the logical server
  • When the snapshot log is collected by specifying the sub-command collect of the Management Server management command (mngsvrutil)
  • When the snapshot log is collected with the management portal
Therefore, allocate free space at the output destination based on the following formula: File size output at the specification destination (maximum value) = PRF-trace-size (value specified for PrfTraceFileSize) [Figure]number-of-PRF-trace-files (value specified for PrfTraceCount)
Note that if multiple PRFs exist on the same host, the sum of size of all the PRF trace files is used.
Directory name (Absolute path)Application-Server-installation-directory/manager/tmp/09-50
adminagent.process.consolelog.enabledSpecify whether to acquire the console output information for the processes invoked by the Administration Agent. However, when using the Eclipse Plug-in that uses Management Server, you must specify true as the value for this key.
If you specify true:
The console output information will be acquired.
If you specify false:
The console output information will not be acquired.
Specify one of the following values:
  • true
  • false
true07-00
adminagent.process.consolelog.event.queue_sizeSpecify the event queue size for the event notification to the Management Server from the console output information for the processes invoked by the Administration Agent.
If the queue becomes full, the events are destroyed from the oldest event in the queue.
Hitachi recommends that you specify a default value for this property; and therefore, do not change the settings.
Specify the value using an integer from 1024 to 2147483647​.102407-00
adminagent.process.consolelog.filenumSpecify an integer from 1 to 16 as the number of log files output for the console output information of the processes invoked by the Administration Agent.
If the shift mode is specified in the sinaviagent.log.style key, this number becomes the number of backup files.
Specify the value using an integer from 1 to 16.407-00
adminagent.process.consolelog.filesizeSpecify an integer from 65536 to 2147483647​ as the maximum size (unit: bytes) of each log file output for the console output information of the processes invoked by the Administration Agent.Specify the value using an integer from 65536 to 2147483647​.6553607-00
adminagent.process.consolelog.timeSpecifies the time for rotating the log files used to output the console output information of the processes started by the Administration Agent in HHMMSS format as a value from 000000 to 235959. However, if the log file size reaches the upper limit before the time set in this property is reached, the log file will be rotated at that point.
If no time is specified, the files will be rotated based only on the log size.
Specify a value from 000000 to 235959 in the HHMMSS format.None09-00
cSpecifies the method of rotating the log files that output the console output information of the processes started by the Administration Agent.
If you specify SHIFT:
The log file will be rotated in the shift mode.
If you specify WRAP:
The log file will be rotated in the wraparound mode.
Specify one of the following values:
  • SHIFT
  • WRAP
WRAP09-00
adminagent.rmi.log.filenumSpecify a numeric value for the number of maintenance log files in the RMI processing performed by the Administration Agent.Specify the value using an integer from 1 to 16.807-60
adminagent.rmi.log.filesizeSpecify a numeric value for the maximum size of each maintenance log file in the RMI processing performed by the Administration Agent.Specify the value using an integer from 65536 to 2147483647​.16777216​07-60
adminagent.rmi.log.levelSpecify a character string for the output level of the maintenance log in the RMI processing performed by the Administration Agent.
<OFF>
The output level will not be output.
<SEVERE>, <WARNING>, <INFO>, <CONFIG>, <FINE>, <FINER>, <FINEST>
SEVERE only outputs severe problems. The order described here results in more detailed log output.
Specify one of the following values:
  • OFF
  • SEVERE
  • WARNING
  • INFO
  • CONFIG
  • FINE
  • FINER
  • FINEST
FINER07-60
adminagent.snapshotlog.listfile.2.num_snapshotsSpecify a numeric value from -2147483648​ to 2147483647​ as the number of snapshot log files that will be acquired as the secondary data for each logical server. If exceeds the specified file count, the log files with the oldest creation time are deleted sequentially. Also, if you specify a value not more than 0, the log files are not deleted.Specify the value using an integer from -2147483648​ to 2147483647​.1006-50
adminagent.snapshotlog.log_dirSpecify a character string for the directory to output the snapshot log. If the specified directory does not exist, the directory will be created.Directory name (absolute path)com.cosminexus.manager.log.dir-of-manager.cfg/snapshot/06-00
adminagent.snapshotlog.num_snapshotsSpecify a numeric value from -2147483648​ to 2147483647​ as the number of snapshot log files that will be acquired as the primary data for each logical server. If exceeds the specified file count, the log files with the oldest creation time are deleted sequentially. Also, if you specify a value not more than 0, the log files are not deleted.Specify the value using an integer from -2147483648​ to 2147483647​.1006-00
adminagent.sys_cmd.abnormal_end.prftraceSpecify whether to collect the performance analysis trace files when executing the command for error detection.
If you specify true:
The performance analysis trace files will be collected.
If you specify false:
The performance analysis trace files will not be collected.
Specify one of the following values:
  • true
  • false
true06-50
adminagent.userserver.process.console_event.enabledSpecify whether to display the console output information of the user server with the Eclipse Plug-in using Management Server.
If you specify true:
The console output information will be output to the Eclipse Plug-in using Management Server.
If you specify false:
The console output information will not be output to the Eclipse Plug-in using Management Server.
The key adminagent.process.consolelog.enabled must be set to true.
Since this consumes resources, Hitachi recommends that the key be set to false in operations that do not use Eclipse Plug-ins using Management Server.
Specify one of the following values:
  • true
  • false
false07-10
adminagent.userserver.process.console_log.enabledSpecify whether the console output information for the user-defined server will be output to the console log.
If you specify true:
The console output information will be output to the console log.
If you specify false:
The console output information will not be output to the console log.
The key adminagent.process.consolelog.enabled must be set to true.
Specify one of the following values:
  • true
  • false
false07-10
adminagent.watch.retry_timeout.enabledSpecify whether retry is performed for the occurrence of a timeout during the confirmation of the logical server operations.
If you specify true:
Retry performed for occurrence of the timeout.
If you specify false:
Retry is not performed for occurrence of the timeout.
Specify one of the following values:
  • true
  • false
  • Default: false
  • Initial value: true
06-70
adminagent.server-type#6.usr_cmd.abnormal_endSpecify the command for error detection using the absolute path. Use "/" as a file separator. You can change the command according to the type of the logical server where the error has occurred. If you specify the value that cannot be specified in server-type#6, the value will be ignored.
In Windows:
When you create a command for error detection using a batch file, you must add "%{ComSpec} /C" before the command name. "%{ComSpec}" is replaced with the absolute path of cmd.exe. If "%{ComSpec} /C" is not specified, the command might not execute normally. Also, when you include one-byte spaces in the command path, make sure that you enclose the absolute path of the command in double quotations ("").
Example: If executing d:/my bat/j2eeabnormalend.bat, when an error occurs in the J2EE server
adminagent.j2ee.usr_cmd.abnormal_end=%{ComSpec} /c "d:/my bat/j2eeabnormalend.bat"
In UNIX:
When you create a command for error detection using a shell script, you must add "/bin/sh" before the command name. If "/bin/sh" is not specified, the command might not execute normally.
Example: If executing /home/user1/j2eeabnormalend.sh, when an error occurs in the J2EE server
adminagent.j2ee.usr_cmd.abnormal_end=/bin/sh/home/user1/j2eeabnormalend.sh
Command name (absolute path)None06-50
adminagent.server-type#6.watch.intervalSpecify an integer from 1 to 86400 as the interval (unit: seconds) for confirming the operations of the logical server.
If you specify an invalid value, the default value will be set.
Note that when the server type is user server, the watch-interval value specified in the Logical user server definition file or Easy Setup definition file becomes valid.
Specify the value using an integer from 1 to 86400.1006-00
adminagent.server-type#6.watch.levelSpecify the logical server operation confirmation level. You can specify 1 or 2 as the value.
If you specify 1:
The logical server operations will be confirmed by checking whether the process exists.
If you specify 2:
The logical server operations will be confirmed by checking whether the process exists and the access to the logical server. The logical servers on which operations can be checked are naming services, SFO servers, J2EE servers, and Web servers. Even if you specify 2 for other logical servers, the operations will be performed only to check that the process exists.
Specify 1 or 2.
  • For Naming service, SFO server, J2EE server, and Web server: 2
  • For logical servers other than above: 1
06-00
adminagent.server-type#6.watch.retry_countSpecify an integer from 0 to 86400 as the retry count when the operation confirmation processing fails during the confirmation of logical server operations. By specifying the retry count, you can permit temporary operation confirmation failure.
Specify the retry interval using adminagent.server-type.watch.interval. If you specify 0, an error is assumed without retrying when the operation confirmation processing fails.
When the operation confirmation processing fails and when tried retrying, KEOS21033-W or KEOS21034-W is output to the Administration Agent log.
When the operation confirmation processing fails and when retry is not executed or if the retry count exceeds the specified count, KEOS20511-E or KEOS21035-E will be output to the Administration Agent log and the error will be notified to the Management Server.
Specify the value using an integer from 0 to 86400.106-70
adminagent.server-type#6.watch.start_timeWhen starting the logical server, specify an integer from 0 to 86400 for the time (unit: seconds) starting from the execution of the start command up to starting the operation confirmation.
By acquiring the time required for actual startup from the logical server log for logical server startup (KDJE30028-I of cjmessage?.log for the J2EE server) and by specifying the value for this property which is few seconds shorter than this time, you can reduce the unnecessary log that is output before the logical server starts and report the complete startup of the logical server to the Management Server promptly.
Specify the value greater than the value specified in this property as the start monitoring time set up in the logical server start and stop functionality. If you specify the value lesser than the specified value, the logical server will fail to start.
Specify the value using an integer from 0 to 86400.Depending on the server-type#6, the default value differs as follows:
  • prf: 0
  • smartagent: 3
  • naming: 10
  • ctmdm: 0
  • ctm: 0
  • ots: 0
  • tcs: 3
  • sfo: 45
  • j2ee: 45
  • hws: 0
06-70
adminagent.server-type#6.watch.timeoutSpecify an integer from 1 to 9223372036854775​ (unit: seconds) for the time until timeout occurs during the confirmation of the logical server operations.Specify the value using an integer from 1 to 9223372036854775​.6006-50
#1
If the IP address subnet used in the communication with the Administration Agent in the management domain is fixed, and if the IP address to be specified is coded as 192\\.168\\.0\\..+, the IP address matches with the IP address starting with 192.168.0. (for example, 192.168.0.32 or 192.168.0.128), so the setup file can be distributed to all the hosts and can be used without modifications. For details on the regular expressions, check the specifications for the java.util.regex.Pattern class in Java.
However, as "\\" is replaced with the single character "\", when specifying "\", specify two characters in succession. If multiple IP addresses matching with the specified regular expression are detected, the IP address with the smallest value is used. For example, if 192.168.0.32 and 192.168.0.128 are detected, 192.168.0.32 will be used. In this case, the used IP address is not always the intended IP address, therefore, make sure to code a regular expression such as 192\\.168\\.0\\.1.. to match with only one IP address.
#2
To output the thread dump during a forced termination, specify adequate time to output the thread dump in the "forced termination monitoring time" or the adminagent.forcestop.threaddump.timeout key. If the specified time is lesser than the time required to complete the thread dump output, the thread dump output contents might be incomplete. Also, when using Dr. Watson, you do not specify 'Notify using a message box'. For details about Dr. Watson, see Microsoft home page.
#3
To set this property, execute the following operations:
  1. Perform settings for executing operations by a general user account. For details about the settings for executing operations by a general user account, see Cosminexus HTTP Server.
    Note that a resource owner or group of Cosminexus HTTP Server must be changed after executing the cmx_build_system command or after executing setup from the management portal.
  2. Change the owner or group of the redirector log output destination (default is /opt/Cosminexus/CC/web/redirector/servers/<server name>/logs) to the user or group starting the specified Cosminexus HTTP Server.
#4
If /* is specified in the URL pattern to be mapped to the redirector, all the URLs will be redirected to the Web container of the J2EE server. Therefore, when specifying /* in the URL pattern to be mapped to the redirector, Hitachi recommends that you specify OPTIONS and do not access the URL.
#5
In the setup file of 06-50 or later versions, the line adminagent.hws.watch.method=OPTIONS is defined as the initial value. Therefore, the initial value of the HTTP method for confirming operations, used when upgrading from a version older than 06-50, is the default value HEAD. However, the initial value of the HTTP method for confirming operations, used for a new installation or when upgrading from 06-50 or a later version, is OPTIONS.
#6
Server-type references to the type of the logical server and includes any one of the following:
  • smartagent: Smart agent
  • j2ee: J2EE server
  • naming: Naming service
  • hws: Web server (Cosminexus HTTP Server)
  • ctm: CTM
  • ctmdm: CTM domain manager
  • prf: Performance tracer
  • sfo: SFO server
  • userserver: User server