In this topic you find the full list of MetaMiner Server system variables which you can use to fine-tune the way MMS runs in your environment:
System Variable Name |
Default Value |
Description |
working.directory |
. |
Relational path (from the folder where the MetaMinerServer.ini file is located) to use as a working directory when running MetaMiner Server. |
vm.location |
..\jre\bin\server\jvm.dll |
Java Virtual Machine dynamic library (jvm.dll) to use for starting MetaMiner Server. Includes a relational path from the folder where the MetaMinerServer.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.Main |
For internal use, do not touch. |
service.id |
MetaMiner |
|
service.name |
MetaMiner Service |
Name of the main MetaMiner service as it will be displayed in Computer Management tools. |
service.description |
MetaMiner Service for Windows |
Description of the main MetaMiner service as it will be displayed in Computer Management tools. |
log |
logs\server.start.log |
Starter wrapper log. |
There is a special group of system variables. They allow to transfer any number of additional options to MetaMiner Server 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.2=-Xms1024m
vmarg.4=-Dfile.encoding=utf8
vmarg.5=-Dssl.enabled=true
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 |
1024m |
|
Xmx |
Y |
2048m |
|
Dfile.encoding |
Y |
utf8 |
If MetaMiner 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 for format details Can contain path. |
Dcms.pull.audit |
Y |
true |
Enable/disable Audit Database access (you can disable it even if Audit DB is configured in MMA and used in MMC). |
Dcms.pull.emulate |
Y |
false |
Enable/disable the emulation work mode. In the emulation mode, MetaMiner does not retrieve data from SAP BusinessObjects and uses the data stored in the MetaMiner Database exclusively. |
Dcms.pull.fast |
Y |
false |
|
Dcms.pull.metrics |
Y |
false |
Flag to enable Servers tab refresh in MetaMiner Client. |
Dcms.pull.metrics.period |
Y |
600 |
Time period in seconds. MetaMiner Client Servers tab will only have data no sooner than every 10 minutes. In some cases (for example, when the platform is taking many minutes to refresh this data) it may be desirable to completely disable this retrieval. |
Dproxy.auth.user |
Y |
||
Dproxy.auth.password |
Y |
||
Dproxy.host |
Y |
||
Dproxy.port |
Y |
||
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: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 Server 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 |
8085 |
|
Dcom.sun.management.jmxremote.ssl |
Y |
false |
|
Dcom.sun.management.jmxremote.authenticate |
Y |
false |
|
Dssl.enabled |
Y |
false |
See also
MetaMiner Server System Variables