Page tree

DB Web Services provide methods for storing and searching chemical structures in a persistent database, currently in MapDB. MapDB works with collections, but in this documentation the terminology table is used instead of collection.

There are methods provided for

  • creating / deleting tables
  • inserting / deleting / modifying structures and data in the tables
  • executing duplicate, substructure and similarity searches

This documentation describes installation, administration and usage of DB Web Services.

DB Web Services application is available in two modes:

  1. As part of a microservices system
  2. As standalone web application

Microservices system mode

In microservices system mode the DB Web Service runs together with Config service, Discovery service and Gateway service. These three services are mandatory and optionally other services can also be part of the system. All configuration must be done in the Config module.

The default configuration applies to the microservices system mode.

The web application runs on host <server-host> and listens on port <gateway-server-port>.

Standalone web application mode

In standalone web application mode the DB Web Service runs alone, without the Config service, Discovery service and Gateway service (however the installer installs them, as well).

The default configuration must be changed according to the standalone web application mode; set eureka.client.enabled=false in file and and (so to empty) in file.

All configuration must be done in the DB module.

The web application runs on host <server-host> and listens on port <server-port>.


See here.

Software requirements

See here


See here.

Module is installed into folder: jws/jws-db


See here.

Additionally, IUPAC naming plugin license is required for the usage of Name file format.


Default configuration:


set eureka.client.enabled=false to switch to standalone DB Web Services application mode 

initOnStart can be INIT|AUTO|OPEN

INIT: the existing database is deleted, and a new empty one is created

AUTO: existing database is started, in case of non-existing database a new empty one is created

OPEN: existing database is started, in case of non-existing database error is thrown.


updateMode gets in action only if the version number has changed

updateMode can be EXIT|DROP|REINDEX

EXIT: exit if version mode has changed

DROP: drop old data if version mode has changed

REINDEX: keep old data and reindex them in order to work with new version





com.chemaxon.zetor.types[0].version = 1

com.chemaxon.zetor.types[0].typeName = sample

com.chemaxon.zetor.types[0].typeId = 1

com.chemaxon.zetor.types[0].tautomerHandlingMode = OFF

com.chemaxon.zetor.types[0].standardizerConfig = aromatize

com.chemaxon.zetor.types[1].version = 1

com.chemaxon.zetor.types[1].typeName = taumol

com.chemaxon.zetor.types[1].typeId = 2

com.chemaxon.zetor.types[1].tautomerHandlingMode = GENERIC

com.chemaxon.zetor.types[1].standardizerConfig = aromatize

Here are the molecule types defined. You can delete, modify or add new molecules types.

version must be 1

typeName must be unique

typeID must be unique integer

tautomerHandlingMode can be OFF or GENERIC

standardizerConfig can be made of action strings or the content of a standardizer configuration xml file


Important: Indexing of the types array must always be sequential 0, 1, 2, ....

All changes take effect only if initOnStart is set to INIT, and the application is re-started. Take care, the existing database will be deleted.



Performance tuning can be executed by doing some cache related settings. Please use our JChem PostgreSQL Cartridge Xmx Calculator page (take into account that superstructure search is not available) to calculate the appropriate settings.

All properties calculated by the Xmx calculator must be copied into the file (not into the file specified on the calculator page) and the prefix 'com.chemaxon.jchem.psql'  in keys must be substituted with prefix 'com.chemaxon.zetor.settings' like






The infix '.runtime' in keys is not used from version 19.11 on.

Using version 19.11 or newer, the following configuration may be used:






For more settings possibilities see spring documentation page.

Running the server

Prerequisites in case of microservices system mode:

  1. Config service is running
  2. Discovery service is running
  3. Gateway service is running

Run the service in command line in folder jws/jws-db:

jws-db-service --start (on Windows)

jws-db-service start (on Linux)


run-jws-db.exe (on Windows)

run-jws-db (on Linux)

API Documentation

Find and try out the API on the Swagger UI.

ModeURL of Swagger UIdefault URL of Swagger UI
microservices system<serverhost>:<gateway-port>/jwsdb/API/ localhost:8080/jwsdb/API/
standalone web application mode<serverhost>:<server-port>/API/localhost:8062/API/

Demo site

For detailed description check out the JWS DB demo site:


Follow the guidelines, examples on the Demo site or on the Swagger UI API documentation of your installed module.

Molecule type information

DB Web Services provides method for getting the available molecule types.

Every table has a Molecule type: this is a descriptor that is used by the search engine. It contains information about how structures are handled during search. The application has two very simple built in types called: sample (search with aromatization) and taumol (tautomer search).

Store and search molecules and non-chemical data

Table operations

Structure Insert/Delete methods

Duplicate search methods

Substructure search methods

Similarity search methods

Data recovery

The data apparently stored in tables (collections) are stored in the file system under jws-db/data/ folder. The content of that folder must be stored as backup. Furthermore, the file(s) also should be saved.