Apache Tomcat 8.0 - Cantara Administration Console Installation

This documentation does not intend to document Tomcat and It is assumed that anyone following the documentation contained on this page has experience working with Tomcat. However, you can refresh your Tomcat knowledge by reading below links:

Make sure you have done the following before deploying the Cantara Administration Console:

Have an existing Tomcat Server Instance or have created a server instance that meets the Cantara Administration Console Technical Requirements.
Set up the file system folders and confirmed that the user the Tomcat Server is running as has read and write permission to these folders.
In the case of the Enterprise Edition ensure you have set up the Cantara Database. You must copy your DB Driver into $CATALINA_HOME/lib and you must also edit the Apache Tomcat context.xml file to include the JNDI resource definition for the database.
Extracted the Cantara Administration Console application archive file into the installation folder according the Installing the Cantara Administration Console Web Application instructions.

To deploy an instance of the Cantara Administration Console

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.

Example Context console.xml

console.xml

XML

<?xml version="1.0" encoding="UTF-8"?>
<Context path="/console" docBase="/u01/rinami/cantara/console/console50.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://localhost:3306/Cantara50" 
      username="cantara"/>
</Context>

In the tomcat /bin folder locate the setenv file (Linux this will be setenv.sh and windows setenv.bat, add a new java property to the file.
setenv Example

XML
```
JAVA_OPTS="-Dcantara.console.etc=/u01/rinami/cantara/console/etc"
```
Start the Apache Tomcat instance.
If the deployment is successful, you should see the Cantara Console 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.
Launch the web application to start the configuration process.