Forums » Interstage XWand Knowledgebase Articles
How to Set JVM Heap Size for XWand ToolKit
-
Goal: How to Set JVM Heap Size for XWand ToolKit
Fact: XWand ToolKit v13.0.3 or higher versions
Fix:
A batch file called optionsetup.bat is introduced in XWand ToolKit v13.0.3 or higher versions for setting JVM (Java Virtual Machine) heap size prior to running various XWand Tools.
To edit the default settings, do the following:
Step 1: Locate optionsetup.bat, typically found in
c:\Program Files (x86)\ISXWand\XWand-tk\tools
Step 2: Edit optionsetup.bat with an editor such as notepad.exe
Below is the default contents:
SET JAVA_OPTIONS=-Xmx800m -Xms256m -XX:MaxPermSize=80m -Xss2m
Typically, you are only needed to edit the initial heap size -Xms and the maximum heap size -Xmx for loading large size of taxonomy files or instance document.
For more information about setting the JVM heap size options, please refer JVM documentation on tuning performance.
-
optionsetup.bat as mentioned above has been changed in v13.2.x and onwards to:
REM ===== Initial Heap Size =====
SET FJXW_MS=256m
REM ===== Maximum Heap Size =====
SET FJXW_MX=850m
REM ===== Thread Stack Size =====
SET FJXW_SS=2m
REM ===== Maximum Perm Size =====
SET FJXW_MP=80m
REM ===== Other Options =====
SET FJXW_OT=
REM ===== Option Name Perm Size / Metaspace Size =====
%JAVA% -version 2>&1 | findstr [1].[4-7].[0-9] > nul
if %ERRORLEVEL% == 0 (
SET FJXW_MP_NAME=MaxPermSize
) else (
SET FJXW_MP_NAME=MaxMetaspaceSize
)
IF DEFINED FJXW_JOPT_MS (SET FJXW_MS=%FJXW_JOPT_MS%)
IF DEFINED FJXW_JOPT_MX (SET FJXW_MX=%FJXW_JOPT_MX%)
IF DEFINED FJXW_JOPT_SS (SET FJXW_SS=%FJXW_JOPT_SS%)
IF DEFINED FJXW_JOPT_MP (SET FJXW_MP=%FJXW_JOPT_MP%)
IF DEFINED FJXW_JOPT_OT (SET FJXW_OT=%FJXW_JOPT_OT%)
REM SET JAVA_OPTIONS=-Xmx800m -Xms256m -XX:MaxPermSize=80m -Xss2m
SET JAVA_OPTIONS=-Xmx%FJXW_MX% -Xms%FJXW_MS% -XX:%FJXW_MP_NAME%=%FJXW_MP% -Xss%FJXW_SS% %FJXW_OT%
Please just update the value for line 2 and line 4 for initial and max heap size.