Details Print

FrequentlyAskedQuestions

Basic topics

Is Klaros-Testmanagement open source?

Klaros-Testmanagement is not published as open source. It is available in two editions, a free Community Edition and an Enterprise Edition. For a detailed overview on the differences please check our website.

Is a Klaros-Testmanagement Enterprise Edition trial license available?

It is possible to upgrade the Community Edition with an enterprise trial license which is valid for a period of 30 days. You can order the trial license here or directly from within the Klaros-Testmanagement UI on the "System information" page.

Where do I find licensing and pricing information for Klaros-Testmanagement?

Please check out our FAQ. If you have questions feel free to contact us at sales@verit.de.

I have problems downloading Klaros-Testmanagement from the download page

Please check your local security settings and ask your system administrator for assistance. Maybe a firewall or proxy prevents the download. Also anti virus software might block the download.

Bug Reports

Where do I send bug reports concerning Klaros-Testmanagement?

You can either use our forum or send an email to support@verit.de.

What information should I provide in my bug report/email?

To support us in solving the issue quickly, please provide the following information in your bug report:

• a Screenshot if it is a problem with the UI
• the Klaros-Testmanagement log files from the log folder in your Klaros installation directory (subfolder "logs"), most important is the catalina.out file.
• when not running Klaros-Testmanagement as a service under Windows, please provide the console output too.
• the versions of your installed software components (database, operating system, browser)
• the version of your issue tracker in case you have a problem connecting to your issue tracking software

How do I view the logs in Klaros-Testmanagement?

Klaros-Testmanagement does not provide the possibility to view its logfiles. The logfiles are located in the subfolder "logs" in the Klaros installation directory. Depending on the setting in Configuration -> Logging you will find detailed information there. If you are not running Klaros-Testmanagement as a service you might also find the loginformation in the console window of interrest.

Installation

What are the installation requirements?

See the online User Manual for details.

Please note that under Windows Vista and Windows 7 some restrictions apply regarding the target path, 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 8.0/9.0 and Firefox 4.0/5.0, others like Chrome/Safari and Opera should work as well, if not please tell us on the forum).

Does Klaros-Testmanagement run on Mac OS X?

Since version 3.4.4 Klaros-Testmanagement is finally supposed to install without a glitch on OS X.

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

Klaros-Testmanagement 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 Windows installer does not do anything after extracting the files, what is wrong?

The reason for this behaviour might be a missing PATH entry on your system. Please ensure that the bin folder in your JAVA_HOME/JRE_HOME is added to your PATH variable.

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.

During Installation/Startup I find something like INFO: Port busy 18009 java.net.BindException: Address already in use in the logs

There is a process running that already blocks the port 18009. Please check that there are no running processes that block the ports that Klaros-Testmanagement uses. For the default ports see the online documentation. If you changed these ports during your installation process, please verify that there is no other process blocking the ports you entered. For other ports please check your $TOMCAT_HOME/conf/server.xml file or refer to the Tomcat manual.

I want to install Klaros-Testmanagement on a Linux box without an X-Server, what can I do?

Since version 3.4 Klaros-Testmanagement provides a command line installer for Linux. For further information see the user manual.

How do I install Klaros-Testmanagement on a Linux box using the console only?

Since version 3.4 Klaros-Testmanagement provides a command line installer for Linux. For further information see the user manual.

How do I install Klaros-Testmanagement as a Linux service?

Please check the online documentation on that topic.

How do I install Klaros-Testmanagement as a Windows service?

Please check the online documentation on that topic.

The installed Klaros-Testmanagement Windows Service is running out of memory

Klaros-Testmanagement needs a larger amount of memory than a default Java installation suggests. Therefore it is mandatory to supply the following settings to the tomcat configuration which can be set in the tomcat6w administration interface by adding the line -XX:MaxPermSize=128m to the Java Options text area in the Java tab as shown below. In addition a reasonable amount of maximum memory should defined here as well.

I am running out of heap space and Klaros-Testmanagement slows down, can I change the heap settings?

You can change the startup scripts of Klaros-Testmanagement. Depending on your OS please modify:

