You are here

Installing the Tomcat application server

Install an instance of Tomcat 7 manually and modify it to use the correct directory structure and files for Alfresco Content Services.
These instructions recommend that you name the required directories as shared/classes and shared/lib because these are the path names used within full Alfresco Content Services installations. You can substitute alternative names for these directories. The installation directory for Tomcat is represented as <TOMCAT_HOME>.
  1. Download and install Tomcat version 7 following the instructions from http://tomcat.apache.org.
  2. Create the directories required for an Alfresco Content Services installation:
    1. Create the shared/classes directory.
    2. Create the shared/lib directory.
  3. Open the <TOMCAT_HOME>/conf/catalina.properties file.
  4. Change the value of the shared.loader= property to the following:

    shared.loader=${catalina.base}/shared/classes,${catalina.base}/shared/lib/*.jar

    Note: If you have used alternative names for the directories, you must specify these names in the shared.loader property.
  5. Copy the JDBC drivers for the database you are using to the lib/ directory.
  6. Edit the <TOMCAT_HOME>/conf/server.xml file.
  7. Set attributes of HTTP connectors.

    Tomcat uses ISO-8859-1 character encoding when decoding URLs that are received from a browser. This can cause problems when creating, uploading, and renaming files with international characters.

    By default, Tomcat uses an 8 KB header buffer size, which might not be large enough for Kerberos and NTLM authentication protocols.

    Locate the Connector sections, and then add the URIEncoding, scheme, secure, and maxHttpHeaderSize properties.

    <Connector port="8080"
    protocol="HTTP/1.1"
    URIEncoding="UTF-8"
    connectionTimeout="20000"
    scheme="https"
    secure="true"
    redirectPort="8443"
    maxHttpHeaderSize="32768"/>

    Use the above configuration when using a proxy that does SSL encryption and communicates via HTTP. Alternatively, you can use the following configuration:

    <Connector port="8080"
    protocol="HTTP/1.1"
    connectionTimeout="20000"
    redirectPort="8443" />

    If you use this configuration, HTTP will not work and you will not be able to upload the Alfresco license via the Admin Console.

  8. Save the server.xml file.

Sending feedback to the Alfresco documentation team

You don't appear to have JavaScript enabled in your browser. With JavaScript enabled, you can provide feedback to us using our simple form. Here are some instructions on how to enable JavaScript in your web browser.