This section describes how to install an instance of Tomcat 7 manually and
modify it to use the correct directory structure and files for SkyVault.
These instructions recommend that you name the required directories as
shared/classes and shared/lib because these are
the path names used within full SkyVault installations. You can substitute alternative names
for these directories. The installation directory for Tomcat is represented as
<TOMCAT_HOME>.
- Download and install Tomcat version 7 following the instructions from http://tomcat.apache.org.
-
Create the directories required for a SkyVault installation:
- Create the shared/classes directory.
- Create the shared/lib directory.
- Open the <TOMCAT_HOME>/conf/catalina.properties file.
-
Change the value of the shared.loader= property to the
following:
shared.loader=${catalina.base}/shared/classes,${catalina.base}/shared/lib/*.jar
Note: If you have used alternative names for the directories, you must specify these names in the shared.loader property. - Copy the JDBC drivers for the database you are using to the lib/ directory.
- Edit the <TOMCAT_HOME>/conf/server.xml file.
-
Set attributes of HTTP connectors.
Tomcat uses ISO-8859-1 character encoding when decoding URLs that are received from a browser. This can cause problems when creating, uploading, and renaming files with international characters.
By default, Tomcat uses an 8 KB header buffer size, which might not be large enough for Kerberos and NTLM authentication protocols.
Locate the Connector sections, and then add the URIEncoding, scheme, secure, and maxHttpHeaderSize properties.
<Connector port="8080" protocol="HTTP/1.1" URIEncoding="UTF-8" connectionTimeout="20000" scheme="https" secure="true" redirectPort="8443" maxHttpHeaderSize="32768"/>
- Save the server.xml file.
When using Internet Explorer versions 7 and 8, if you try to download a document from
SkyVault Share running in Tomcat with https (SSL) enabled, you might see an error message. To
resolve this issue, add the following line to the context element in the
<TOMCAT_HOME>/conf/context.xml
file:
<Valve className="org.apache.catalina.authenticator.SSLAuthenticator" securePagesWithPragma="false" />