4 Installing the ADL Webclient

---

This chapter describes how to install the ADL Webclient on Windows and UNIX operating systems.

Installation

Install the following software:
Java 2 Platform, Standard Edition v1.4.1 (J2SE), see http://java.sun.com/j2se/1.4.1/download.html.
Apache Tomcat server 4.1.24 or higher, see http://jakarta.apache.org/site/binindex.cgi.
Set the following environment variables:
JAVA_HOME to the directory in which Java is installed.
CATALINA_HOME to the directory in which Tomcat is installed.
Set PATH=%PATH%;%JAVA_HOME%\bin;%ANT_HOME%\bin
Download mw_version_number_wc.war
Copy mw_version_number_wc.war to the [tomcat]\webapps directory.

Note Windows may append .zip to the downloaded .war file. Be sure to delete the .zip extension.

Start the Tomcat server.

Tomcat automatically expands the war file and places the files in a directory called mw_version_number_wc.

Use the Tomcat Manager to stop the application (mw_version_number_wc).
Edit [tomcat]\webapps\mw_version_number_wc\javascript\domain.js by changing the document.domain statement to point to your domain.

document.domain="YOUR_DOMAIN_NAME"; 

Edit [tomcat]\webapps\mw_version_number_wc\WEB-INF\config\webclient.conf by changing the WEBAPP_URL statement to point to the machine with Tomcat installed:

WEBAPP_URL: http://YOUR_MACHINE_NAME:8080/mw_version_number_wc/ 

Use the Tomcat Manager to start the application.
Go to the URL specified in WEBAPP_URL.

This would be http://YOUR_MACHINE_NAME:8080/mw_version_number_wc/.

Alexandria Digital Library Developer's Guide