Catalina.sh around line 277

-XX:MaxPermSize=128m -Xms256m  -Xmx512m org.apache.catalina.startup.Bootstrap "$@" start

Catalina.bat around line 272

%_EXECJAVA% %JAVA_OPTS% %CATALINA_OPTS% %DEBUG_OPTS% -Djava.endorsed.dirs="%JAVA_ENDORSED_DIRS%" 
-classpath "%CLASSPATH%" -Dcatalina.base="%CATALINA_BASE%" -Dcatalina.home="%CATALINA_HOME%" 
-Djava.io.tmpdir="%CATALINA_TMPDIR%" -XX:MaxPermSize=128m -Xms256m -Xmx512m %MAINCLASS% 
%CMD_LINE_ARGS% %ACTION%

in one line.

I find java.lang.OutOfMemoryError PermGen space entries in the log and Klaros-Testmanagement slows down

Please check the two FAQ entries above, depending on how you are running your tomcat server.

Klaros-Testmanagement does not perform very well though I didn't create that many Test Cases. What can I do?

Depending on your operating system you can raise the amount of memory for Klaros-Testmanagement in either the Catalina.sh (Linux) or Catalina.bat (Windows). Mainly replace all occurences of -Xmx* with -Xmx<memvalue> where <memvalue> is the amount of memory your system can provide. For mor information about the Java VM and the correct syntax of the Xmx parameter please check the Oracle Java documentation.

I upgraded to a new version, the version number is still the old one, what am I missing?

Please make sure to stop the tomcat server before upgrading to a new Klaros-Testmanagement version.

I get a error message about an invalid certification path, what is wrong?

The reason might be the usage of a self signed certificate in your SSL Server. Please check for more information at the following places:

• http://blogs.oracle.com/gc/entry/unable_to_find_valid_certification
• http://stackoverflow.com/questions/2125686/using-a-self-generated-key-to-test-java-ssl-app

Database topics

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

Klaros-Testmanagement 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. We strongly discourage the use of Derby for production data, due to lack of performance and missing transaction support.

What other databases are supported at the moment?

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

