MacOS X / UNIX / Linux Installation

Back - Windows Installation Up - Test Pilot v3 Next - Authoring

Java

Installation of Test Pilot's web server component under UNIX requires that the server, and the server alone, have a Java Virtual Machine installed. Java 1.1.8 or better is required. Java is available free from Sun at:

http://www.javasoft.com/

The Distribution

There are a number of files and folders included with this distribution. Here is a short description of them:

License - Test Pilot 3 - Our software license agreement. You must agree to the terms of the agreement or return the software unused.

License - Tomcat 3.2.4 - Test Pilot requires a web server to operate. Included in this distribution is a fully configured copy of the Apache organization's Tomcat software for web services. It is an open source freely distributable 100% Java web server. Its license information is in this file.

apache - This directory contais a file and a directory. The file show typical additions necessary for linking Apache to Tomcat for the handling of Test Pilot transactions.

httpd.conf_additions - these are madifications to a standard Apache httpd.conf file.

jserv - this is the source of the Apache module for communicating with Tomcat.

bin/startup, bin/shutdown - These are shell scripts that start and stop Tomcat and Test Pilot together.

lib - This is a folder containing Java programming libraries used by Tomcat and Test Pilot. Additions to the standard Tomcat distribution have been the inclusion of Test Pilot. Updating Test Pilot as newer versions are released is as simple as replacing the single TestPilot3.jar file located in this directory.

logs - This is a folder containing the log files generated by Tomcat. Errors, if they occur, will appear in the tomcat.log file in this folder.

work - This is a folder containing temporary files and directories generated by Tomcat.

conf - This is a folder containing the configuration files used by Tomcat. The only modifications from the standard Tomcat distribution have been made to the server.xml file for the purposes of running Test Pilot. The file MUST be modified to reflect the Apache document root directory in two places near the end of the file.

for_DOCUMENT_ROOT - These should be copied to the Apache document root directory. Care should be taken with the WEB-INF directory. It is in that directory that the Test Pilot program's configuration is stored. Specifically:

for_DOCUMENT_ROOT/WEB-INF/web.xml - This is a file that instructs Tomcat how to configure and run Test Pilot. This file must be edited during installation to set up some important Test Pilot settings.

Configuring Apache

Copy the WEB-INF directory from the for_DOCUMENT_ROOT directory of the distribution to Apache's DocumentRoot directory.

Compile and add the mod_jserv module in the apache/jserv directory of the distribution as described in that directory's README file.

Modify Apache's httpd.conf file as described in the distribution's apache/httpd.conf_additions file.

Restart Apache.

Configuring Tomcat

As noted before, you must edit the conf/server.xml configuration file to use Test Pilot. Specifically you must make some substitutions:

APACHE_DOCUMENT_ROOT_GOES_HERE - should be changed to the directory used by Apache as its document root. This is the same directory where you would have copied the WEB_INF directory mentioned above.

Configuring Test Pilot

As noted before, you must edit the for_DOCUMENT_ROOT/WEB-INF/web.xml configuration file to use Test Pilot. Specifically you must make some substitutions:

SERIAL_NUMBER_GOES_HERE - should be changed to the Test Pilot serial number you receive when you purchase Test Pilot. Without a serial number, Test Pilot will periodically cease to function.

ADMIN_PASSWORD_GOES_HERE - should be changed to the password you wish to use when creating new assessments. On Windows servers, this is not used.

SMTP_SERVER_NAME_GOES_HERE - should be changed to a valid Internet SMTP mail server should you wish to use Test Pilot's built-in e-mailing functions.

Web services from Tomcat are by default set up to use port 8080 to prevent conflict with other web server software. To access the Tomcat home page with a browser on the same computer as Tomcat, use the following URL:

http://localhost:8080/

To access a Test Pilot login screen with a browser on the same computer as Tomcat, use:

http://localhost:8080/servlet/TestPilot3/

To access the Tomcat/Test Pilot services from an outside computer, it will be necessary for you to know your computer's IP address or Internet name (usually found on the TCP/IP Control Panel). For example, if your IP address was 128.210.86.32, then you would access the server as:

http://128.210.86.32:8080/

If you knew that the Internet name of your computer was bogus.server.edu then you could use a URL as follows:

http://bogus.server.edu:8080/

If you are not running any other web services on the Tomcat/Test Pilot server, you can eliminate the need to type ":8080" by setting Tomcat's service port to 80. You accomplish this by editing the conf/server.xml file. Look for the following lines:

<Parameter name="port"
value="8080"/>

change them to:

<Parameter name="port"
value="80"/>

If you are running Apache and have mod_jserv configured to hand off test Pilot requests to Tomcat, then you have no need for Tomcat's conventional web services and can safely remove or comment out the entire 8080 port entry shown below:

<Connector className="org.apache.tomcat.service.PoolTcpConnector">
<Parameter name="handler"
value="org.apache.tomcat.service.http.HttpConnectionHandler"/>
<Parameter name="port"
value="8080"/>
</Connector>

http://server.edu:8080/servlet/TestPilot3/

You should receive a Test Pilot login screen.