This section describes how to install an instance of Tomcat manually and modify it to use
the correct directory structure and files for SkyVault.
The installation directory for Tomcat is referred to as
<TOMCAT-HOME>.
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.
-
Download Tomcat from http://tomcat.apache.org.
See the SkyVault Supported Platforms page for the correct version to download.
- Install Tomcat following the instructions included in the release.
-
Create the directories required for a SkyVault installation:
- Create the shared/classes directory.
- Create the shared/lib directory.
- Edit the <TOMCAT-HOME>/conf/catalina.properties file.
-
Change the value of the shared.loader= property
to the following:
shared.loader=${catalina.base}/shared/classes
Note: If you have used alternative names for the directories, you must specify these names in the shared.loader property. - Save the catalina.properties file.
-
Copy the JDBC drivers for the database you are using to:
lib/
- Edit the <TOMCAT_HOME>/conf/server.xml file.
-
Set attributes of HTTP connectors.
By default, Tomcat uses ISO-8859-1 character encoding when decoding URLs that are received from a browser. This may cause problems when creating, uploading, and renaming files with international characters.
By default, Tomcat uses an 8K header buffer size, which may not be large enough for Kerberos and NTLM authentication protocols.
Locate the Connector sections, and then add the URIEncoding="UTF-8" and maxHttpHeaderSize="32768" properties.
<Connector port="8080" protocol="HTTP/1.1" URIEncoding="UTF-8" connectionTimeout="20000" redirectPort="8443" maxHttpHeaderSize="32768"/>
- Save the server.xml file.
-
There is an issue with SkyVault Share
document downloads on Tomcat with https (SSL) for Internet Explorer versions 7 and 8. On
IE7 and IE8, you will see an error message if you try to download a document from SkyVault Share in
Tomcat with https (SSL) enabled. To resolve this issue:
- Edit the <TOMCAT-HOME>/conf/context.xml file.
-
Add the following line to the context element:
<Valve className="org.apache.catalina.authenticator.SSLAuthenticator" securePagesWithPragma="false" />
- Save the <TOMCAT-HOME>/conf/context.xml file.