• Apache Derby (builtin) ( 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-Server please contact us directly at support@verit.de.

Can I use Klaros-Testmanagement together with a MS SQL Server?

MS SQL is currently not officially supported. There might be a chance with the right Hibernate settings and an additional JDBC driver. If you want to help with this topic, your input is highly appreciated.

How do I change the Klaros-Testmanagement database installation?

Klaros-Testmanagement 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-Testmanagement 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.

Our recommended database 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.

Since I moved Klaros-Testmanagement to a windows service I can no longer login to my created database. Whats wrong?

Make sure that the .klaros directory is made available in the home of the user running the service.

I exported the database using the export feature. The user and the jobs are missing?

Klaros-Testmanagement currently does not export the user and the jobs. To create a backup please use the backup tools that are provided by the database you configured.

What is the recommended way to back up the Klaros-Testmanagement database?

To backup the data stored in Klaros-Testmanagement please use the tools that are provided by your database distribution. The XML Import/Export feature should only be used to export to or import from foreign systems.

Issue Management

I cannot change any Issue Management System definition in the online demo. What am I missing?

The online demo runs in a special restricted mode which does not allow to change these parameters. The community/enterprise edition which you can download has no such restriction.

I cannot connect to my issue management system (e.g. JIRA) via HTTPS. Yet it works from the browser, what's wrong?

This may happen if you are using a self signed certificate in your SSL Server. See http://blogs.oracle.com/gc/entry/unable_to_find_valid_certification for a solution.

I get an authentication error while validating the issue management system URL even though my login details are correct, what's wrong?

If this happens, you should check to see if the addition or removal of a trailing slash in the URL resolves the issue. For some network setups, this can be significant. Note that for Redmine, the Authentication Required checkbox in Settings>Authentication must be checked.

Testcase issues

How can I copy test cases between projects?

You can copy test cases to from one project to another via the "Maintain Projects" menu. Click on the destination project's edit button an then activate the "Copy Test Cases" tab to select the source project and then the test cases to copy. For detailed information please refer to the User Manual.

I cannot define any test steps for my testcase, what am I doing wrong?

To define test steps for a test case, the execution type of the test case must be set to "Manual". You can either do this by setting it in the test case overview of your project by clicking on "Maintain Test Cases" in the menu to the left and then selecting "Manual" in the Execution dropdown box, or by clicking on the "Edit test case icon" of the test case in question and setting Execution to "Manual" in the test case overview.

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 for the test project
• At least one System Under Test (SUT) has to be defined for the test project
• The test case must be of the Execution type Manual and must have at least one test step defined

For additional information please refer to the User Manual.

Can I execute scripts to run test cases from inside Klaros-Testmanagement?

No, Klaros-Testmanagement does currently not support the execution of scripts. Klaros-Testmanagement does support the import of the results of several test frameworks though. For detailed information on the supported frameworks please refer to the User Manual.

How do I execute a test case from the job view?

Click on the "Plan" icon and then on the "Maintain Jobs" menu entry to the left. If the test case was defined with manual execution, in the list of the displayed jobs click on the "Execute" icon to execute the test case. If it was defined with manual automatic execution click on the "Upload results" icon and upload the results of the test run. Keep in mind that the test case defined with manual execution requires at least one test step.

Is it possible to pause the execution of a Test Run?

Yes, you may resume test suite execution using the Continue Test Run menu entry. The test execution client saves it's state after every single test execution in a test suite. For additional information please refer to the Online Manual.

I run into a session timeout during test execution, can I change the default value?

Yes, click on the Configure icon, then on the General entry in the System Parameters section in the left menu. You can then uncheck the session timeout checkbox on the right an enter the time desired in the textbox below.

Test Evaluation

Can I get rid of the Klaros logo in the generated reports?

Currently not. A feature to replace the logo with a user defined logo is currently in development. With the enterprise version of Klaros-Testmanagement you can define your own reports and you are able to include your own graphics. You can order a 30 day enterprise trial license here.

Is it possible to create personalized reports with Klaros-Testmanagement?

The creation of personalized reports is possible with the enterprise version of Klaros-Testmanagement. For more information please consult the User Manual.

User Management

Does Klaros-Testmanagement provide its own user management?

Klaros-Testmanagement features its own user management (see Configure -> UserManagement -> Search User after logging in with admin/admin to the online demo). The Enterprise Edition allows you to choose between authentication domains LDAP and Klaros. The default authentication domain is configurable in the web interface. The Community Edition is bound to use the Klaros domain.

Conceptual topics

What is the difference between a SUT and a testsystem?

The SUT (system under test) defines the artifact to be tested, usually your piece of software, e.g. Klaros-Testmanagement v3.4.7. The testsystem specifies the parameters on where the SUT is running, e.g. the hardware, the OS version, even peripheral units. These two parts can both influence the testresults, e.g. the test might succeed on OS1, but might fail on OS2. Example: Klaros-Testmanagement 3.4.7 (SUT 1) on Windows 7 (testsystem 1) und Redhat Linux (testsystem 2).

Compatibility issues

Does Klaros-Testmanagement run in a 64 bit Linux environment?

Yes, Klaros-Testmanagement works fine with 64 bit installations. You might want to consider the advice in the prerequisite section in the manual.

Miscellaneous

Klaros-Testmanagement is logging me out after a while, can I influence the session timeout?

Under Configure / System Parameters / General you can deactivate the 'Use the default container session timeout?' checkmark and enter the desired session timeout in minutes.

Does Klaros-Testmanagement support any languages other than German and English?

Klaros-Testmanagement currently fully supports German and English. Thanks to a user contribution a Chinese translation is avaliable. If you want to contribute other translations, your help is highly appreciated. Since version 3.4.3 you can change the available languages in the configuration section. For more information please consult the online manual.

Is there a possibility to modify Klaros-Testmanagement code?

No. The only code that can be modified is the code for the report generation. This feature is only available in the enterprise version of Klaros-Testmanagement, though.

Can I modify the quote of the day?

Yes. More information on changing it can be found in the online manual.