Metric

Installation & Configuration Manual
TestLink version 1.8

Version:

2.15

Status:

Updated

© 2004 - 2009 TestLink Community
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation
License, Version 1.2 published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and
no Back-Cover Texts. Thelicense is available in "GNU Free Documentation License" homepage.

1.

Introduction

TestLink is open source web-based test management tool.

1.1.

Who should read this manual

This manual is targeted for the person responsible for evaluating, installing and maintenance of
TestLink in a company. Typically we refer to this person as the TestLink administrator.

1.2.

ScopeThis document
serves as a reference and knowledge base for the installation and
configuration. The installation process supposes using the in-built Web-installer (a step-bystep installation wizard). The Web-installer is default and recommended method of installing
TestLink. TestLink administrators apprise the second part describes rich configuration
abilities. Some features are hidden indefault configuration because of simplicity of basic
testing process.
The latest documentation is available on TestLink homepage. You can also ask for help to solve
your problems in an appropriate section of TestLink forum.
Summary of installation process:
1. Install background services
2. Transfer and uncompress files into web directory
3. Generate database tables and add data (createdefault or transfer from previous DB)
4. Edit configuration files
5. PHP File extensions
6. Login
TestLink includes installation scripts that helps you easily set-up all required configuration and
database structure.

1.3.

License

TestLink is released under the terms of GNU General Public License (GPL). TestLink is free to
use and modify. It is free to redistribute as long as you abideby the distribution terms of the
GPL.

Table of Contents
1.
2.

Scope.....................................................................................................................2
System Requirements...............................................................................................4
-2-

2.1. Clientside.........................................................................................................4
2.2. Server side.......................................................................................................4
2.2.1. μsoft SQL server doesn't support UTF-8.........................................................5
3.Installation..............................................................................................................7
3.1. Pre-installation steps..........................................................................................7
3.2. AUTOMATIC Installation......................................................................................7
3.3. MANUAL Installation...........................................................................................8
3.4. DatabaseTroubleshooting.................................................................................10
3.5. Post installation steps.......................................................................................11
3.5.1. Configure TestLink.....................................................................................11
3.5.2. Back-up TestLinkinstallation......................................................................11
3.5.3. Database back-up.....................................................................................11
3.5.4. Security...................................................................................................12
4. Upgrading..............................................................................................................14
4.1.1. Code upgrade...