================================================================================
  Licensed to the Apache Software Foundation (ASF) under one or more
  contributor license agreements.  See the NOTICE file distributed with
  this work for additional information regarding copyright ownership.
  The ASF licenses this file to You under the Apache License, Version 2.0
  (the "License"); you may not use this file except in compliance with
  the License.  You may obtain a copy of the License at

      http://www.apache.org/licenses/LICENSE-2.0

  Unless required by applicable law or agreed to in writing, software
  distributed under the License is distributed on an "AS IS" BASIS,
  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  See the License for the specific language governing permissions and
  limitations under the License.
================================================================================

            ==========================
            Running Apache Tomcat OACC
            ==========================

Apache Tomcat OACC requires Apache Tomcat 6 and the Java 2 Standard Edition
Runtime Environment (JRE) version 5.0 or later.

==============================
Installation and Configuration
==============================

(1) Provide a working Tomcat 6

      You need a working installation of Tomcat 6 first.
      Test your installations with the provided Tomcat 6 example webapp
      and your own web applications before trying to add a cluster.

(2) Download and Install the Tomcat OACC Binary Distribution

NOTE:  As an alternative to downloading a binary distribution, you can create
your own from the Tomcat source repository, as described in "BUILDING.txt".
If you do this, the value to use for "${oacc.home}" will be the "dist"
subdirectory of your source distribution.

(2.1) Download a binary distribution of Tomcat from:

      http://tomcat.apache.org/dev/dist

      You need to choose the same minor version of OACC as your Tomcat 6 version.

(2.2) Unpack the binary distribution into a convenient location so that the
      distribution resides in its own directory (conventionally named
      "apache-tomcat-oacc-[version]").  For the purposes of the remainder of this
      document, the symbolic name "$OACC_HOME" is used to refer to the full
      pathname of the release directory.

(2.3) Add the file $OACC_HOME/lib/apache-tomcat-oacc.jar to the definition of
      "common.loader" in the file conf/catalina.properties contained in your
      CATALINA_BASE resp. CATALINA_HOME.

(2.4) If you need to use the SingleSignOn authenticator together with OACC,
      you also need to add $OACC_HOME/lib/apache-tomcat-sso.jar to the common.loader.
      It is important to add this jar file before the other entries in common.loader.

      We don't recommend the use of SingleSignOn in combination with clustering,
      because some use cases will not work the way you expect them to.

(2.5) Add a "Cluster" configuration element to your server.xml. The syntax is exactly
      the same, as for the Cluster element in Tomcat 5.5. Do not use the syntax for
      Tomcat 6 clustering. All cluster configuration options from Tomcat 5.5 should
      work without any change with OACC.

      You need to ensure, that you have set the "className" in the "Cluster" element
      explicitely to "org.apache.catalina.cluster.tcp.SimpleTcpCluster".

      You don't need to uninstall Tomcat 6 default cluster if you like to
      use OACC. We don't support mixed use of OACC and Tomcat 6 default cluster
      in the same Tomcat instance though.

(2.6) Read the docs contained in $OACC_HOME/docs.

(3) Testing

(3.1) Start up Tomcat on all cluster nodes.

(3.2) Test JSP

      ...