Compound Registration Installation requirements

You need three things to check, before starting to install Compound Registration: minimum system requirements, existence of a home directory and if the database is properly set up.

1. Environment

It is assumed that the application server is properly set up with a compatible version of the operating system, Java environment, and Apache Tomcat. Please make sure your system meets the minimum requirements to run Compound Registration.

2. Compound Registration home directory

Home directory must be set up using the environment variable REGISTRYCXN_HOME. Since CompReg version 17.06.12-1738 e xterna l resources of the registration system will be loaded from the home directory of the application.

Home directory must be an existing directory with read and write access rights. In case the home directory is not provided - or not meeting the requirements above - the application will start, but the user interface will display an error related to invalid application state. The l og will contain the error entry of the exact problem related to the home directory settings. You can specify any location on the disk, but please be sure to specify an absolute path. If Tomcat was running while you defined the environment variable, a restart might be required.

How to set up the environment variable?

Run the Command Prompt as Administrator and type the following:

On Unix based systems: export REGISTRYCXN_HOME=/Users/johndoe/.chemaxon

On Window based systems: setx -M REGISTRYCXN_HOME "C:\path\to\any\directory"

To make sure that the environment variable properly set up restart Command Prompt and type: echo %REGISTRYCXN_HOME% (Windows) or echo $REGISTRYCXN_HOME (Unix). If everything has been entered correctly the previously typed pathway will be displayed.

License files

This step is just optional. In the following, you will have the opportunity to upload the suitable license file.


License files
must be located under the directory $REGISTRYCXN_HOME/licenses . In the case of a missing license file, the logs will contain the error of the problem, and the user interface of the application will display an error upon user login.

Since version 17.10.30-2159:

You can also set a license file via URL with the $CHEMAXON_LICENSE_URL environment variable, but you have to make sure, in this case, $REGISTRYCXN_HOME/licenses is empty:

On Unix based systems: export CHEMAXON_LICENSE_URL=http://my.url.com/license.cxl

On Window based systems: setx -M CHEMAXON_LICENSE_URL "http://my.url.com/license.cxl"

In this case, you have to manage the license on the referenced URL. You cannot upload a new license from the UI (Neither from the install wizard, nor from the admin page).


Application properties

Optionally the property file that the application uses can be located at $REGISTRYCXN_HOME/config/registry.properties

3. Database

Prior to starting the application itself, an empty Oracle or MySQL database schema has to be created. A proper database user account has to be created with the appropriate privileges to be able to create, alter tables, indexes, sequences, etc. For the detailed description please visit this page.