Installing and Preparing the Apache Tomcat Web Server

The ECC runs on a Apache Tomcat web server, an open source software. You need to download and install it, and then configure it to handle the ECC installation package.

After making sure that you've installed the correct version of Java, you are ready to install the Tomcat web server.

Steps...

1. Check the Automic Compatibility Checker to see which version of Tomcat you need.
2. Go to the Tomcat homepage and then download and install the required version. You will find the installation instructions and other relevant information on their homepage.

   http://tomcat.apache.org/index.html

   For Windows: Download the package called "32-bit/64-bit Windows Service Installer." This will install Tomcat and a Windows service for it.

3. To improve performance on browsers with poor connections, adapt your Tomcat configuration so that Tomcat uses the NIO2 connector and the upload timeout attribute is enabled.

   To do this, open the <Tomcat>/conf/server.xml file and edit it as follows:

   Before:

   <Connector port="8080" protocol="HTTP/1.1"

        connectionTimeout="20000"

        redirectPort="8443" />

   After:

   <Connector port="8080" protocol="org.apache.coyote.http11.Http11NioProtocol"

        connectionTimeout="20000"

        redirectPort="8443"

        disableUploadTimeout="false"

        connectionUploadTimeout="10000"/>

   For complete information about the Tomcat connector configuration attributes, see https://tomcat.apache.org/tomcat-7.0-doc/config/http.html.

4. Increase the memory that Tomcat can allocate to ECC to the amount described in the table that follows..

   Reason: By default Tomcat allocates a low amount of memory to an application. This is not sufficient for ECC, which keeps a lot of UI state data in memory.

   Memory Parameter	Amount to Allocate
   Heap size	As much as possible (at the very least 2GB)

   On Windows: 

   1. Go to the "bin" folder in your Tomcat installation (...Apache Software Foundation\Tomcat 7.0\bin).
   2. Right-click the file tomcat7w.exe and from the context menu select Run as administrator.
   3. On the Java tab Set the heap size by setting the Maximum memory pool to the maximum possible on your system, for example 8192MB, as shown here:

      

   On Linux: In the CATALINA_OPTS environment variable, set the permGen size to 256MB and the heap space to the maximum possible on your system. In this example, the heap space is set to 8192MB.

5. Make sure that Tomcat automatically starts when you start the server that it is installed on, for example, with a Windows service or an init script.
6. Start Tomcat.

Important: If you want to be able to log into more than one ECC instance on the same Tomcat installation, you have to complete additional setup steps. For information, see Running Multiple ECC Instances on One Tomcat Server.