MMTE Server VMARG System Variables¶
There is a special group of system variables. They allow to transfer any number of additional options to MMTE Server executable file as Java Virtual Machine (JVM) arguments (VMARG).
Make sure each VMARG system variable is written one per line, with numbering.
All VMARG system variables must be consecutively enumerated with decimal numbers starting with 1 without interruption. For example, this is the valid sequence:
1, 2, 3, 4, 5
The following sequences are all invalid and will raise errors:
0, 1, 2, 3
1, 2, 4, 5
2, 3, 4, 5
4, 3, 2, 1
The general format of a VMARG system variable is as follows:
vmarg.N=-varname[=varvalue]
where
| Parameter | Description | Example |
|---|---|---|
| N | consecutive number of a VMARG system variable | 1 |
| varname | the system variable name | Xms |
| varvalue | optional value of the system variable | 8192m |
The sample list of VMARG variables:
vmarg.1=-Xrs
vmarg.2=-Xms8192m
vmarg.4=-Dfile.encoding=utf8
| VMARG Variable Name | Value? | Default Value | Description |
|---|---|---|---|
| Xrs | N | Reduces use of operating system signals by the JVM. There are two consequences of specifying -Xrs: 1) Ctrl-Break thread dumps are not available; 2) User code is responsible for causing shutdown hooks to run, for example by calling System.exit() when the JVM is to be terminated. |
|
| Xms | Y | 1024m | See Adjusting MMTE Memory Settings |
| Xmx | Y | 2048m | |
| Dfile.encoding | Y | utf8 | If MMTE cannot determine encoding of some external file loaded, we assume that this file is encoded using this parameter. |
| Dlogback.configurationFile | Y | MetaMinerServer. logback.xml |
LOGBack configuration file with all MMS logging settings. It can include a path. |
| Dproxy.auth.user | Y | See MMTE over Proxy Server | |
| Dproxy.auth.password | |||
| Dproxy.host | |||
| Dproxy.port | |||
| Drassdk.listener.port | Y | 6499 | TCP/IP port to use with RAS SDK |
| XX:+ HeapDumpOnOutOfMemoryError |
N | JVM flag for dumping heap to the working directory on out-of-memory error. | |
| XX:CompileCommandFile | Y | MetaMinerServer.hs.txt | CompileCommand allows simple control over what is allowed to be compiled (includes/excludes). A recommended MetaMinerServer.hs.txt file is provided in the MMS installation folder. |
| XX:- OmitStackTraceInFastThrow |
N | JVM flag for disabling completely the use of preallocated exceptions. | |
| XX:+ PrintFlagsFinal |
N | Outputs an alphabetically sorted table of XX flags (note that the number of flags may change with each Java release). | |
| XX:+ PrintCommandLineFlags |
N | Outputs the names and values of exactly those XX flags that have been set by the user or JVM ergonomics on startup. That means it displays the modified flags only. | |
| XX: MaxPermSize |
Y | 256m | JVM parameter for maximum RAM allocated to garbage collector. |
| XX:+ PrintGC |
N | Activates the simple garbage collection (GC) logging mode, which prints a line for every young generation GC and every full GC. | |
| XX:+ PrintGCDetails |
N | Activates the detailed garbage collection (GC) logging mode, which differs depending on the GC algorithm used. | |
| XX:+ PrintHeapAtGC |
N | With this option, three memory addresses for each heap region are printed in the GC logs: lower address of the reserved memory region; current pointer to the top of the allocated area; upper bound of the reserved memory region. | |
| XX:+ PrintGCDateStamps |
N | Adds the date and time of the log entry to the beginning of each line. | |
| XX:+ PrintGCTimeStamps |
N | Adds a timestamp to every line of the log detailing the time passed (in seconds) since the JVM was started. | |
| XX:- PrintTenuringDistribution |
N | Adds extra GC event detail. | |
| XX:- PrintAdaptiveSizePolicy |
N | Adds details about the G1 (Garbage First) ergonomics to each of events. This provides an insight into Collection Set selection and pause time estimates. | |
| XX:+ UseGCLogFileRotation |
N | Enables GC log file rotation (automatic limitation and archiving). | |
| XX: NumberOfGCLogFiles |
Y | 40 | Limits the maximum number of archived log files. |
| XX: GCLogFileSize |
Y | 10M | Limits the maximum size of a single log file (Megabytes). |
| Xloggc | Y | logs/gc-%t.log | Log file path & name mask. %t will be replaced with a timestamp. Note: colon ":" must be used instead of "=", for example: vmarg.19=-Xloggc:logs/gc-%t.log |
| agentlib:jdwp | Y | transport=dt_socket, server=y, suspend=n, address=5005 |
JVM parameters for remote access to MetaMiner Server java process. |
| Dcom.sun.management. jmxremote |
N | JVM parameters for remote access to MMTE Server Java process using the Java Management Extensions (JMX) technology. Disabled by default. It can be reasonable for debug purposes only. It is strongly recommended not to enable remote access for security reasons. |
|
| Dcom.sun.management. jmxremote.port |
Y | 8085 | |
| Dcom.sun.management. jmxremote.ssl |
Y | false | |
| Dcom.sun.management. jmxremote.authenticate |
Y | false | |