Skip to main content

Apache Tomcat 8.0 - Cantara Server Installation

Make sure you have done the following before deploying the Cantara Server:

To deploy an instance of the Cantara Server
  1. Ensure that the prerequisite JAR libraries are loaded into $CATALINA_HOME/lib

    1. javax.mail.jar available at https://java.net/projects/javamail/pages/Home#Download_JavaMail_Release
    2. xercesImpl.jar available at http://xerces.apache.org/mirrors.cgi
  2. Create the context definition xml file in $CATALINA_HOME/conf/Catalina/localhost, this file should be have the same name as the desired context for the application. Below is an example context file for Enterprise Edition with a Oracle MySQL database.

    Example Context cantara.xml

    XML
    <?xml version="1.0" encoding="UTF-8"?>
    <Context path="/cantara" docBase="/u01/rinami/cantara.war">
      <Manager pathname="" />
      <Resource auth="Container"
                driverClassName="com.mysql.jdbc.Driver" 
                maxTotal="100" 
                maxIdle="30" 
                maxWaitMillis="10000"
                name="jdbc/Cantara"
                password="cantara" 
                type="javax.sql.DataSource" 
                url="jdbc:mysql://mysql.rinami.com:3306/Cantara42" 
                username="cantara"/>
      <Resource auth="Container" 
                mail.debug="false" 
                mail.smtp.auth="false" 
                mail.smtp.host="smtp.rinami.com" 
                mail.transport.protocol="smtp" 
                name="mail/Cantara"
                global="mail/Cantara"
                type="javax.mail.Session"/>
    </Context>
  3. Start the Apache Tomcat instance.
  4. If the deployment is successful, you should see the Cantara Access Server in the list of applications with its running state set to true. If the deployment fails to start, check the appropriate Tomcat logs for deployment errors.

Validate Deployment

If you open a browser window to the base URL of the Cantara Access Server deployment you can confirm that the deployment has completed successfully.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.