Deploying the application

{info} Read this before deploying the application

Before deploying the application make sure your system fulfils the installation requirements and your database is properly configured.

Deploying to Tomcat

Follow these steps to deploy Compound Registration to Tomcat:

1. Configure Tomcat connector as needed in the server.xml within the Tomcat conf folder.

   • When Tomcat 8.5 and Internet Explorer 11 or Edge web browsers are used, the following line should be added to the context.xml:

     
     <CookieProcessor className="org.apache.tomcat.util.http.LegacyCookieProcessor" alwaysAddExpires="true" />

2. Make sure you copied the proper JDBC driver as described on this page.

3. Copy JavaMail API library (e.g. mail-1.4.7.jar) to your $TOMCAT_HOME/lib folder.

4. Firts of all, delete the build number from the downloaded .war file name, rename as RegistryCxn.war and then deploy it into the Tomcat webapps folder. In order to have the provided war file extracted in the webapps folder stop and start the Tomcat again- it will extract the war file automatically.

5. After a successful deployment, the application can be started. By default you can access the application at the following URL: http://yourhost:8080/RegistryCxn/client/.If everything went well you'll see the Compound Registration Wizard, that helps you to upload your the license file, setup your database connection and create the first user of Compound Registration.

   Notes :

   • Update user defined checker configuration files in the $HOME/.chemaxon folder with the provided ones, if needed.

   • The application property file can be adjusted to the local needs. Using this property file you can configure the authentication modes, email server settings, LDAP, Active Directory, SAML SSO, downstream databases, etc.. An example property file is located at $TOMCAT_HOME/webapps/RegistryCxn/WEB-INF/classes/registry.example.properties

Deploy and Install with Docker

{info} Download docker image

You can get our docker image from our products download page: https://chemaxon.com/products/compound-registration/download

Our image contains Compound Registration and its commandline tool also, during docker run if you provide an argument the commanline tool will run, if not Compound Registration will start.

Follow these steps to install and run Compound Registration in docker container:

1. Create an e nv.list file that contains database connection parameters: mysql_example_env.list

   
   RegDBType=MySql
   RegDBDriver=org.mariadb.jdbc.Driver
   RegDBUrl=jdbc:mysql://{REPLACE_WITH_DATABASE_URL}/{REPLACE_WITH_DATABASE_NAME}
   RegDBUser={REPLACE_WITH_USERNAME}
   RegDBPass={REPLACE_WITH_PASSWORD}
   RegDBValidationQuery=SELECT 1
   ApplicationStatus=installed

   oracle_example_env.list

   
   RegDBType=Oracle
   RegDBDriver=oracle.jdbc.driver.OracleDriver
   RegDBUrl=jdbc:oracle:thin:@{REPLACE_WITH_DATABASE_URL}/{REPLACE_WITH_DATABASE_SID_OR_SERVICE}
   RegDBUser={REPLACE_WITH_USERNAME}
   RegDBPass={REPLACE_WITH_PASSWORD}
   RegDBValidationQuery=SELECT 1 FROM DUAL
   ApplicationStatus=installed

2. Create the database schema for Compound Registration using the created evn.list:

   
   docker run --rm --env-file {REPLACE_WITH_PATH_TO_ENV_LIST} hub.chemaxon.com/cxn-docker-release/registration:{REPPLACE_WITH_VERSION} install -migrateSchema

3. Create an admin user:

   
   docker run --rm --env-file {REPLACE_WITH_PATH_TO_ENV_LIST} hub.chemaxon.com/cxn-docker-release/registration:{REPPLACE_WITH_VERSION}  create-user -name {REPLACE_WITH_USERNAME} -password {REPLACE_WITH_PASSWORD} -group SUPER

4. Add license url to the env.list file. You have serve the given cxn license via file server over http/https. You can skip this and upload the license later from the Application UI : Administrator Page, but its not recommended , due it will saved in the container and you have to re-upload if the container stops,removed and you create a new one. add to env.list

   
   CHEMAXON_LICENSE_URL={REPLACE_WITH_URL: eg. http://myserver.local/chemaxon/license.cxl}

5. Run Compound Registration

   
   docker run -p {REPLACE_WITH_DESIRED_PORT}:8080 -d --restart=unless-stopped --env-file {REPLACE_WITH_PATH_TO_ENV_LIST} hub.chemaxon.com/cxn-docker-release/registration:{REPPLACE_WITH_VERSION} 

With this 5 steps you have Compound Registration running, you can skip the "Install through the Wizard" step from the deployment guide.