Skip to content

Start parameters

When running Easit GO, either directly from the command line or as a service, we need to pass some parameters to the java runtime (JVM) for it to startup correctly. Below you can find the parameters Easit GO requires and the optional parameters for further customization.

Required

Name Description
-Xmx Specifies the maximum heap size, i.e how much memory Easit GO can use on the server.
-XX:+UseStringDeduplication When you pass this JVM argument during application startup, JVM will try to eliminate duplicate strings as part of the garbage collection process. During the garbage collection process, the JVM inspects all the objects in memory, thus as part of that process, it tries to identify duplicate strings among them and tries to eliminate it.
-XX:+PerfDisableSharedMem Determines whether the memory for storing PerfData can be shared, that is to say, regardless of whether this parameter is set or not, the JVM will allocate a piece of memory to store the PerfData when it starts, just to say whether the PerfData is visible to other processes.
-Djava.locale.providers Specifies what locale providers should be made available to handle locale specifics characters, timezones and such.
-Dsun.stdout.encoding Specifies what encoding to use when writing files to disk.
-Dorg.zkoss.util.resource.extendlet.checkPeriod Specifies the zkoss framework should check for changes within the resources.
-jar Specifies what JAR file to run / start.

The line below can be added either as the value for the arguments element in easitgo-service.xml or added at the end when running java from the command line.

1
2
3
<!-- easitgo-service.xml -->
<executable>%BASE%\jre\bin\java</executable>
<arguments>-Xmx4g -XX:+UseStringDeduplication -XX:+PerfDisableSharedMem -Djava.locale.providers=JRE,CLDR,SPI -Dsun.stdout.encoding=UTF-8 -Dorg.zkoss.util.resource.extendlet.checkPeriod=2 -jar "%BASE%\..\easitgo.jar"</arguments>

1
PS D:\Easit\Prod> Start-Process .\bin\jre\bin\java.exe -ArgumentList '-Xmx4g', '-XX:+UseStringDeduplication', '-XX:+PerfDisableSharedMem', "-Djava.locale.providers=JRE,CLDR,SPI", "-Dsun.stdout.encoding=UTF-8", "-Dorg.zkoss.util.resource.extendlet.checkPeriod=2", "-jar easitgo.jar" -NoNewWindow

Optionals

Name Description
-DbpeBasePath Specifies root directory for Easit GO. If nothing else is specified, Easit GO looks for directories called config, logs, solr and files in this directory.
-DbpeConfigPath Specifies path to the config directory where for example, properties.xml, is located. The default value is 'config' relative to 'bpeBasePath'.
-DbpeLogsPath Specifies path to the directory to where Easit GO writes its logs. The default value is 'logs' relative to 'bpeBasePath'.
-DbpeAuditLogsPath Specifies path to the directory to where Easit GO writes its audit logs. The default value is 'audit' relative to 'bpeLogsPath'.
-bpeDesignMoverPath Specifies path to the directory to where Easit GO writes and reads design mover files. The default value is 'design_mover' relative to 'bpeConfigPath'.