Installation Guide¶

Docker
- Docker compose
- Download manually
Installers

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

1	`docker login chemaxon.jfrog.io`

to set up Docker to access the repository.

Download¶

Run

1	`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