Skip to main content
Skip table of contents

Apache Tomcat 8.0 - Cantara Agent Installation

It is not the intention of this documentation to document Tomcat, this documentation assumes that your technical team has experience working on Tomcat. However, you can refresh your Tomcat knowledge by reading below links:

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

  • Have an existing Tomcat Server instance or have created a server instance that meets the Cantara Server 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.
  • Rename the Cantara Agent application .ZIP archive file to agent.war.
  • Copy the required Oracle EnterpriseOne JD Edwards libraries into the jde folder that was created as part of setting up the file system folders.
To deploy an instance of the Cantara Agent
  1. Ensure that the prerequisite JAR libraries are loaded into $CATALINA_HOME/lib

    1. javax.mail.jar available at
    2. xercesImpl.jar available at
  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 agent.xml

    <?xml version="1.0" encoding="UTF-8"?>
    <Context path="/agent" docBase="/u01/rinami/agent/webapps/agent.war">
      <Manager pathname="" />
      <Resources className="org.apache.catalina.webresources.StandardRoot">
            <PreResources className="org.apache.catalina.webresources.DirResourceSet"
                webAppMount="/WEB-INF/lib" />
    		<PreResources className="org.apache.catalina.webresources.DirResourceSet"
    			webAppMount="/WEB-INF/classes" />
  3. Create an etc folder for example /u01/rinami/etc/ 
  4. In the tomcat /bin folder locate the setenv file (Linux this will be and windows setenv.bat, add a new java property to the file.

    setenv Example

  5. Start the Apache Tomcat instance.
  6. 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.