JavaVM options file for RMI connections (jvm_client

uCosminexus Stream Data Platform - Application Framework Setup and Operation Guide

8.5 JavaVM options file for RMI connections (jvm_client_options.cfg)

(1) Format

(2) File name

(3) File storage location

(4) Description

(5) Specifiable parameters

The table below lists and describes the parameters that can be specified and their default values. For details about the JavaVM options, see 8.11 List of JavaVM options.

Table 8-3 Specifiable parameters and their default values (jvm_client_options.cfg)

No.	Parameter name	Description	Default value
1	SDP_CLASS_PATH	Specifies the jar file that is used by the RMI-connection adaptors. This file depends on the system configuration.^# If you need to specify multiple jar files, you must specify this parameter for each jar file. The following shows an example: Example: SDP_CLASS_PATH=. SDP_CLASS_PATH=C:\\sdp\\AP If you specify a relative path for a jar file, make sure that the specified path is relative to the working directory.	None
2	SDP_CLASSLIB_TRACE	Specifies whether a stack trace is to be output for the class library.	-XX:-HitachiJavaClassLibTrace
3	SDP_CLASSLIB_TRACE_LINESIZE	Specifies the number of characters per line of stack trace for the class library.	-XX:HitachiJavaClassLibTraceLineSize=1024
4	SDP_GC	Specifies whether extended verbosegc information is to be output when garbage collection occurs.	-XX:-HitachiVerboseGC
5	SDP_GC_PRINT_CAUSE	Specifies whether the cause of garbage collection is to be output.	-XX:+HitachiVerboseGCPrintCause
6	SDP_INITIAL_MEM_SIZE	Specifies the initial Java heap size. You specify in this parameter the value obtained in 2.7.1 Estimating the memory requirements for the stream data processing engine and 2.7.2 Estimating the memory requirements for standard adaptors.	-Xms2048k
7	SDP_JVM_LOG	Specifies a prefix for the log file name.	-XX:HitachiJavaLog:javalog
8	SDP_JVM_LOG_FILE_SIZE	Specifies the maximum size of a single log file.	-XX:HitachiJavaLogFileSize=256k
9	SDP_LOCALS_IN_STACK_TRACE	Specifies whether the local variable information is to be output to the stack trace during a thread dump output.	-XX:-HitachiLocalsInStackTrace
10	SDP_LOCALS_SIMPLE_FORMAT	Specifies whether the simple format is to be used to output local variable information.	-XX:-HitachiLocalsSimpleFormat
11	SDP_MAX_MEM_SIZE	Specifies the maximum Java heap size. You specify in this parameter the value obtained in 2.7.1 Estimating the memory requirements for the stream data processing engine and 2.7.2 Estimating the memory requirements for standard adaptors.	-Xmx64m
12	SDP_MAX_PERM_SIZE	Specifies the maximum size of the Permanent area.	-XX:MaxPermSize=64m
13	SDP_NEW_RATIO	Specifies the ratio of the Tenured area to the DefNew area.	-XX:NewRatio=2
14	SDP_OOM_STACK_TRACE	Specifies whether a stack trace is to be output in the event of an OutOfMemoryError.	-XX:-HitachiOutOfMemoryStackTrace
15	SDP_OUTPUT_MILLI_TIME	Specifies whether the time is to be output in milliseconds.	-XX:-HitachiOutputMilliTime
16	SDP_PERM_SIZE	Specifies the initial size of the Permanent area.	-XX:PermSize=16m
17	SDP_THRD_DUMP	Specifies whether a thread dump is to be output to the standard output.	-XX:+HitachiThreadDumpToStdout
18	SDP_TRUE_TYPE_IN_LOCALS	Specifies whether the actual type name of a local variable object is to be output as a character string when the local variable information is output.	-XX:-HitachiTrueTypeInLocals
19	SDP_USER_OPT	Specifies a JavaVM option when the administrator user wishes to add a JavaVM option. To specify multiple JavaVM options, you must specify this parameter for each of the options. The following shows an example: Example: SDP_USER_OPT=-Dxxx=www SDP_USER_OPT=-Dyyy=zzz If you specify the same option more than once, the last option specified (that is the closest to the end of the file) takes effect.	None

#: For standard adaptors, the values are fixed. Specify the following values:; SDP_CLASS_PATH=installation-directory\\psb\\jaxp\\lib\\csmjaxb.jar; SDP_CLASS_PATH=installation-directory\\psb\\jaxp\\lib\\csmjaxp.jar; SDP_CLASS_PATH=installation-directory\\psb\\jaxp\\lib\\csmstax.jar; SDP_CLASS_PATH=installation-directory\\psb\\CC\\lib\\hitj2ee.jar

(6) Notes

Garbage collection is performed periodically on references to remote objects. You can specify a garbage collection interval in milliseconds in the sun.rmi.dgc.client.gcInterval and sun.rmi.dgc.server.gcInterval properties that are specified when RMI connection is used. The default value is 60,000 milliseconds (60 seconds). To change the garbage collection interval, specify the sun.rmi.dgc.client.gcInterval and sun.rmi.dgc.server.gcInterval properties in the SDP_USER_OPT parameter and specify the desired interval. The permitted value range is from 1 to 9,223,372,036,854,775,806. The following shows an example.

Example:

SDP_USER_OPT=-Dsun.rmi.dgc.client.gcInterval=1000000000

SDP_USER_OPT=-Dsun.rmi.dgc.server.gcInterval=1000000000
We recommend that you use different JavaVM log output destinations for input adaptors and output adaptors. If you wish to specify a JavaVM log output destination and a Java heap size for each adaptor, create a JavaVM options file for RMI connections for each adaptor by following the procedure described below.
1. Prepare a JavaVM options file for RMI connections.
  Copy the provided sample file for the JavaVM options file for RMI connections to the desired directory. For details about the sample file storage directory, see 3.2.1 Structure of the installation directory.
2. Edit the copy of the JavaVM options file for RMI connections.
  For a JavaVM log file name, a 2-digit number (01 to the number of log files) is added immediately after the prefix specified in the SDP_JVM_LOG parameter. If you use different log output destinations for input and output adaptors, make sure that their prefixes are different.
  Example:
  Specification of a JavaVM log output destination for input adaptors:
  SDP_JVM_LOG=-XX:HitachiJavaLog:C:\\sdp\\logs\\SDPReceiverClientVM
  Specification of a JavaVM log output destination for output adaptors:
  SDP_JVM_LOG=-XX:HitachiJavaLog:C:\\sdp\\logs\\SDPSenderClientVM
3. When you start an adaptor, specify the correct JavaVM options file for RMI connections in the -clientcfg option of the sdpstartap command.