QaTraq FAQ

1. A message appears saying the QaTraq version is not licensed. I also see the message "To enable this functionality please purchase a licence from..." in nearly every screen I try.

Make sure the license files are correctly extracted to the QaTraq\Licence folder:

1. Right click on the license file and select "Extract All"

2. Using the Windows Extraction Wizard:

Click Next to continue
Select the current directory to extract to (path may vary from the type of installation and the default directory):

Windows Installer: C:\Program Files\QaTraq\htdocs\qatraq\licence
XAMPP: C:\Program Files\xampp\htdocs\qatraq\licence

For Linux/Unix: use the following command:
> cp qatraqpro.zl /srv/www/htdocs/qatraq/licence (assumes default directory is ‘/srv/www/htdocs’)

If you have installed QaTraq Professional using Apache, verify that the configuration file has been setup correctly:

1. Edit the php.ini file with notepad.exe

2. Find the following code and make the changes:

[Zend]
;zend_extension_ts = "C:\Program........."
;zend_extension_manager.optimizer_ts = "C:\Program ........"
;zend_optimizer.enable_loader = 1
;zend_optimizer.optimization_level=15
;zend_optimizer.license_path =

To:

[Zend]
zend_extension_ts = "C:\Program........."
zend_extension_manager.optimizer_ts = "C:\Program ........"
zend_optimizer.enable_loader = 1
zend_optimizer.optimization_level=15
zend_optimizer.license_path = "C:\Program Files\xampp\htdocs\qatraq\licence"

Note: Make sure the zend_optimizer.enable_loader value is set to 1

3. Restart Apache

2. I’m getting a message, "Could not open database connection" after attempting to login to QaTraq.

The connection to the database may not be configured properly. Here are the steps that may resolve this error:

Verify that the db_params.php file is set up properly. See the 'Modify the db_params.php' in this article
Verify that two Mysql user accounts required by QaTraq have been set up correctly. See the 'Create the QaTraq database' in this article
Enable logging and look into the log files. For more information, go to this link
Verify the contents of the users table by typing the SQL command 'Select * from users'.
Recreate the database by dropping the database and creating the database again.

For detailed instructions on the steps mentioned above, please refer to this article

3. I get a message that says Login and password does not work every time I try to login.

This could be due to various reasons. Please refer to the steps below to resolve this error:

Check if the default username/password works: admin/admin
Verify that the db_params.php file is set up properly. See the 'Modify the db_params.php' section here: <link>
Verify that two Mysql user accounts required by QaTraq have been set up correctly. See the 'Create the QaTraq database' section here: <link>
Check the contents of the log files for any errors. To enable QaTraq logging, refer to this link: <link>

4. I have installed QaTraq but I am encountering an issue when attempting to connect to http://localhost/qatraq/index.php. I receive a HTTP 404 error

Check the following for possible causes:

Verify that the address being used is the correct one for the Qatraq installation.

Here are default addresses of the different install versions:

Windows Installer:http://127.0.0.1:4001/qatraq/index.php or http://localhost:4001/qatraq/index.php
XAMPP/Apache:http://localhost/qatraq

Verify that the QaTraq installation folder was extracted to the correct root folder.
Check if the Apache daemon is running. See Apache Setup <link> for more details
Another possibility is that Apache is badly configured. See Apache Setup or http://httpd.apache.org/docs/ for more details.

5. I installed QaTraq on another server. How do I migrate my installation from the old to the new server?

To move QaTraq from an old to the new server, use the following steps:

a. Backup your existing database with the following command:

> mysqldump -uqatraq -pYOUR_PASSWORD qatraq > qatraqdb.sq

b. Create a new MySql database on your new server.

‘Drop’ your existing qatraq database on the new server first (make sure there is no data in this database that you need) with this command:

> mysql -uroot -pYOUR_PASSWORD -e "drop adatabase qatraq"

Then, create the new database:

