In this topic you find the full list of MetaMiner Client system variables which you can use to fine-tune the way MMC runs in your environment:
System Variable Name |
Default Value |
Description |
working.directory |
. |
Relational path (from the folder where the MetaMiner.ini file is located) to use as a working directory when running MetaMiner Client. |
vm.location |
..\jre\bin\server\jvm.dll |
Java Virtual Machine dynamic library (jvm.dll) to use for starting MetaMiner Client. Includes a relational path from the folder where the MetaMiner.ini file is located. |
vmarg.* |
Special group of variables, see below |
|
classpath.1 |
lib\*.jar |
There can be any number of classpath variables. |
classpath.2 |
. |
|
service.class |
xyz.ClientMain |
For internal usage, do not touch. |
log |
logs\server.start.log |
Starter wrapper log. You need to elevate permissions and run MMC as local Administrator to enable it to write log files in your program folder! |
splash.image |
res\splash_metaminer.jpg |
For internal usage, do not touch. Splash-screen (JPEG image file) to be displayed while loading and initializing MetaMiner Client. |
There is a special group of system variables. They allow to transfer any number of additional options to MetaMiner Client executable file as Java Virtual Machine 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
N - consecutive number of a VMARG system variable, for example: 1
varname - the system variable name, for example: ssl.enabled
varvalue - optional value of the system variable, for example: true
The sample list of VMARG variables:
vmarg.1=-Xrs
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: Ctrl-Break thread dumps are not available; 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 |
768m |
The initial amount of memory allocated for MetaMiner Client. "m" stands for megabytes. |
Xmx |
Y |
1024m |
The maximum amount of memory that can be allocated for MetaMiner Client. Same syntax. These memory-related variables are used without "=" character. For example: vmargs.2=-Xms1024m You can track the initial and current memory size allocated for MMC in its status bar. |
XX:StringTableSize |
Y |
100007 |
JVM parameter for storing string data. If you load too huge amounts of data in MMC and you experience slowing down its performance, increase this value. |
Dfile.encoding |
Y |
utf8 |
If MetaMiner Client cannot determine encoding of some external file loaded, we assume that this file is encoded using this parameter. |
Dlogback.configurationFile |
Y |
MetaMiner.logback.xml |
LOGBack configuration file for format details Can contain path. |
XX:+HeapDumpOnOutOfMemoryError |
N |
JVM flag for dumping heap to the working directory on out-of-memory error. |
|
XX:MaxPermSize |
Y |
256m |
JVM parameter for maximum RAM allocated to garbage collector. |
XX:-OmitStackTraceInFastThrow |
N |
JVM flag for disabling completely the use of preallocated exceptions. |
|
agentlib:jdwp |
Y |
transport=dt_socket,server=y, |
JVM parameters for remote access to MetaMiner Client java process. 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 |
N |
||
Dcom.sun.management.jmxremote.port |
Y |
8086 |
|
Dcom.sun.management.jmxremote.ssl |
Y |
false |
|
Dcom.sun.management.jmxremote.authenticate |
Y |
false |
|
Dssl.enabled |
Y |
false |
Flag to enable/disable SSL/TLS-encrypted connection to MetaMiner Server. SSL must first be enabled on server side! |
Duser.country |
Y |
US |
JVM environment parameter for regional settings - it influences rendering of timestamps, currencies, and similar settings. |
Duser.language |
Y |
en |
See also
MetaMiner Client System Variables