Hitachi

uCosminexus Application Server Definition Reference Guide


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

Organization of this subsection

(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 name

Contents

Default value

add.class.path

Specify 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.arg

Specify the option for starting up the JavaVM.

You can specify the following JavaVM options:

  • -Xmssize

  • -Xmxsize

  • -XX:MetaspaceSize=value

  • -XX:MaxMetaspaceSize=value

  • -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.path

Specify 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.drive

Specify 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