Overview installation and configuration issues

From OpenChrom-Wiki
Jump to: navigation, search

A few issues may occur, when you install OpenChrom or start the software after installation:

  • If you have downloaded the zipped Windows installation package of OpenChrom instead of using the default Windows unzipper, we recommend to use the free and open source file archiver 7-zip to unzip the software. The default Windows archiver fails, because it is limited to a certain length of characters.
  • If your computer happens to be located behind a proxy server (frequently the case in companies and universities), ask the responsible IT-service for the necessary proxy settings and follow the instructions under OpenChrom behind a proxy.
  • If you recieve an error message on opening OpenChrom which starts with: "Java was started but returned exit code=13", it is most likely because of an incompatible Java version being installed on your system; i.e. if you have installed the OpenChrom 64-bit version it demands a 64-bit Java version. Please double-check by opening the command line interface of your system and type: " java -version ". If you have a 32-bit java version installed please update to a 64-bit version.
  • If the available RAM of your computer is too low, several issues may occur, which may be fixed by adjusting the "heap settings" (see below):
    • OpenChrom may be unable to start
    • Opening of large data files may take unusually long. (Note, that the time for opening very large files, such as MALDI-MS or high-resolution LC/MS files will be long even with sufficient RAM.)
    • Opening multiple data files is halted after a certain amount (e.g. after 10 open data files)
Solution:
The "heap settings" are located in the openchrom.ini file, which you find in the OpenChrom folder. Open openchrom.ini with a text editor and try to solve one of the above issues by changing the initial ("Xms") and maximum heap size ("Xmx"): e.g. -Xms512M to -Xms256M and -Xmx2048M to -Xmx1024M. Don't forget to save the changes before closing.