10.4 adminagentuser.cfg (Option definition file for Administration Agent )

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

(1) Format

Specify the key as follows:

key-name=value

Specification method
  • The string up to the linefeed is a value.
  • The line beginning with a hash mark (#) is a comment.
  • You can specify up to 65535 bytes in one line.
  • If you define a line without a value, the line is ignored.
  • Specify the key with ASCII characters.

(2) File storage location

(3) Functionality

Specify the invocation options for the JavaVM that executes the Administration Agent.

The contents of this file become effective when this file exists and when this file can be read from the Administration Agent. If this file exists, but cannot be read from the Administration Agent, the startup of the Administration Agent fails.

If this file does not exist, the Administration Agent is started without specifying the options.

(4) Specifiable keys

The specifiable keys and default values are described below. If you specify invalid values in these keys, the startup of the Administration Agent fails.

Key nameContentsDefault value
add.class.pathSpecify the values to be added in the class path.
To specify multiple values, use the same key names and specify the class path. In the contents, you can specify the Cosminexus installation directory as ${cosminexus.home}.
(Example of specification)
add.class.path=C:/home/lib/mylib.jar
None
add.jvm.argSpecify the option for starting up the JavaVM.
You can specify the following JavaVM options:
  • -Xmssize
  • -Xmxsize
  • -XX:PermSize=size (08-00 or later)
  • -XX:MaxPermSize=size (08-00 or later)
  • -XX:[+|-]HitachiOutOfMemoryAbort (08-50 or later)
To specify multiple options, use same key names and specify as follows:
(Example of specification)
add.jvm.arg=-Xms128m
add.jvm.arg=-Xmx256m
An attempt to start the Administration Agent fails when you specify a value that JavaVM cannot authenticate.
None
add.library.pathSpecify the values to be added in the search library path.
To specify multiple values, use the same key names and specify the search library path. In the contents, you can specify the Cosminexus installation directory as ${cosminexus.home}.
(Example of specification)
add.library.path=C:/home/bin
None
add.network.driveSpecify the name and directory path of the allocation destination of the drive allocated as the network drive.
(Example of specification)
X=\\host\dir
Note that if the path ends with \, you might not be able to connect to the network drive.
In UNIX, the KEOS21401-E message is output to /opt/Cosminexus/manager/adminagent.err and Administration Agent stops with end code 1.
None

(5) Precautions

If java.lang.OutOfMemoryError occurs in the Administration Agent, the maximum size of Java heap in this file will be extended as follows:

add.jvm.arg=-Xmx maximum-size-of-Java-heap