5. Installing Apache Tomcat

The AccuRev® Web Interface (Web UI) requires Apache Tomcat version 5.5 or higher to be installed on the same machine as the Web UI. Tomcat version 6.0 is installed with AccuRev.

Use the procedures described in this chapter to install Tomcat version 5.5 manually.

Setting Up the Java Environment

Tomcat requires a Java Runtime Environment (JRE) from J2SE version 6 or later.

To install and set up a JRE on the target machine:

1.	Download the Java 2 Standard Edition JRE 6, from http://www.oracle.com/technetwork/java/javase/downloads/index.html.

2.	Install the JRE on the target machine according to the instructions in the download package.

3.	Set an environment variable named jre_home to the directory into which you installed the JRE. The default installation locations are:

•	(Windows users) C:\Program Files\Java\<JRE_version>, for example

•	(Linux users) <JRE_version> in the directory where the JRE self-extracting binary was run.

4.	Append jre_home/bin to the path environment variable.

Note: You can use the full Java Development Kit (JDK) rather than just the JRE. In this case, set the java_home environment variable (not jre_home) to the directory into which you installed the JDK, and append java_home/bin to the path environment variable.

Installing Apache Tomcat

To install Tomcat, download an Apache Tomcat 5.5 installer from http://tomcat.apache.org/download-55.cgi. Follow the instructions in http://tomcat.apache.org/tomcat-5.5-doc/setup.html to complete the installation.

Considerations for Windows Users

If you are installing Tomcat on a Windows machine, consider the following:

•	Installing a Windows service. During Tomcat installation, select the Service Startup box under Tomcat on the Choose Components pane. This option automatically installs and runs the Windows service to control Tomcat.

•

Running the Tomcat service. After installing Tomcat on Windows, ensure that the Tomcat service is not running as the Local System account. Right-click on the Tomcat icon in the System Tray, and choose Configure from the menu. On the Log on tab, specify a user name and password to log on as, and click OK to save the changes.

Running Tomcat Automatically on Startup

Because the Web UI requires Tomcat, consider setting Tomcat to run automatically on startup:

•

(Windows users) Configure the Tomcat service to start automatically using the Services control panel. You can access the Services control panel from the Start menu by choosing Settings > Control Panel > Administrative Tools > Services, for example. (Specific procedures vary based on Windows operating system.)

•	(Linux users) Add the following line to /etc/rc.d/rc.local:

<CATALINA_HOME>/bin/startup.sh &

where <CATALINA_HOME> is the Tomcat installation directory.