Bug Base: Configuration

Database Configuration

In the first step, the database has to be configured:

• Hypersonic SQL: Nothing has to be done
• MySQL: Create a new database.

Configuration Files

The distribution holds sample configuration files for Jakarta Tomcat and Resin:

• Tomcat 3.X: WEB-INF/web-tomcat-3.xml.
• Tomcat 4.X: WEB-INF/web.xml.

Please select the suitable one and copy it to WEB-INF/web.xml.

In the case, that you want to execute the test cases, please use the following files:

• Tomcat 3.X: WEB-INF/web-tomcat-3-test.xml.
• Tomcat 4.X: WEB-INF/web-test.xml.

JSP Engine Configuration

The following servlet parameters may be set:

BugBaseServlet

This is the servlet handling the database access to the database. It has the following initialization parameters:

• db.server: Database Server class. Possible values:
  • openfuture.util.database.HyperSQLServer in case that you use Hypersonic SQL
  • openfuture.util.database.MySqlServer in case that you use MySQL

• db.url: URL of the database:
  • http://<hostname>/bugbase/servlet/HypersonicDBServlet in case that you use Hypersonic SQL
  • //<hostname>/<db-name> in case that you use MySQL

• db.user: Database user used for the connection to the database (sa in case that you use Hypersonic SQL without modification).

• db.password: Password of the database user used for the connection to the database (<empty string> in case that you use Hypersonic SQL without modification).

HypersonicDBServlet

This is the servlet handling the Hypersonic SQL database access via HTTP requests. It has the following initialization parameters:

• filename: Filename of the HyperSonic SQL database.

This is not relevant, if MySQL is used.

BugBaseJspServlet

This servlet is only used to initialize the servlet context.

• openfuture.bugbase.servlet.BugBaseServlet: URL to BugBaseServlet. Usually this is of the form:
  <hostname>/bugbase/servlet/BugBaseServlet

• openfuture.bugbase.loginManager.timeout: Timeout in seconds after which login becomes invalid.

• openfuture.bugbase.attachment.dir: Directory, where attachments are placed.

• openfuture.bugbase.attachment.URL: URL under which the attachment directory can be reached via HTTP.

• openfuture.bugbase.mail.server: Mail server for delivering emails to bug report authors.
  Note: In future releases, this should be user specific.

• openfuture.bugbase.locales*: Locales supported by Bug Base (currently de_DE, en_GB).

action

The action servlet is the central controller servlet of the Struts Framework (although we do not like frameworks in general, this is very useful ;->).

• application*: Base name of the ressource bundles.

• config*: The configuration file.

• debug*: The debug level.

• detail*: The detail level.

Please do not modify these (*) attributes unless you know what you are doing.

This completes the configuration. Now (re)start your JSP engine, log in and define your projects using the Administration Applet. In the unlikely case of an error, a diagnosis page may be used in order to detect the malicious configurations.