> mysql -uroot -pYOUR_PASSWORD -e "create database qatraq"

c. Import the backup database into your new database:

> mysql -uroot -pYOUR_PASSWORD qatraq < qatraqdb.sql

d. Modify the database connection parameters in QaTraq to point to the new database (you mtymprobably won't need this step if your new system is already working)

Edit the lib/db_qatraq.php file

e. Copy across the attachments created on the old server to the new server. Attachments are found in the qatraq/attachements directory

6.I get this error whenever I try to export to PDF: Fatal error: Allowed memory size of 33554432 bytes exhausted

In QaTraq Professional installs where the system is being used intensively or carrying out lots of memory intensive operations, it is recommended to increase this value to 256M or even 512M depending on how much memory the system has.

This setting may be increased by editing the php.ini file and changing these settings to values similar to the examples below:

max_execution_time = 180
max_input_time = 180
memory_limit = 512M

Restart your apache web server to see if an improvement in performance is seen.

7. Whenever I try to login using my LDAP user account, QaTraq is saying that my username and password is invalid.

LDAP issues are diagnosed with the help of Qatraq error log files. Here are some common errors and how to solve them:

ldap Could not initiate connection to "192.168.1.100"
- This error is caused by the LDAP server ip/hostname being unavailable or set incorrectly.
ldap Could not get configuration from auth/filename
- This error is caused by the configuration file being unavailable or incorrectly specified. Verify the file’s existence and the settings in auth/auth.cfg file.
ldap required default role not defined in auth/filename
- This error is caused by the "defaultRole" attribute not being set correctly in ldap.cfg file.
ldap could not load ldap module, please check that it is correctly installed
- This is caused by PHP’s ldap module not being installed or incorrectly configured. Refer to PHP documentation or the documentation provided with you webserver software for enabling the php ldap module.
Ldap anonymous bind failed
- Indicates that your LDAP server does not allow anonymous binds and requires bindDN and bindPassword to be defined in the ldap.cfg file.
Ldap could not resolve hostname
- This error is caused when a hostname is defined for the location of the ldap server and the server cannot be found. Causes for this can be either host availability issues, or DNS server related.

8. I have installed MySql, PHP and QaTraq but when I try to log in to the QaTraq I receive this "There is a mismatch between the database version and files version. Please check your installation!

Open the qatraq\lib\db_params.php file and check the section which looks like this:

Code:

// TMT database

$db_data['tmt'] = array(
'host' => 'localhost',
'db' => 'qatraq',
'user' => 'qatraq',
'password' => 'xxxx'
);

Make sure the db, user and password are configured correctly.

If the error persists, check that you have setup your database correctly by using this command in MySQL:

Code:

> mysql.exe -u -p qatraq -e "select * from version";

If this command responds with a MySql error message the database may not have been created yet. You may have to go back to the detailed installation instructions to fix the users.

9. If I start the QaTraq as usual (it worked before). I have error message:
Download and install GD extension for php

This error typically appears if the GD extension is disabled.

For Windows, check the php.ini file and see if the "gd" extension is commented out:

Look for:

;extension=php_gd2.dll

Remove the comment so it would look like this:

extension=php_gd2.dll

Restart the Apache server and check if you are still getting the error.

10. While exporting the test cases to PDF format, I'm getting the following error:

Warning: DOMDocument::loadXML() [function.DOMDocument-loadXML]: Empty string supplied as input in C:\Program Files\QaTraq\htdocs\qatraq\lib\html2pdf\treebuilder.class.php on line 22

Fatal error: Call to a member function node_type() on a non-object in C:\Program Files\QaTraq\htdocs\qatraq\lib\html2pdf\box.php on line 91

In QaTraq Professional installs where the system is being used intensively, or carrying out lots of memory intensive operations (like PDF export), we would recommend increasing this value to 256M or even 512M depending on how much memory your system has.

We suggest increasing this setting by editing the php.ini file

Change these settings to values similar to the examples below: