-
Notifications
You must be signed in to change notification settings - Fork 17
JavaTroubleShooting
The aim of this page is to provide help with common Java related issues that one can encounter when using software from the CompOmics group. If you have a Java related question that is not answered below please let us know.
- Do you have Java installed? Download the latest version of Java here. (You only need the JRE version (and not the JDK version) to run CompOmics tools.) 64 bit is always recommended!
-
Memory Issues I - Big datasets can require a lot of memory. If the software fails on a big project, and the software mentions that it ran out of memory, try to give the program more memory. This can be done by selecting
Java Options
on theEdit
menu in most tools. Set the memory limit in MB, e.g.,4000
for a maximum of appr. 4 GB of memory. Please note that on a 32-bit operating system you cannot increase this value beyond 2000 (and usually the maximum limit is lower than this). -
Memory Issues II - Using more than 2 GB of memory requires 64 bit Java. Downloaded from the same location as the 32 bit version: Java. Note that 64 bit Java only works on 64 bit operating systems!
-
Java 32 bit vs 64 bit - Java comes in two versions: 32 bit and 64 bit. The 32 bit version is limited to using a maximum of around 2 GB of memory. For bigger datasets this is not always enough. Most newer machines support the 64 bit version, and it is always recommended to use Java 64 bit if possible.
-
Multiple Installations - If you have both 32 and 64 bit versions of Java the operating system can get confused about which version to use when running Java tools. For Windows the CompOmics tools try to default to the 64 bit version of Java. You can override this option by setting your own Java Home, by creating a file called
JavaHome.txt
in theresources\conf
folder of the tool, with the path to the bin folder of the Java installation, e.g.,C:\Program Files\Java\jdk1.7.0_21\bin\
. If the folder does not exist (or it does not contain the required files), the default Java version will be used.
-
Does Not Start I - Do you have Java installed? Download the latest version of Java here and try again. (You only need the JRE version (and not the JDK version) to run CompOmics tools.) 64 bit is always recommended!
-
Does Not Start II - Have you unzipped the zip file? You need to unzip the file before double clicking the jar file. If you get the message "A Java Exception has occurred", you are most likely trying to run the tool from within the zip file. Unzip the file and try again.
-
Does Not Start III - Is the tool installed in a path containing special characters, i.e.
[
,%
, æ, ø, å, etc? If so, move the whole folder to a different location or rename the folder(s) causing the problem and try again. (Note that on Linux, most tools have to be run from paths not containing spaces as well). -
Does Not Start IV - If the tool fails during start-up many of our tools generate a file called
startup.log
in the tool'sresources\conf
folder. Here you can find detailed information about why the program was not able to start. -
Unidentified Developer - If you run Java applications on a Mac you can get the warning "Application" can't be opened because it is from an unidentified developer. To escape this warning control-click on the file icon and then select "Open." This will give you the option of opening it regardless of its unidentified source. This only has to be done once for each version of the application.
- Problem Not Solved? Or Problem Not In List? Contact the developers by setting up an issue describing the problem at the given tool's web page (available via the Issues tab).