UNIX & Linux Installation

Back - Windows Installation Up - Installation Next - MySQL

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.3.1 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:

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.

WEB_INF/HTTP - This file must be present for the embedded Tomcat server to function.

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

You must be logged in as root or operating under sudo with administrative privileges.

Carefully read the README file in the Test Pilot distribution's apache directory. Follow the instructions to:

• Compile and add the mod_jk module to Apache.
• Modify Apache's httpd.conf in a manner to include the contents of the this directory's tomcat.conf file.
• Restart Apache

Configuring Test Pilot

You will need to edit the WEB-INF/web.xml configuration file to use Test Pilot. 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.

Once these changes ar made, copy the WEB-INF directory to Apache's Document Root directory.

http://server/servlet/TestPilot4/

You should receive a Test Pilot login screen. You must now stop Tomcat and configure the database connection for Test Pilot.

Database Server Connection Information

• MySQL
  
  
• OpenBase
  
  
• Oracle
  
  
• Microsoft SQL Server