===============================================================
                    TestLink 1.9.7 (Prague Bugfix 7) - Read me
===============================================================

Contents
1. Introduction
2. Release notes
3. System Requirements
4. Installation & SECURITY
5. Upgrade and Migration
6. TestLink Team 
7. Bug Reports and Feedback
8. Supporting our work
9. Regarding forum usage www.teamst.org
10. Changes regarding 1.9.6

1. Introduction
===============================================================

TestLink is a web based test management and test execution system.
It enables quality assurance teams to create and manage their test 
cases as well as to organize them into test plans. These test plans 
allow team members to execute test cases and track test results 
dynamically.

TestLink is a GPL licensed open source project. All of the source code 
behind TestLink is freely available for download via SourceForge 
at http://www.sourceforge.net If you are interested in contributing 
to the TestLink effort feel free to contact us.
There is no hidden fee - 100% free for using!

In an ideal world, testing would be a pretty straightforward process.
A test team takes the product requirements, writes a test specification document,
reviews the tests, and then runs them all for each version of the product.
The team is composed of full-time staff, and everyone knows exactly what is expected of them.

In practice few organisations have that luxury.
There is not time to run all the tests on every product version - especially on fix-releases
that need to be rolled out quickly. 
Requirements are constantly changing, and the tests have to be changed in step.
Test staff come and go.
There are misunderstandings over who was supposed to run which tests, so some get missed.
Management suddenly wants a status update at seven in the evening.

In these situations you need the support of a test management tool, such as TestLink.
The purpose of TestLink is to answer questions such as:

- For which requirements do we still need to write or update test cases?
- Which tests do you want me to run for this version?
- How much progress have we made on testing this release?
- Which test cases are currently failing, and what are the errors?
- On which version was this group of test cases last run, and is it time we ran them again?
- And ultimately: is this version of the product fit for release?

TestLink helps you to keep the test process under control.
It forms a repository for requirements and test cases, and relates these to builds,
platforms and staff. 
You allocate tests to staff who carry them out and record the results.
A wide variety of reports provide information on what has been done and what still needs to be done.


2. Release notes
===============================================================

This release contains bugfixes for 1.9.6
   
See CHANGELOG file for detailed list of issues fixed.


3. System Requirements - server
===============================================================

Server environment should consists from:
- web-server: Apache 1.2 , 2.x
- PHP 5.3
- DBMS: MySQL 5.x , Postgres 8.x,9.x , MS-SQL 2005/2008

Supported client web-browsers: 
- Firefox 10 - 19
- Internet Explorer 8.x, 9.x
- Chrome   


4. Installation & SECURITY
===============================================================
The following details the basic steps for installation on any system. 
Instructions may seem unix-centric but should work on Windows systems.

Barring complications, it should take you about 10-20 minutes 
to install, configure, and be using TestLink.

Short summary:
 1. Transfer files
 2. Uncompress files
 3. Launch web based installer

1. First, transfer the file to your web-server using whatever 
method you like best (ftp, scp, etc).  
You will need to telnet/ssh into the server machine for the next steps.

2. Next, untar/gunzip it to the directory that you want.
The usual command is (1 step):

	tar zxvf <filename.tar.gz>

OR  (2 steps):

	gunzip <filename.tar.gz>
	tar xvf <filename.tar>

Total Commander, Winzip, and other programs should also be able 
to handle decompression of the archive.

At this point you may want to rename the directory to something 
different to 'testlink'. 

*** SECURITY ****
You need to configure:

- log directory 	($tlCfg->log_path)
- upload directory  ($g_repositoryPath)

according to your installation, default values provided are examples THAT DOES NOT WORK OUT OF THE BOX

Give a look to:
http://mantis.testlink.org/view.php?id=5147
http://mantis.testlink.org/view.php?id=5148
http://mantis.testlink.org/view.php?id=4977
http://mantis.testlink.org/view.php?id=4906

You should also need to configure write access for logging, upload and template directories.

