Page History

...

1. In the tomcat webapps directory, create a symbolic link called ROOT to vivo. This will redirect all requests to root to the vivo application.
   eg:

   Code Block
   cd /usr/local/tomcat/webapps rm -rf ROOT ln -s vivo ROOT ls -latr vivosolr vivo ROOT -> vivo

   
   
   

2. Modify the <Host> in Tomcat server.xml (located in [tomcat root]/conf/) so that the context path is empty to allow VIVO to be served from the root path. Locate the <Host name="localhost"...> directive and update as follows:

<Host name="localhost" appBase="webapps"
        DeployOnStartup="false"
        unpackWARs="true" autoDeploy="false"
        xmlValidation="false" xmlNamespaceAware="false">
                  
    <Alias>example.com</Alias>
                   
        <Context path=""
                docBase="/usr/local/tomcat/webapps/vitro"
                reloadable="true"
                cookies="true" >
                   
            <Manager pathname="" />
        </Context>
                  
        ...

After setting up the above, it is recommended that you modify the Tomcat AJP connector parameters in server.xml. Look for the <connector> directive and add the following properties:

    connectionTimeout="20000" maxThreads="320" keepAliveTimeout="20000"

Note: the value for maxThreads (320) is equal or greater than the value for MaxClients in the apache's httpd.conf file.

3. in the tomcat/conf directory - create a ROOT.xml with the context element as stated above. This was suggested, but somebody needs to verify and complete this document.