Initialization Argument Setting Information

There are many parameters in the WEB-INF/web.xml configuration file. While the most important parameters will be set by the installer, here is a list of all supported initialization parameters:

• serial = your Test Pilot serial number; entering the correct serial number here unlocks your copy of Test Pilot and prevents it from deactivating automatically after a period of time or number of requests.
  
  
• adminid = ACCOUNT; enter an account in this space to be used when accessing Test Pilot's administrative options. On Windows servers, this must be a valid Windows login account.
  
  
• admin = PASSWORD; enter a password in this space to be used when accessing Test Pilot's administrative options. On Windows servers, this is not used.
  
  
• email = ADDRESS; enter a complete internet e-mail address for the administrator. This must be a full Internet e-mail address such as joe@abc.com.
  
  
• smtp = SERVER; Test Pilot has some built-in e-mailing facilities for e-mailing scores to participants. It need to know what Internet SMTP mail server to use when sending messages. Please note that the selected server must permit the server running Test Pilot to post e-mail messages. Some e-mail systems may not permit a web server to send SMTP mail, thus this feature may not work for all installations. With no entry, e-mailing is disabled.
  
  
• tomcat = [compatible]; When set to compatible, Test Pilot will properly respond to requests generated by the Tomcat servlet engine. This setting must be made in order for Test Pilot to work with Tomcat.
  
  
• driver = [name]; This should be set to the name of the JDBC driver used to make connection between test Pilot and the relational database.
  
  
• jdbc = [URL]; This should be set to a valid JDBC URL to be used to connect to the relational database server.
  
  
• dbuser = [account]; This should be set to the id of an account permitted to access the relational database.
  
  
• dbpass = [password]; This should be set to the corresponding passowrd of the account permitted to access the relational database server.
  
  
  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.

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

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: