Chapter 3. Installation

Table of Contents

3.1. Prerequisites
3.1.1. Client Prerequisites
3.1.2. Server Prerequisites
3.1.2.1. Microsoft Windows
3.1.2.2. Linux
3.2. Installation Process
3.2.1. Step 1: Welcome
3.2.2. Step 2: Information
3.2.3. Step 3: Licensing Agreements
3.2.4. Step 4: Target Path
3.2.5. Step 5: Select Installation Packages
3.2.6. Step 6: User Data
3.2.7. Step 7: Installation
3.2.8. Step 8: Perform External Processes
3.2.9. Step 9: Setup Shortcuts
3.2.10. Step 10: Installation Finished
3.3. Update Process
3.3.1. Database Migration
3.3.1.1. Migration to 3.0.0
3.4. Running Klaros-Testmanagement
3.5. Changing the Database
3.6. Configuring External Issue Management Systems
3.6.1. Bugzilla Configuration
3.6.1.1. Supported versions
3.6.1.2. Additional Bugzilla Configuration
3.6.2. JIRA Configuration
3.6.2.1. Supported versions
3.6.2.2. Additional JIRA Configuration
3.6.3. Redmine Configuration
3.6.3.1. Supported versions
3.6.3.2. Additional Redmine Configuration
3.6.4. Trac Configuration
3.6.4.1. Supported versions
3.6.4.2. Additional Trac Server Configuration

Klaros-Testmanagement is equipped with an installer for the Microsoft Windows and Linux based operating systems. Excluding a Java Runtime Environment - which is needed for the installer itself, it will install all the necessary applications to run Klaros-Testmanagement, including a file based database (Apache Derby) and the Apache Tomcat application server.

[Warning]Warning

The installer installs a version of Klaros-Testmanagement that uses the Apache Derby database for persistence. For production systems, it is strongly recommended to use a database like MySQL, PostgreSQL or Oracle which will provide a significantly better performance. After running the initial installation process, the database can be changed. How this is done is described in Section 3.5, “Changing the Database”

This chapter provides all necessary information to install Klaros-Testmanagement.

3.1. Prerequisites

Since Klaros-Testmanagement is a web application the installation prerequisites for the client and the server side are different. These are explained in detail in the next sections.

3.1.1. Client Prerequisites

To access Klaros-Testmanagement a modern web browser supporting JavaScript is required.

Table 3.1. Supported Browser

NameVersion
Microsoft Internet Explorer Version 7 and above
Mozilla Firefox Version 3.5 and above
Google Chrome Version 4 and above
Safari Version 4 and above

Please note that due to its current state Konqueror is currently not a supported browser.

3.1.2. Server Prerequisites

To run the Klaros-Testmanagement server a Microsoft Windows or Linux operating system running Sun/Oracle Java 6 is required.

[Warning]Alternative Java-Runtime Environments

Out of the box, most Linux distributions do not come with a Sun/Oracle Java installation but some alternative Java implementation like GJC or OpenJDK. Klaros-Testmanagement is not supported in such an environment and is known to not install or not work properly in such environments.

For optimal performance a separate database installation is recommended. This database is not required to run on the same physical machine as the Klaros-Testmanagement server.

Table 3.2. Supported Databases

NameDescription
Apache DerbyVersion 10.5.0.3 and above (already configured)
MySQLVersion 5.1 and above
PostgreSQLVersion 8.4 and above
OracleVersion 10g, 11g

[Warning]Make sure that the JAVA_HOME/JRE_HOME environment variable is set!

A common caveat is that although Java is installed on your machine, the startup script will complain that neither the JAVA_HOME nor the JRE_HOME environment variable is defined. Windows users will find an option to set this in their computer control panel. The location where to reach this varies with different versions of windows, an example is shown below. Linux users should set the variables in their startup scripts.

Figure 3.1. Setting the JAVA_HOME environment variable

Setting the JAVA_HOME environment variable

3.1.2.1. Microsoft Windows

To run Klaros-Testmanagement on Microsoft Windows operating system the following requirements have to be met:

  • Minimum requirements

    1GB RAM, 2GHz CPU

  • Recommended requirements

    2GB RAM, 2.5GHz Dual-Core CPU

  • Operating system

    Microsoft Windows XP, Microsoft Windows Vista or Microsoft Windows 7

  • Java Runtime Environment

    Sun/Oracle Java 2 Standard Edition 6.0 or better

3.1.2.2. Linux

To run Klaros-Testmanagement on Linux operating system the following requirements have to be met:

  • Minimum requirements

    1GB RAM, 2GHz CPU

  • Recommended requirements

    2GB RAM, 2.5GHz Dual-Core CPU

  • Operating system

    Linux IA32 (Intel 32 bit architecture) distribution containing Version 2.2.1 or better of the GTK+ widget toolkit and associated libraries

    GTK+ is only needed for running the Klaros-Testmanagement installer.

  • Java Runtime Environment

    Sun/Oracle Java 2 Standard Edition 6.0 or better