Prerequisites

This distribution is designed for Mac OS X, v 10.1 or better. You must have your 10.1 web services enabled in the Sharing System preferences.

You must have installed one of our supported database programs. A database for Test Pilot must have been created. An account and password for use in accessing the database must also have been created. The database type, the name of the database created for Test Pilot, the account name and the password must all be known prior to installing Test Pilot.

• MySQL - a free database engine for many operating systems
  
  
• OpenBase - a commercial database engine.

The MacOS Installer performs most of the configuration of Test Pilot Enterprise. The information below is to assist in manual configuration of Test Pilot should that be necessary.

The Distribution

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

WEB-INF - This is the embedded Tomcat web server's home directory. This is where Test Pilot and all its configuration information is stored. It is also where the files necessary to start and stop the embedded Tomcat server are located. This will be placed by the installer in your /Library/WebServer/Documents directory.

WEB-INF/lib/TestPilot4.jar - This is the Test Pilot distribution. When upgrading to a new release, it is this file ALONE which should be replaced.

WEB-INF/Licenses/LICENSE.TXT - Our software license agreement. You must agree to the terms of the agreement or return the software unused.

WEB-INF/Licenses/TOMCAT.TXT - this Test Pilot distribution uses an embedded copy of the Apache Software Foundation's (ASF) Tomcat web application server. This file is the license from ASF for Tomcat. The embedded version in this distribution is 4.1.24.

WEB-INF/logs - This is a folder containing the log files generated by Test Pilot. Errors, if they occur, will appear in the files in this folder. The files should be deleted or backed up and deleted occasionally.

WEB_INF/MYSQL.TXT - Instructions for downloading and installing the free and powerful MySQL Relational Database. Test Pilot requires such a database for robust data storage and retrieval.

WEB_INF/README.TXT - The installation instructions - READ THIS!!!!

WEB_INF/Start_TestPilot.jar - This java library starts Test Pilot with an embedded Apache Tomcat server when opened.

WEB_INF/Stop_TestPilot.jar - This java library stops the embedded server when opened.

WEB-INF/web.xml - This is a file that instructs Tomcat how to configure and run Test Pilot. This file is constructed at installation time but experts may be edit it later to alter Test Pilot installation settings.

WEB-INF/work - This is a folder containing temporary files and directories generated by the embedded Tomcat server.

Configuring Apache

Apache will be automatically configured during the install process. However, you will need to restart your computer to enable those changes after the installation.

Manually Configuring Test Pilot

The installer should set the necessary parameters for operation. However, if you need to change them or add additional parameters they are located in the web.xml file mentioned above. Specifically you must make some substitutions:

SERIAL - 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_ID - should be changed to the account id you wish to use when creating new assessments.


ADMIN_PW - should be changed to the password you wish to use when creating new assessments.


ADMIN_EMAIL - should be changed to the email address for the administrator. This must be a complete and valid Internet e-mail address including domain information such as joe@abc.com


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


DATABASE_DRIVER - should be changed to the name of a valid JDBC database driver.


• For OpenBase, this should be: com.openbase.jdbc.ObDriver
  
  
• For MySQL, this should be: org.gjt.mm.mysql.Driver
  
  
• For Oracle, this should be: oracle.jdbc.driver.OracleDriver
  
  
DATABSE_URL - should be changed to a valid JDBC URL for accessing the relational database.


• For OpenBase, this should be: jdbc:openbase://localhost/TESTPILOT
  
  
• For MySQL, this should be: jdbc:mysql://localhost/TESTPILOT
  
  
• For Oracle, this should be: jdbc:oracle:thin"@127.0.0.1:1521:TESTPILOT

  localhost indicates that the database is running on the same server as Apache. It may be changed if the database is on another machine. Please note that best performance is achieved when the database is running on the same machine as Test Pilot. "127.0.0.1" is equivalent to localhost.
  
  TESTPILOT is the name of the database that you have created for Test Pilot. If you have created a database by another name, change this entry.
  
  
DB_ADMIN - should be changed to the account name that is authorized to access the relational database for Test Pilot.


DB_PW - should be changed to the password for the account name used to access the relational database.

The following arguments are optional and need not be specified if the default values are acceptable.

siteid = [name]; This identifier is used to allow multiple Test Pilot web servers to share a common database server. Each web server using the database server should have the same siteid name. It is strongly recommended that you set a siteid.


upload = [on,off]; This is used to enable uploading of media files using Test Pilot. If this is disabled (the default), it will be necessary to provide alternate means (FTP, file services, etc) for authors to upload their multimedia files to the Test Pilot server.


• tz = timezone; You may override your computers default timezone by entering a valid abbreviation in this parameter. Once Test Pilot is installed, you may get a list of valid timezone abbreviations, access the following URL substituting your server name in the appropriate spot:

  http://SERVER/servlet/TestPilot4/?timezones

• cache = number; Test Pilot caches assessments in memory to speed response time. The default size is 30 assessments. If you are operating in a high volume environment you may want to increase this value. However, be sure your server has the memory to support the added consumption.
  
  
• iphide = [on,off]; This causes Test Pilot to hide the computer IP addresses of submissions in reports. This parameter is provided to optionally hide those addresses to address the security concerns of institutions wishing to keep this information private. IP addresses are shown by default.
  
  
• secure = [true.false]; When set to true, Test Pilot will only respond to secure http requests. Test Pilot responds to both secure and non-secure requests by default.

To verify that you have it installed properly, access the following URL replacing server.edu with your server's name: