Skip to content

Running the Biomolecule Toolkit Container

The examples for running the Biomolecule Toolkit container are shown here.

Running with MySQL on localhost:3306 having database with name bioreg, with local license file

1
2
3
4
5
6
7
docker run \
    --name=bmt \
    -p 8080:8080 \
    -v /path/to/license_dir:/data/bioreg-home \
    -e CHEMAXON_LICENSE_URL=/data/bioreg-home/license.cxl \
    -d \
    hub.chemaxon.com/cxn-docker-release/chemaxon/biotoolkit:21.1.0-0.15.0-4f26aeaf

Running with MySQL on remote host with license file on a file server

1
2
3
4
5
6
7
8
9
docker run \
    --name=bmt \
    -p 8080:8080 \
    -e CHEMAXON_LICENSE_URL=http://my.license.server/bmt/license.cxl \
    -e DB_URL=jdbc:mysql://my.remote.mysql.host:3306/bmt_db_name?autoReconnect=true&useUnicode=yes&characterEncoding=UTF-8 \
    -e DB_USERNAME=bmt_db_user \
    -e DB_PASSWORD=bmt_db_user_password \
    -d \
    hub.chemaxon.com/cxn-docker-release/chemaxon/biotoolkit:20.16.0-0.13.1-4f26aeaf

Running with Oracle on remote host with license file on a file server

Oracle JDBC drivers are no longer shipping with Biomolecule Toolkit. It is the responsibility of the customer to obtain the Oracle JDBC driver and add it to the BMT classpath as shown in the examples below.

The following package versions are tested with BMT:

  • com.oracle.database.jdbc:ojdbc8:19.7.0.0
  • com.oracle.database.nls:orai18n:19.7.0.0
docker run \
    --name=bmt \
    -p 8080:8080 \
    -e CHEMAXON_LICENSE_URL=http://my.license.server/bmt/license.cxl \
    -e DB_URL=jdbc:oracle:thin:@my.remote.oracle.host:myOraclePort:myOracleInstanceName \
    -e DB_DRIVERCLASSNAME=oracle.jdbc.OracleDriver \
    -e DB_TYPE=ORACLE \
    -e DB_USERNAME=bmt_db_user \
    -e DB_PASSWORD=bmt_db_user_password \
    -v path/to/Oracle/packages/ojdbc8-19.7.0.0.jar:/usr/local/ojdbc.jar \
    -v path/to/Oracle/packages/orai18n-19.7.0.0.jar:/usr/local/orai18n.jar \
    -d \
    hub.chemaxon.com/cxn-docker-release/chemaxon/biotoolkit:21.1.0-0.15.0-4f26aeaf \
    java -cp /usr/local/bioreg-app.jar:/usr/local/ojdbc.jar:/usr/local/orai18n.jar org.springframework.boot.loader.JarLauncher

Running with HTTPS

docker run \
    --name=biotoolkit \
    -p 8443:8443 \
    -v /path/to/license_dir:/data/bioreg-home \
    -e CHEMAXON_LICENSE_URL=/data/bioreg-home/license.cxl \
    -e spring_profiles_active=enforce-https \
    -v /path/to/keystore_dir:/data/keystore_dir \
    -e SERVER_SSL_KEYSTORE=/data/keystore_dir/.keystore \
    -e SERVER_SSL_KEYSTOREPASSWORD=my_ssl_keystore_password \
    -d \
    hub.chemaxon.com/cxn-docker-release/chemaxon/biotoolkit:21.1.0-0.15.0-4f26aeaf

Running with custom atomic weights

You are able to calculate average molecular mass from custom atomic weights by providing molar masses in the elements.txt.

docker run \
    --name=bmt \
    -p 8080:8080 \
    -e CHEMAXON_HOME=/usr/local/chemaxon \
    -e CHEMAXON_LICENSE_URL=http://my.license.server/bmt/license.cxl \
    -e DB_URL=jdbc:mysql://my.remote.mysql.host:3306/bmt_db_name?autoReconnect=true&useUnicode=yes&characterEncoding=UTF-8 \
    -e DB_USERNAME=bmt_db_user \
    -e DB_PASSWORD=bmt_db_user_password \
    -v path/to/elements.txt:/usr/local/chemaxon/elements.txt \
    -d \
    hub.chemaxon.com/cxn-docker-release/chemaxon/biotoolkit:21.1.0-0.15.0-4f26aeaf

Running with Standardizer

Molecules can be passed through the customized list of standardization actions of Standardizer to derive the desired chemical form. Standardizer is a licensed ChemAxon product. To learn more about Standardizer click here

docker run \
    --name=bmt \
    -p 8080:8080 \
    -e CHEMAXON_HOME=/usr/local/chemaxon \
    -e CHEMAXON_LICENSE_URL=http://my.license.server/bmt/license.cxl \
    -e DB_URL=jdbc:mysql://my.remote.mysql.host:3306/bmt_db_name?autoReconnect=true&useUnicode=yes&characterEncoding=UTF-8 \
    -e DB_USERNAME=bmt_db_user \
    -e DB_PASSWORD=bmt_db_user_password \
    -v path/to/standardizerConfiguration.xml:/data/bioreg-home/standardizerConfiguration.xml \
    -d \
    hub.chemaxon.com/cxn-docker-release/chemaxon/biotoolkit:21.1.0-0.15.0-4f26aeaf