Details Print

FrequentlyAskedQuestions

Installation

What are the installation requirements?

See the online User Manual for details.

Please note that under Windows Vista some restrictions regarding the target path do apply, as shown here.

What are the client requirements?

To access Klaros-Testmanagement you need a fairly up to date web browser (we are testing with IE 7.0/8.0 and Firefox 3.1/3.5, others like Chrome/Safari and Opera should work as well, if not please complain at the forum) and - if you are using a version prior to version 2.5 - a recent Adobe Flash Player Plugin for executing manual tests.

The installer complains about a missing JAVA_HOME/JRE_HOME, what am I missing?

Klaros requires an installation of Sun/Oracle Java Standard Edition 6.0 or better for operation. Additionally the environment variable JAVA_HOME (for Java SDK installations) or JRE_HOME (for Java Runtime Environment installations) has to be defined. This forum entry shows how to do this under Windows.

The installer crashes under Linux, what am I missing?

Klaros-Testmanagement requires an installation of Sun/Oracle Java Standard Edition 6.0 or better for operation. Most Linux distributions come with an alternative Java implementation like GNU Java Runtime or OpenJDK. Klaros-Testmanagement is not supported in such an environment, so you should download a Sun/Oracle Runtime and modify the environment to use this runtime instead.

Database Handling

Where does Klaros store its data, I see no database to configure?

Klaros is able to use different types of SQL databases. The Community Edition comes with a predefined Apache Derby database which stores its data in the home directory of the user which runs the web application in the folder .klaros/klarosDerby.

Derby file access is slow, is it possible to use a full blown SQL-Database Server?

Yes. See below for a list of supported databases.

What other databases are supported at the moment?

The Klaros Community Edition currently supports the following Open Source databases:

• Apache Derby 10.5.3.0 ( http://db.apache.org/derby/)
• MySQL 5.1 (http://www.mysql.com/)
• PostgreSQL 8.3 (http://www.postgresql.org/)

If you are planning to use commercial databases like Oracle, DB2 or Microsoft SQL-Serve please contact us directly at support@verit.de.

How do I change the Klaros database installation?

Klaros uses the Hibernate Persistence Layer to access the database. The database parameters are stored in the file .klaros/hibernate.properties in the home directory of the user which runs the Klaros web application, as shown below:

Apache Derby Configuration

hibernate.dialect=org.hibernate.dialect.DerbyDialect
hibernate.connection.driver_class=org.apache.derby.jdbc.EmbeddedDriver
hibernate.connection.url=jdbc:derby:C:\Documents and Settings\stolp/.klaros/klarosDerby;create=true
hibernate.connection.username=root
hibernate.connection.password=root

By editing this file you are able to switch to a new database connection like the following which uses a MySQL database with InnoDB support (InnoDB is recommended since MyISAM is missing transaction support):

MySQL Configuration

hibernate.dialect=org.hibernate.dialect.MySQLInnoDBDialect
hibernate.connection.driver_class=com.mysql.jdbc.Driver
hibernate.connection.url=jdbc:mysql://localhost:3306/klaros
hibernate.connection.username=root
hibernate.connection.password=root

Please make sure that InnoDB is supported in your MySQL installation.

Another good alternative is PostgreSQL:

PostgreSQL Configuration

hibernate.connection.driver_class = org.postgresql.Driver
hibernate.connection.url = jdbc:postgresql://localhost/mydatabase
hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect
hibernate.connection.username=root
hibernate.connection.password=root

You will find an exhaustive list of the database parameters in the Hibernate Core Manual.

I already have test data entered in my current database, will this data be lost when I migrate to a new database?

Since version 1.11 Klaros-Testmanagement Community Edition supports the Backup and Recovery of its database to and from XML Files. You may use this functionality to migrate your data from one database to the other.

See the User Manual for details of the migration process.

JIRA Integration

I cannot change the JIRA URL in the online demo. What am I missing?

The online demo runs in a special restricted mode which does not allow to change this parameter. The community edition which you may download freely has no such restriction.

Test Execution

I cannot execute the tests I have defined. What am I missing?

To execute a manual test the following preconditions have to be met:

• At least one Test Environment has to be defined
• At least one System Under Test (SUT) has to be defined
• The test must be of the Execution type Manual and must have at least one test step defined