litvinovg/vitro
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

NIHVIVO-3278 Add a note to the VIVO and Vitro install docs telling how to set URIencoding to permit searching on international characters.

Browse source
This commit is contained in:
j2blake 2011-11-23 16:04:51 +00:00
parent 4a29dde5e6
commit 777d10ba04
1 changed files with 26 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

31
doc/install.html
View file

@ -186,8 +186,7 @@
<a href="#deploy">Compile and deploy</a> <a href="#deploy">Compile and deploy</a>
</li> </li>
<li> <li>
<a href="#tomcat_settings">Set Tomcat JVM parameters and <a href="#tomcat_settings">Configure Tomcat</a>
security limits</a>
</li> </li>
<li> <li>
<a href="#start_tomcat">Start Tomcat</a> <a href="#start_tomcat">Start Tomcat</a>
@ -649,8 +648,8 @@
<p> <p>
to build Vitro and deploy to Tomcat's webapps directory. to build Vitro and deploy to Tomcat's webapps directory.
</p> </p>
<h3 id="tomcat_settings">VI. Set Tomcat JVM parameters and security <h3 id="tomcat_settings">VI. Configure Tomcat</h3>
limits</h3> <h4>Set JVM parameters</h4>
<p> <p>
Vitro copies small sections of your RDF database into Vitro copies small sections of your RDF database into
memory in order to serve Web requests quickly (the in-memory copy and memory in order to serve Web requests quickly (the in-memory copy and
@ -675,13 +674,35 @@
If an OutOfMemoryError is encountered during Vitro execution, it can If an OutOfMemoryError is encountered during Vitro execution, it can
be remedied by increasing the heap parameters and restarting Tomcat. be remedied by increasing the heap parameters and restarting Tomcat.
</p> </p>
<h4>Set security limits</h4>
<p> <p>
Security limits: Vitro is a multithreaded web application that may Vitro is a multithreaded web application that may
require more threads than are permitted under your Linux installation's require more threads than are permitted under your Linux installation's
default configuration. Ensure that your installation can support the default configuration. Ensure that your installation can support the
required number of threads by making the following edits to <code>/etc/security/limits.conf</code>: required number of threads by making the following edits to <code>/etc/security/limits.conf</code>:
</p> </p>
<pre> apache hard nproc 400<br> tomcat6 hard nproc 1500 <br> </pre> <pre> apache hard nproc 400<br> tomcat6 hard nproc 1500 <br> </pre>
<h4>Set URI encoding</h4>
<p>
In order for Solr to correctly search for international characters (>127),
you must configure Tomcat to conform to the URI standard by
accepting percent-encoded UTF-8.
</p>
<p>
Edit Tomcat's conf/server.xml and add the following attribute to each of the
Connector elements: URIEncoding="UTF-8".
<pre>
&lt;Server ...>
&lt;Service ...>
&lt;Connector ... URIEncoding="UTF-8"/>
...
&lt;/Connector>
&lt;/Service>
&lt;/Server>
</pre>
</p>
<p>
<h3 id="start_tomcat">VII. Start Tomcat </h3> <h3 id="start_tomcat">VII. Start Tomcat </h3>
<p> <p>
Most Tomcat installations can be started by running <code>startup.sh</code> Most Tomcat installations can be started by running <code>startup.sh</code>