Test Management

QaTraq Professional Install

This guide assumes that you have already installed the QaTraq application and that you wish to upgrade and/or license the QaTraq Professional version. Please select what you already have installed:

I have installed QaTraq Professional using the Windows Installer
I have installed the Open Source version of QaTraq on Windows
I have installed the Open Source version of QaTraq on Unix/Linux
I have installed the Professional version of QaTraq on Windows
I have installed the Professional version of QaTraq on Unix/Linux

To see if you already have the Professional version installed go to the QaTraq About page using the "About" button on the top menu or a URL similar to the one below. If the About.php page says you have "QaTraq Pro Version 1.3.0" installed then you already have the Professional version installed and you only need to install the license file to enable the Professional features.

http://YOURHOST/qatraq/about.php

If you do not have QaTraq Professional installed then download the latest QaTraq Professional module for the latest 6_10_0 QaTraq release using the links below .

qatraq_pro_1_3_0.zip (Windows, QaTraq 6_10_0 installations)
qatraq_pro_1_3_0.tar.gz (Linux and Solaris, QaTraq 6_10_0 installations)

If you are not already running with QaTraq version 6_10_0 (or later) please download and install following the guide here...Download and install QaTraq. If you are running a version of QaTraq prior to version 6_10_0 (e.g. if you are running with 6_9_1_rc) please download and upgrade to QaTraq version 6_10_0 following the guide here... Upgrade from an old version of QaTraq

Installing the QaTraq Professional License (Windows Installer version)

If you have installed QaTraq Professional using the windows installer (e.g. you downloaded and ran the qatraq_6_10_0.exe application) then all you need to do to license QaTraq Professional is copy the license file to the correct directory and then restart QaTraq.

Check	Action	Command
	If you have not already done so purchase the Professional License or request a Trial License:	Purchase a License or Request a Trial License
	When you receive the licence file in the e-mail Traq Software send you copy the license zip file to the QaTraq license directory (this of course assumes you selected the default install location when you installed QaTraq):	C:\Program Files\QaTraq\htdocs\licence
	Unzip the license file that you copied to the QaTraq license directory :	Right click on the license file and select "Extract All" Using the Windows Extraction Wizard ...... - Click Next to continue - Select the current directory to extract to... C:\Program Files\QaTraq\htdocs\licence - Click Next - Click Finish
	Enable the licence by stopping and starting QaTraq with the following actions:	i) Close any running browser windows that are running QaTraq ii) Restart QaTraq by clicking on the QaTraq desktop icon

You should now be running with QaTraq Professional.

Windows Install

With the core QaTraq application running on a Windows platform you can upgrade to the Pro version by following the steps outlined below. This install process assumes you have installed QaTraq to a default directory of ‘C:\Program Files\xampp\htdocs\qatraq’. If your QaTraq directory is different please adjust the following steps as necessary.

Check	Action	Command
	if you have not already done so download the Pro Upgrade module	qatraq_pro_1_3_0.zip
	copy the qatraq_pro_1_x_x_rc.zip file to the htdocs folder so that you have qatraq_pro_1_x_x_rc.zip file at the same level as the qatraq dir:	> cd C:\Program Files\xampp\htdocs\ > dir qatraq* 28/04/2006 07:54 <DIR> qatraq 28/04/2006 08:45 xxxxxx qatraq_pro_1_x_x_rc.zip
	unzip the qatraq_pro package	right click the qatraq_pro_1_x_x_rc.zip file select 'Extract All' click Next to continue Extract files into this directory (NOTE you need to change this from the default deleting the qatraq_pro_1_x_x_rc part of the default directory))
	When prompted to replace existing files select YES	select 'Yes'
	Install and/or enable Zend optimizer. If you are running with xampp you only need to enable the Zend optimizer. IMPORTANT: you must be running with version 3.0.0 or later of the Zend Optimizer The lastest version of the Zend Optimizer can be downloaded, for FREE, from here.	i) edit the following file with notepad.exe C:\Program Files\xampp\apache\bin\php.ini ii) at the end of the file change (and remove the ";" characters)... [Zend] ;zend_extension_ts = "C:\Program........." ;zend_extension_manager.optimizer_ts = "C:\Program ........" ;zend_optimizer.enable_loader = 1 ;zend_optimizer.optimization_level=15 to.... [Zend] zend_extension_ts = "C:\Program........." zend_extension_manager.optimizer_ts = "C:\Program ........" zend_optimizer.enable_loader = 1 zend_optimizer.optimization_level=15 n.b. make sure the zend_optimizer.enable_loader value is set to 1 iii) restart apache in the XAMPP Control Panel Application click Apache 'Stop' when Apache shows as Stopped click Apache 'Start'

QaTraq Professional should now be installed. Once you have obtained your Professional Licence file please complete the following steps:

Check	Action	Command
	If you have not already done so purchase the Pro Licence from	Purchase a License or Request a Trial License
	When you receive the licence file in the e-mail Traq Software Ltd send you copy the licence file to the following directory:	> copy qatraqpro.zl C:\Program Files\xampp\htdocs\qatraq\licence
	Enable the licence by completing the following actions:	i) edit the following file with notepad.exe C:\Program Files\xampp\apache\bin\php.ini ii) at the end of the file change... ; zend_optimizer.license_path = to .... zend_optimizer.license_path = "C:\Program Files\xampp\htdocs\qatraq\licence" iii) restart apache in the XAMPP Control Panel Application click Apache 'Stop' when Apache shows as Stopped click Apache 'Start'

Your Pro Upgrade should now be enabled.

Linux / Unix

With the core QaTraq application running on a Linux or Unix platform you can upgrade to the Pro version by following the steps outlined below. This install process assumes you have installed QaTraq to a default directory of ‘/srv/www/htdocs’. If your QaTraq directory is different please adjust the following steps as necessary:

Check	Action	Command
	if you have not already done so download the Pro Upgrade module	qatraq_pro_1_3_0.tar.gz
	copy the qatraq_pro_1_x_x_rc.tar.gz file to the htdocs folder so that you have qatraq_pro_1_x_x_rc.zip file at the same level as the qatraq dir:	> ls /srv/www/htdocs/ > ls -ld qatraq* drwxr-xr-x................qatraq -rw-rw-r--................qatraq_pro_1_x_x_rc.tar.gz
	extract and uncompress the qatraq_pro package	> gunzip qatraq_pro_1_x_x_rc.tar.gz > tar -xvf qatraq_pro_1_x_x_rc.tar
	If prompted to replace existing files select YES	select YES
	Intsall and/or enable Zend optimizer IMPORTANT: you must be running with version 3.0.0 or later of the Zend Optimizer The lastest version of the Zend Optimizer can be downloaded, for FREE, from here.	Some linux/unix distros come pre-installed with the Php/Zend optimizer. You will know if your distro has the optimizer installed if you see the line zend_optimzer line in the php.ini file described in step ii below (if it is not then see the section below on installing the zend optimizer from scratch). i) edit the following file with a text editor (vi, emacs, etc) /etc/php.ini ii) at the end of the file change (and remove the ";" characters)... [Zend] ;zend_extension_ts = "/usr/local/........." ;zend_extension_manager.optimizer_ts = "/usr/local/ ........" ;zend_optimizer.enable_loader = 1 to.... [Zend] zend_extension_ts = "/usr/local/........." zend_extension_manager.optimizer_ts = "/usr/local/ ........" zend_optimizer.enable_loader = 1 n.b. make sure the zend_optimizer.enable_loader value is set to 1 iii) restart apache /etc/init.d/apache2 restart or /etc/init.d/apache restart or /usr/sbin/apachectl restar
	If the above zend optimizer enabling steps did not work for your platform then follow the steps on the right to download and install Zend Optimizer	i) go to the following Zend page and download the Zend Otptimizer for your platform (the Zend Optimizer is FREE, even though you have to click on the Buy Now link to download) http://www.zend.com/products/zend_optimizer Click 'buy now' (although the download is free) Select and download the "Zend Optimizer 3.0.1" for your platform ii) install the Zend Optimizer following the install instructions found in the "Zend Optimizer User Guide" which can be download using the same link given above. iii) the installation script for the Zend Optimzier should have restarted apache. If it has not restart Apache with one of the following: /etc/init.d/apache2 restart or /etc/init.d/apache restart or /usr/sbin/apachectl restart

QaTraq Professional should now be installed. Once you have obtained your Professional Licence file please complete the following steps::

Check	Action	Command
	If you have not already done so purchase the Pro Licence from	Purchase a License or Request a Trial License
	When you recieve the licence file in the e-mail Traq Software Ltd send you, copy the licence file to the following directory:	> cp qatraqpro.zl /srv/www/htdocs/qatraq/licence
	Enable the licence by completing the following actions:	i) edit the following file with a text editor (vi, emacs, etc) /etc/php.ini ii) at the end of the file change or add the line... ; zend_optimizer.license_path = to.... zend_optimizer.license_path = "/srv/www/htdocs/qatraq/licence" iii) restart apache with one of the following: /etc/init.d/apache2 restart or /etc/init.d/apache restart or /usr/sbin/apachectl restart

Your Pro Upgrade should now be enabled.

Disabling the Professional Module

If you have installed the QaTraq Professional and you wish to only use the Open Source component of QaTraq then you can disable the Professional features. To disable the Professional features.....

Check	Action	Command
	Edit the qatraq/constants.inc file and turn off the Pro functionality	i) edit the following file with notepad.exe or VI htdocs/qatraq/lib/constants.inc ii) at the end of the file change ... define("DISABLE_PRO", false); to.... define("DISABLE_PRO", true);

St. Mary's Court, The Broadway,
Old Amersham, Buckinghamshire.
HP7 0UT United Kingdom
Telephone: +44 (0)1494 582037