*** FCKEDITOR UPLOAD ****
Give a look to:
http://www.teamst.org/forum/viewtopic.php?f=22&t=7098&sid=f4012a67d921cf5a2322c52fc38f21d6



3. Launch web based installer
We will create the necessary database tables and a basic configuration
file. From your web server, access http://yoursite/testlink/ 
or similar URL and follow instructions.

Check Installation manual and TestLink forum if you meet a problem.


5. Upgrade and Migration
===============================================================
When accessing Installer page you will found ONLY NEW INSTALLATION OPTION
Migration HAS TO BE DONE MANUALLY => read below 
- Upgrade from 1.9.3  to 1.9.4/5/6/7
- Upgrade from 1.9.4/5 to 1.9.7
- Migration from other releases that 1.9.3

 Steps
 - Make a Backup of your current database.
 - Using  a NEW DIRECTORY (DO NOT OVERWRITE your old installation),  
   do only following steps from Install procedure:
                                           Transfer files
                                           Uncompress files
 - Copy your old config_db.inc.php and custom_config.inc.php to NEW DIRECTORY.
 - Launch TestLink
 - TestLink will check Database version, and if some upgrade/migration 
   is needed will launch automatically the installer.

 If you are updating a same major version (for example 1.7.0 to 1.7.1) 
 you need to use Upgrade Database.
 
 If you are using a different major version detailed in options,  
 you need to use the specific Migrations.
 
 If in some steps TestLink ask you for two databases, 
 NEVER use same name from both.
 
 If you do not find nothing useful, post in forum
   
 Always before login, after an upgrade/migration clear browser cookies.

- Upgrade from 1.9.3 to 1.9.4/5/6/7
WARNING: if you are using a table prefix replace /*prefix*/ with your prefix
a) Execute install/sql/alter_tables/1.9.4/<your_db>/DB.1.5/step1/db_schema_update.sql
b) Execute install/sql/alter_tables/1.9.4/<your_db>/DB.1.5/stepZ/z_final_step.sql

Hint: When using MySQL Query Browser make sure you are not using a single command execution. 
      (open script or use special script tab to execute the whole script at once)

- Upgrade from 1.9.4/5 to 1.9.7
WARNING: if you are using a table prefix replace /*prefix*/ with your prefix
a) Execute install/sql/alter_tables/1.9.6/<your_db>/DB.1.6/step1/db_schema_update.sql
b) Execute install/sql/alter_tables/1.9.6/<your_db>/DB.1.6/stepZ/z_final_step.sql

Hint: When using MySQL Query Browser make sure you are not using a single command execution. 
      (open script or use special script tab to execute the whole script at once)



Migration from other releases that 1.9.3

You have always have to migrate one by one to each version that is newer that yours.
Extreme example Migration from 1.7.4

1.7.4 => 1.7.5 => 1.8.1 => 1.8.2 => 1.8.3 => 1.8.4 => 1.8.5 => 1.9.0 
1.9.0 => 1.9.1 => 1.9.2 => 1.9.3 => 1.9.4 => 1.9.5 => 1.9.6 => 1.9.7

You have to read carefully README and instructions provided by installer.
Sometimes version changes do not require actions on DB structure or data. 



6. TestLink Team 
===============================================================

This list comprise people that has helped

--- Most Active on this release
* Francisco Mancardi - Project lead, builds, core developer, contributors code reviewer

--- Contributors and developers active on older releases ---
* Maradana Amardeep - Leader of testlink-qa group effort on 1.9.5
* Bruno de Paula Kinoshita - some work on API, CSRF, Turn Key Linux
* Julian Krien - Leader of testlink-qa group effort on 1.9.1,1.9.2,1.9.3
* Andreas Simon
* Erik Eloff
* Martin Havlat - Project lead, builds, infrastructure, developer
* Andreas Morsing - core developer
* Amit Khullar

