Laserfiche WebLink
TSTool Documentation <br /> Troubleshooting - Install - 1 <br />TSTool – Troubleshooting the Software <br />Installation <br />2015-07-26 <br /> <br />This document provides information about troubleshooting the TSTool software installation, in particular <br />to diagnose major problems that may occur starting the software and connecting to datastores. <br /> <br />Issue #1 – Java Virtual Machine Launcher Error <br /> <br />Scope – This error has been seen on Windows computers. <br /> <br />Behavior – The following error is displayed when trying to start TSTool: <br /> <br /> <br />Possible Cause – TSTool was updated from Java 6 to Java 7 as of version 11.00.00. The Java Runtime <br />Environment (JRE) provides a “sandbox” to run Java programs like TSTool. The memory for the JRE <br />within this sandbox is split between the JRE itself and the software that is being run. The maximum <br />amount of memory available to the JRE and the software it is running is theoretically 4 GB on a 32-bit <br />operating system or when a 32-bit JRE is running on a 64-bit operating system. Practically, however, the <br />amount of memory available to a program running in the JRE is in the range 1.4 to 1.6 GB. Differences <br />between memory use for JRE versions 6 and 7 may be causing this error. <br /> <br />Possible Solution #1– The amount of memory allocated to TSTool at startup may be greater than the <br />amount that is available on the computer. Try closing some other applications and then restarting <br />TSTool. <br /> <br />Possible Solution #2– The amount of memory allocated to TSTool at startup is controlled by the –Xmx <br />option in the software launcher configuration file TSTool.l4j.ini, which is located in the bin folder under <br />the TSTool installation folder. The default value for the software may be too high based on the <br />computer’s configuration. To resolve, edit the TSTool.l4j.ini file with a text editor and decrease the <br />number at the end of the –Xmx parameter. For example, use the following: <br /> <br />-Xmx1100m -Dsun.java2d.noddraw=true -Djava.net.useSystemProxies=true <br /> <br />The above solution will need to be implemented after each TSTool installation, unless the TSTool <br />defaults are changed in future releases. <br />