-

VIVO Release V1.5 Installation Guide

+

VIVO Release V1.6 Installation Guide

June 30, 2012
@@ -20,7 +20,7 @@

This document is a summary of the VIVO installation process. For information about this release, consult - the VIVO v1.5 Release + the VIVO v1.6 Release Announcement. This and other documentation can be found on the support page at VIVOweb.org. @@ -125,7 +125,7 @@ using "Contact Us" form)

  • - Setup Apache Tomcat Connector + Set up Apache HTTPD
  • Using an External Authentication @@ -222,8 +222,8 @@

    - Download the VIVO application source as either rel-1.5.zip - or rel-1.5.gz + Download the VIVO application source as either rel-1.6.zip + or rel-1.6.gz file and unpack it on your web server:
    http://vivoweb.org/download @@ -963,7 +963,7 @@ from the overridden context fragment.

    - See Step 11 below, + See Step 11 below, for an example of overriding the VIVO context fragment.

    @@ -1059,44 +1059,23 @@ provide an email address in this step, your users will receive a java error in the interface.

    -

    11. Set up Apache Tomcat Connector

    +

    11. Set up HTTPD

    +

    - It is recommended that a Tomcat Connector such as mod_jk be used to - ensure that the site address does not include the port number (e.g. - 8080) and an additional reference to the Tomcat context name (e.g. - /vivo). + It is recommended to run an Apache HTTPD web server to accept requests + and then proxy them to the VIVO Tomcat context. This will make Vitro + available at "http://example.com" instead of "http://example.com:8080/vitro". + It will also allow the use of external authentication.

    - This will make VIVO available at "http://example.com" instead of - "http://example.com:8080/vivo" + Setup HTTPD to send all of the requests that it receives to Tomcat's AJP + connector. This can be done in HTTPD 2.x with a simple directive in httpd.conf:

    + 
         ProxyPass / ajp://localhost:8009/

    - Using the mod_jk connector allows for communication between Tomcat - and the primary web server. The Quick - Start - HowTo - on the Apache site describes the minimum server - configurations for several popular web servers. -

    -

    - After setting up the mod_jk connector above, you will need to - modify the Tomcat's server.xml (located in [tomcat root]/conf/) - to - respond - to - requests from Apache via the connector. Look for the - <connector> directive and add the following properties: -

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

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

    -

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

                  <Host name="localhost" appBase="webapps"
                        DeployOnStartup="false"
@@ -1106,7 +1085,7 @@
                    <Alias>example.com</Alias>
                    
                    <Context path=""
-                           docBase="/usr/local/tomcat/webapps/vivo"
+                           docBase="/usr/local/tomcat/webapps/vitro"
                            reloadable="true"
                            cookies="true" >
                    
@@ -1115,6 +1094,16 @@
                   
                    ...
    +

    + 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. +

    12. Using an External Authentication System with VIVO