Merge branch 'develop' of https://github.com/vivo-project/VIVO into develop
This commit is contained in:
tworrall
commit
002cdb7a51
1 changed files with 30 additions and 41 deletions
|
|
@ -3,7 +3,7 @@
|
||||||
<head>
|
<head>
|
||||||
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
|
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
|
||||||
<meta charset="utf-8">
|
<meta charset="utf-8">
|
||||||
<title>VIVO Release V1.5 Installation Guide</title>
|
<title>VIVO Release V1.6 Installation Guide</title>
|
||||||
<link rel="stylesheet" href="./css/doc.css" media="screen">
|
<link rel="stylesheet" href="./css/doc.css" media="screen">
|
||||||
</head>
|
</head>
|
||||||
<body>
|
<body>
|
||||||
|
|
@ -12,7 +12,7 @@
|
||||||
</div>
|
</div>
|
||||||
<!-- Start of content -->
|
<!-- Start of content -->
|
||||||
<div id="wrapper-content" role="main">
|
<div id="wrapper-content" role="main">
|
||||||
<h1>VIVO Release V1.5 Installation Guide</h1>
|
<h1>VIVO Release V1.6 Installation Guide</h1>
|
||||||
<div>
|
<div>
|
||||||
June 30, 2012
|
June 30, 2012
|
||||||
</div>
|
</div>
|
||||||
|
|
@ -20,7 +20,7 @@
|
||||||
<p>
|
<p>
|
||||||
This document is a summary of the VIVO installation
|
This document is a summary of the VIVO installation
|
||||||
process. For information about this release, consult
|
process. For information about this release, consult
|
||||||
the <a href="release.html">VIVO v1.5 Release
|
the <a href="release.html">VIVO v1.6 Release
|
||||||
Announcement</a>. This and other documentation can be found on
|
Announcement</a>. This and other documentation can be found on
|
||||||
the <a href="http://vivoweb.org/support">support
|
the <a href="http://vivoweb.org/support">support
|
||||||
page</a> at <a href="http://vivoweb.org">VIVOweb.org</a>.
|
page</a> at <a href="http://vivoweb.org">VIVOweb.org</a>.
|
||||||
|
|
@ -125,7 +125,7 @@
|
||||||
using "Contact Us" form)</a>
|
using "Contact Us" form)</a>
|
||||||
</li>
|
</li>
|
||||||
<li>
|
<li>
|
||||||
<a href="#tomcat_connector">Setup Apache Tomcat Connector</a>
|
<a href="#httpd">Set up Apache HTTPD</a>
|
||||||
</li>
|
</li>
|
||||||
<li>
|
<li>
|
||||||
<a href="#external_auth">Using an External Authentication
|
<a href="#external_auth">Using an External Authentication
|
||||||
|
|
@ -222,8 +222,8 @@
|
||||||
<br>
|
<br>
|
||||||
</h3>
|
</h3>
|
||||||
<p>
|
<p>
|
||||||
Download the VIVO application source as either <code>rel-1.5.zip</code>
|
Download the VIVO application source as either <code>rel-1.6.zip</code>
|
||||||
or <code>rel-1.5.gz</code>
|
or <code>rel-1.6.gz</code>
|
||||||
file and unpack it on your web server:
|
file and unpack it on your web server:
|
||||||
<br>
|
<br>
|
||||||
<a href="http://vivoweb.org/download">http://vivoweb.org/download</a>
|
<a href="http://vivoweb.org/download">http://vivoweb.org/download</a>
|
||||||
|
|
@ -963,7 +963,7 @@
|
||||||
from the overridden context fragment.
|
from the overridden context fragment.
|
||||||
</p>
|
</p>
|
||||||
<p>
|
<p>
|
||||||
See <a href="#tomcat_connector">Step 11</a> below,
|
See <a href="#httpd">Step 11</a> below,
|
||||||
for an example of overriding the VIVO context fragment.
|
for an example of overriding the VIVO context fragment.
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
|
|
@ -1059,44 +1059,23 @@
|
||||||
provide an email address in this step, your users will receive a java
|
provide an email address in this step, your users will receive a java
|
||||||
error in the interface.
|
error in the interface.
|
||||||
</p>
|
</p>
|
||||||
<h3 id="tomcat_connector">11. Set up Apache Tomcat Connector </h3>
|
<h3 id="httpd">11. Set up HTTPD </h3>
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
It is recommended that a Tomcat Connector such as mod_jk be used to
|
It is recommended to run an Apache HTTPD web server to accept requests
|
||||||
ensure that the site address does not include the port number (e.g.
|
and then proxy them to the VIVO Tomcat context. This will make Vitro
|
||||||
8080) and an additional reference to the Tomcat context name (e.g.
|
available at "http://example.com" instead of "http://example.com:8080/vitro".
|
||||||
/vivo).
|
It will also allow the use of external authentication.
|
||||||
</p>
|
</p>
|
||||||
<p>
|
<p>
|
||||||
This will make VIVO available at "http://example.com" instead of
|
Setup HTTPD to send all of the requests that it receives to Tomcat's AJP
|
||||||
"http://example.com:8080/vivo"
|
connector. This can be done in HTTPD 2.x with a simple directive in httpd.conf:
|
||||||
</p>
|
</p>
|
||||||
|
<pre> ProxyPass / ajp://localhost:8009/ <br><br></pre>
|
||||||
<p>
|
<p>
|
||||||
Using the mod_jk connector allows for communication between Tomcat
|
Modify the <Host> in Tomcat server.xml (located in <code>[tomcat root]/conf/</code>)
|
||||||
and the primary web server. The <a href="http://tomcat.apache.org/connectors-doc/generic_howto/quick.html">Quick
|
so that the context path is empty to allow VIVO to be servred from the root path.
|
||||||
Start
|
Locate the <code><Host name="localhost"...></code> directive and update as follows:
|
||||||
HowTo</a>
|
|
||||||
on the Apache site describes the minimum server
|
|
||||||
configurations for several popular web servers.
|
|
||||||
</p>
|
|
||||||
<p>
|
|
||||||
After setting up the mod_jk connector above, you will need to
|
|
||||||
modify the Tomcat's server.xml (located in <code>[tomcat root]/conf/</code>)
|
|
||||||
to
|
|
||||||
respond
|
|
||||||
to
|
|
||||||
requests from Apache via the connector. Look for the
|
|
||||||
<connector> directive and add the following properties:
|
|
||||||
</p>
|
|
||||||
<pre> connectionTimeout="20000" maxThreads="320" keepAliveTimeout="20000" <br> </pre>
|
|
||||||
<p>
|
|
||||||
Note: the value for maxThreads (320) is equal to the value for
|
|
||||||
MaxClients in the apache's <code>httpd.conf</code>
|
|
||||||
file.
|
|
||||||
</p>
|
|
||||||
<p>
|
|
||||||
Locate the <code><Host name="localhost"...></code>
|
|
||||||
directive
|
|
||||||
and update as follows:
|
|
||||||
</p>
|
</p>
|
||||||
<pre> <Host name="localhost" appBase="webapps"
|
<pre> <Host name="localhost" appBase="webapps"
|
||||||
DeployOnStartup="false"
|
DeployOnStartup="false"
|
||||||
|
|
@ -1106,7 +1085,7 @@
|
||||||
<Alias>example.com</Alias>
|
<Alias>example.com</Alias>
|
||||||
|
|
||||||
<Context path=""
|
<Context path=""
|
||||||
docBase="/usr/local/tomcat/webapps/vivo"
|
docBase="/usr/local/tomcat/webapps/vitro"
|
||||||
reloadable="true"
|
reloadable="true"
|
||||||
cookies="true" >
|
cookies="true" >
|
||||||
|
|
||||||
|
|
@ -1115,6 +1094,16 @@
|
||||||
|
|
||||||
...
|
...
|
||||||
</pre>
|
</pre>
|
||||||
|
<p>
|
||||||
|
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:
|
||||||
|
</p>
|
||||||
|
<pre> connectionTimeout="20000" maxThreads="320" keepAliveTimeout="20000" <br><br></pre>
|
||||||
|
<p>
|
||||||
|
Note: the value for maxThreads (320) is equal or greater than the value for
|
||||||
|
MaxClients in the apache's <code>httpd.conf</code> file.
|
||||||
|
</p>
|
||||||
|
|
||||||
<h3 id="external_auth">12. Using an External Authentication System
|
<h3 id="external_auth">12. Using an External Authentication System
|
||||||
with VIVO </h3>
|
with VIVO </h3>
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue