Instant JChem System Requirements

    Hardware Requirements

    Minimal requirements:

    Hardware Minimal requirement
    RAM 4 GB or higher
    Hard-drive space 1 GB

    Instant JChem employs a sophisticated caching system so that it can handle large data sets without needing all the data to be in the memory. In general this works very well, but everything has its limits. You may need to increase the memory that IJC will have access to.

    Additional memory for JChem Base database tables:

    • Each million structures need additional 100 MB of memory

    • For 600 Markush structures, around 700 MB of additional memory is needed

    • For more detail, see memory usage documentation.

    For JChem Cartridge based solutions, minimum recommended memory should suffice. For server memory settings, see documentation here.

    Software Requirements

    Operating System

    Instant JChem is tested on the following platforms:

    • Windows 11 (64-bit)

    • Windows 10 (64-bit)

    • Windows 8 (64-bit)

    • GNU/Linux (64-bit)

    • Mac OS X (64-bit)

    System Encoding and Font Settings

    Users, particularly those on Windows, should verify their default system encoding and font settings, as Instant JChem adheres to these defaults unless specified otherwise. If the default settings do not meet your requirements, it's important to adjust them.

    For fonts, users should ensure that their chosen font supports the characters and symbols necessary for their work. This is especially crucial for displaying chemical structures and other specialized data correctly. Should you need to change default font settings in Instant JChem see documentation here.

    We recommend using UTF-8 as the encoding format. To do so, you can either use command line and enter -Dfile.encoding=UTF-8 or navigate to etc/instantjchem.conf and add -J-Dfile.encoding=UTF-8 among default options already specified in the instantjchem.conf file.

    JChem Cartridge Compatibility

    Instant JChem is tested with the current version of JCC (with the same version as the last release).

    Supported Databases

    For more info, please refer to user guide about supported databases.

    Known issues and limitations of the databases usage

    In details, it is described in supported databases section.

    Java

    For changing Instant JChem Java version navigate here

    Supported major Java versions:

    • Java 17 (from IJC version 23.11.0 JRE for java 17 required)

    • Adoptium 11 (from IJC version 20.11.0 supported, from IJC version 21.20.0 is an option instead Oracle Java)

    • Java 11 (from IJC version 20.11.0 supported, from IJC version 21.20.0 JRE for Java 11 required)

    • Adoptium 8 (from IJC version 18.22.0 and LTS Carbon 1 until IJC version 21.14.0 and LTS Helium)

    • Java 8 (from IJC version 15.2.20 until IJC version 21.14.0 and LTS Helium)

    {warning} Java 17 and Spring Security 6 framework: is required from the version 23.11.

    {primary} Adoptium 8 and JWS: Please note that Adoptium 8 and Java 11 doesn't support Java Web Start. Adoptium is not recognized by the InstantJChem application, when the default setup is used. Adoptium for Windows actually does contain FeatureOracleJavaSoft feature, which solves this. (It updates registry and subsequently IJC is able to pick correct Java). Use FeatureOracleJavaSoft feature or setup --javahome For more information please follow the Adoptium documentation

    {primary} Using 64-bit Java is highly recommended.

    Tomcat compatibility

    • Note that Tomcat 10 is required for deploying URLWebApp from IJC version 23.11.0

    Spotfire

    Currently supported versions of Spotfire server are: 10.10.

    {warning} The Spotfire integration has been removed from IJC. Since version 21.10.0., it is available via Plexus Connect. For more details about deploying and usage of the new Spotfire integration, please refer to documentation.

    ChemDraw

    ChemDraw is not supported.

    IJC version ChemDraw supported
    since 18.21.0 Support has been dropped
    since 6.0.3 until 18.20.0 ChemDraw 12 or 13 (32-bit)
    5.12.x ChemDraw 12 (32-bit)