Installation Guide

    Docker

    Docker compose

    We recommend using docker compose to set up a JChem Microservices system. In that case, Docker will automatically download the images as you use them.

    You can find an example compose file for JChem Microservices on GitHub.

    Download manually

    Prerequisites

    In order to download the official Docker images of JChem Microservices, you need to install Docker on your system and configure it to access the Chemaxon Public Repository. After acquiring your credentials, you can simply call

    docker login chemaxon.jfrog.io

    to set up Docker to access the repository.

    Download

    Run

    docker pull chemaxon.jfrog.io/cxn-docker-release/chemaxon/<module_name>:<version_number>

    where <module_name> specifies which common or chemical functional module you need:

    Module Docker image
    Config service jms-config
    Discovery service jms-discovery
    Gateway service jms-gateway
    Calculations Web Services jms-calculations
    DB Web Services jms-db
    IO Web Services jms-io
    Markush Web Services jms-markush
    Reactor Web Services jms-reactor
    Structure Checker Web Services jms-structurechecker
    Structure Manipulation Web Services jms-structure
    Task Manager jms-taskmanager

    Please note that for LTS versions, the <version_number> has to be the version number and not the display version, e.g. 24.4.3 instead of Platinum.3.

    Installers

    Download

    Download jws-installer – appropriate for your operating system – from https://download.chemaxon.com/jchem-microservices

    Install

    Windows

    Choose one of the following:

    • unzip jws_windows_x64_<version_number>. zip
    • run jws_windows_x64_<version_number>.exe as Administrator

    Linux

    Choose one of the following:

    • uncompress jws_unix_<version_number>.tar.gz
    • run jws_unix_<version_number>.sh
    • on Debian and Ubuntu, run sudo dpkg -i jws_linux_<version_number>.deb
    • on Redhat and Centos, run sudo yum install jws_linux_<version_number>.rpm

    Mac OS

    Choose one of the following:

    • uncompress jws_unix_<version_number>.tar.gz
    • run jws_macos_<version_number>.dmg

    Uninstall

    Depends on the operating system and the installation mode you applied.

    Windows

    If you used the zip installer, simply delete the folder where you put the JChem Microservices files.

    Otherwise, run C:\Program Files\Chemaxon\JChem Micro Services\uninstall.exe

    Linux

    If you used the tar.gz installer, simply delete the folder where you put the JChem Microservices files.

    Otherwise, choose the appropriate:

    • run <Installation folder>/Chemaxon/JChem Micro Services/uninstall
    • on Debian and Ubuntu, run sudo dpkg -r jws
    • on Redhat and Centos, run sudo yum erase jws