Installing Licenses on Servers

The possible ways of installing licenses on a server (web applications e.g. JSP pages, Pipeline Pilot):

1. Using system variables (recommended):
   The location of the license file can be set with:

   • CHEMAXON_LICENSE_URL environment variable (help on setting environment variables)

   • chemaxon.license.url Java system property

   From version 5.3.2 it is possible to define multiple license files of arbitrary locations. The separator character is ";".
   In case license files are set this way, the license files will be read from all locations defined by the environment variable, the Java system property and from the user's home directory.
   Example: -Dchemaxon.license.url="C:\ChemAxon\license2009.cxl;C:\ChemAxon\license2010.cxl"

2. Manual install:
   The license file must be stored on the server, in the .chemaxon (Unix) or chemaxon (Windows) sub-directory under the home directory of the user who started JChem Server. The following locations are accepted:

   • (.)chemaxon/license.cxl (the license file name is fix)

   • (.)chemaxon/licenses/*.cxl (from version 5.3.2 only - the license file can have arbitrary name, the extension is fix)

3. Command line install:
   Launch the license shell script (Unix) or license.bat batch file (Windows).
   Type license -h for the list of available options.

4. Using API:
   chemaxon.license.LicenseManager.setLicenseFile(String path)
   chemaxon.license.LicenseManager.setLicense(String s)

If the licenses are installed later, when a web application is already running, it is not necessary to restart the web server (e.g. Tomcat), the License Manager will automatically and repeatedly check if a license file was installed in the meanwhile