MacOS 8& 9 Installation

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

Java

Installation of Test Pilot's web server component under MacOS requires that the server first have an Apple MRJ Java Virtual Machine installed. MRJ version 2.1.4 or better running under MacOS 8 on a PowerPC Macintosh are minimal requirements. MRJ is available free from Apple at:

http://www.apple.com/java/

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.

Tomcat/Test Pilot Start - This is a MacOS Java application that starts Tomcat and Test Pilot together. It must be running in order for Test Pilot to operate. When you quit this program, Test Pilot and Tomcat stop. Thus, it should remain running when you wish test Pilot services to be available. Startup times will vary - do not be surprised if it takes up to two minutes to start Tomcat and Test Pilot. Do not be alarmed if the system appears to freeze; it will return to control after Tomcat and Test Pilot start.

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.

The use of other database will require additional libraries in the lib folder as well as some modifications to the Start program. Contact ClearLearning Support for assistance.

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.

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.

webapps - This is the Tomcat web server's home directory. This is where files and folder which will be accessible to the outside world should be stores. It is in this folder or its subfolders that Test Pilot will store its tests and results files.

Care should be taken with the WEB-INF subdirectory of the webapps folder. It is in that directory that configuration for the Test Pilot program is stored. Specifically:

webapps/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 Test Pilot

As noted before, you must edit the webapps/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 servers like Apple's personal web services and commercial web server software such as Quid Pro Quo or WebSTAR. 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"/>

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

You should receive a Test Pilot login screen.