--- TestLink - QA Team - for 1.9.4
* Romoy Headly - QA Manager
* Sujata Verma   
* Damien Mathieu
* Amardeep Maradana
* Amit Khullar
* Andreas Simon
* Ngoc Vu
* Biache Benoit

--- TestLink - QA - for 1.9 RC1
* Andreia Balani
* Andreas Simon
* Biache Benoit
* James Bohnert
* Micky Zhang
* Rocky Yang


* Masami Ichikawa - Automated Testing


* Toshiyuki Kawanishi - Japanese localization, developer
* Chad Rosen - (Originator - version 1.0.x)
* Kevin Levy - Developer
* Asiel Brumfield - Infrastructure, developer
* Jason B. Archibald - Developer

* Tools R Us - contributing team
* Oscar Castroviejo - trackplus interface
* Seweryn Plywaczyk - text area custom field
* grdscarabe@grdscarabe.net and Alexandre Da Costa - French localization
* Walter Giaquinto/Alessandro Lia	and  bruno.busco@gmail.com - Italian localization
* Alessandro Lia - Javascript and CSS advice.
* Leonardo Molinari - Portuguese localization
* jorgesf@jsf.jazztel.es - Spanish localization
* Jonas Fleer : search test case by custom field on test projects
* Lightbulb Technology Services Pvt. Ltd. - techpartners: import test cases from XLS file
  abhishek.kulkarni@gmail.com and amit.dixit@lbtp.co.in 
* Kester Mielke <kmielke@pironet-ndh.com> (execution tree colouring and counters by tc status)
* Peter Rooms - Bug coloring and labeling according status using same colors than Mantis.
* Eugenia Drosdezki - Move/copy multiple testcases
*                     Access to content of docs folder on combo box  
*                     Multiselect OR keywords filter
* Japanese Testing Engineer's Forum (TEF) in Japan
  Working Group of TestLink Japanese Translation Project
  http://sourceforge.jp/projects/testlinkjp/
 
  Atsushi Nagata,       AZMA Daisuke,         Hiromi Nishiyama,
  Kaname Mochizuki,     Kaoru Nakamura,       Kunio Murakami,
  Lumina Nishihara,     Marino Suda,          Masahide Katsumata,
  Masami Ichikawa,      Masataka Yoneta,      Sadahiko Hantani,
  Shinichi Sugiyama,    Shinsuke Matsuki,     Shizuka Ban,
  Takahiro Wada,        Toshinori Sawaguchi,  Toshiyuki Kawanishi,
  Yasuhiko Okada,       Yoichi Kunihiro,      Yoshihiro Yoshimura,
  Yukiko Kajino			Yasuharu Nishi



--- Code reuse ---  
  We try to follow as much as possibile the following principle:
       Do not reinvent the wheel.
  We use code, and documentation from other Open Source Systems 
  (see CODE_REUSE document for details).


7. Bug Reports and Feedback
===============================================================

You may contact us at the TestLink forum at 
http://www.teamst.org/

If you found this software useful for your company please
post in forum on section "Companies using TestLink".

To submit a bug or a feature, please use our Mantis installation at 
http://www.testlink.org/mantis/. 

You can follow us on twitter => http://twitter.com/#!/TLOpenSource

Useful mails: testlink.forum@gmail.com, testlink.helpme@gmail.com


8. Supporting our work
===============================================================

if you find TestLinl useful, think about a donation to support our work.
contact testlink.forum@gmail.com


9. Regarding forum usage www.teamst.org
===============================================================

PLEASE: read this short hints before you write a topic:

:!: Use search forum before you add a new question.
:!: Did you search User or Installation manual before?
:!: Don't use the forum as a Bug Tracker - use http://mantis.testlink.org/login_page.php. 
	  Bug issues report done here will be DELETED
:!: Consider that some issues are related to Apache, browser or database instead of TestLink. Use google at first. 

      
10. Changes regarding 1.9.6      
===============================================================

10.1 Admin role can not be edit anymore

