Test Link
Contents
1. Optional Create a DB user for connection from TestLink Don t forget to assign a correct rights at least SELECT INSERT UPDATE DELETE for the created database The user must be defined in config db inc php Otherwise you can use any other user available in MySQL database with correct rights On Linux or UNIX you must change the permissions of the templates c directory to be writable by the webserver From the TestLink root directory run chmod 777 gui templates c Log into TestLink Default credentials are user admin pass admin Changing this password is a good security practice TestLink notifies if you don t do it After a successful upgrade you should remove the testlinkwebdir install directory for security reasons The next part involves configuring the installation to work with your specific setup See configuration section for description of configurable parameter Report any issues or feedback to TestLink Bug tracking system page Upgrading Major version upgrade You can upgrade either automatically via script or manually There are typically new functionality and several changes in database against older TL main releases I e you are not able to use directly your original database for example 1 6 gt 1 7 Hot Fix version is bug fixing release 3 4 1 Hot Fix release update Maintenance Bug fixing release is for example 1 6 0 gt 1 6 1 Database schema doesn t changed in this2. gt d m Y es gt d m Y es ES gt d m Y de gt d m Y fr gt Sd m Y pt gt d m Y g locales timestamp format array gt d m Y 5 gt gt d m Y 5 ES gt d m Y 5 Jele gt Sols PR gt oY 55 gt d m Y 5 If there is no entry in the previous arrays the value of the following configuration variables will be used g date format and g timestamp format Example of formatting date forma d amp m Y 6 Performance There are two places where could a problem happen for a large amount of data test case tree menu test report with results for particular builds 6 1 Tree menu There are three component that you can set to render tree menu of test cases Default You can receive Fatal error Allowed memory size of 8388608 bytes exhausted tried to allocate 1328642 bytes The fast solution is to use the simplest tree menu component jtree instead of default phplayermenu 7 FAQ There are listed often problems Please check also TestLink forum I upgraded from older version and I cannot login Your original database should be in different charset The default from 1 6 version is
3. 4 5 5 Filtering Test Plans by Test Project As stated before the default behavour is to filter Test Plan by Test Project Using the following configuration parameter g ui show check filter tp by testproject TRUE Allow the user through the user interface to enable disable test plan filter by Test Project A check box is displayed over the test plan combo box Force Test Plan filtering without any user possibility to change it g ui show check filter tp by testproject FALSE 4 5 6 Test Plan relation to Test Project Starting with version 1 6 when you create a Test Plan it s associated to the current selected Test Project as default This is means you can filter Test Plans by Test Project Before Teslink 1 6 the Test Plans where not associated to an specific Test Project When upgrading from 1 5 x to 1 6 it s not possible for the installer to know to which Test Project relates ogni test plan then Test Project ID is set to 0 This results in a situation where you find you can t see any of your old Test Plans To solve this problem the following configuration parameter was added g show tp without prodid TRUE You can also via DB administration assign this relation manual and use this feature for data from previous version 4 5 7 Adda new type of Test results on execution page You will need to work on following files all paths are relative to installation dir e
4. Chiv esae margin 8px padding 6px text align center Effect at user interface level will be Test case IU E Test Results on Build BUILLL v Test plan notes v Build description v Bulk TC status management Set all to status Passed Setallto status Failed Setallto status Blocked Set all to status Status ONE Setallto status Status Two u Save all executions Test Plan 7 AQ Status ONE YUMA AQ 3 Status Two FH Camruinicatiane Dep ime 10 G shock pin 3 No tester assigned z Communications 3 2 5 2 Handheld devices 2 Last execution Build BUILLL _ UN 2 Gamma Ray Storm Date Build Tested by Status attact Subspace channels 1 WS 24 01 2008 07 29 10 BUILLL admin L 4 6 GUI Customization You can configure the next parameters in config file TL TREE KIND This parameter also is used to configure tree menu Component used in TestLink Possible values are LAYERSMENU DTREE JTREE LAYERSMENU is default value The component JTREE has the best performance The two others have the ability to remember the last position in addition g fckeditor toolbar fckeditor Toolbar definition You can modify fckeditor toolbar content See fckeditor homepage for more information about this Component Instead of hard codi
5. eot 15 4 5 2 Charset dust tta BARN 15 4 5 3 Test Case Generation from p eere reden e eR ees 16 4 5 4 Duplicate names for Test Projects Test Suites and Test 16 4 5 5 Filtering Test Plans by Test oed n TA uec e e p b ER TUR 17 4 5 6 Test Plan relation to Test Project edere tit to une 17 4 6 SOLUIECUSOITZallOD s oie tu Den 17 46 1 Cascading Style a used e eden poses oed 18 CDD EA 18 4 6 3 Using Your own Smarty templates GUI definition sss 19 Attachments OM UC 19 4 82 n oto ape eR tis co Ves aD OU qu Sesame du Olea Me vt nad 20 25 Lea NZI ON es asd Noct Neon qo Nurs DM lana 22 91 2 Strmedocdltzatloti uoo e ev 22 Dateand Time Local Za Oth ROM ie eor Mte ta etit Eomae ded 22 6 Performante P n 24 GL Tree menisin ec 24 2 System Requirements We support www browsers Firefox 1 0 and higher and Internet Explorer 6 There are some issues with IE 7 because microsoft doesn t satisfy standards Generally any other browser should work if it suports javascript XHTML and CSS TestLink server req
6. Installation amp Configuration Manual TestLink version 1 7 Copyright 2004 2008 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 The license is available in GNU Free Documentation License homepage 1 Th of Scope is document serves as a reference and knowledge base for the installation and configuration tool TestLink 1 7 The first part includes the installation procedure and second part the configuration explanation The latest documentation is available on TestLink homepage You can also ask a help to solve your problems in an appropriate section of TestLink forum Summary of installation process 1 Install background services 2 Tranfer and uncompress files into web directory 3 Generate database tables and add data create default or transfer from previous db 4 Edit configuration files 5 PHP File extensions 6 Login TestLink includes installation scripts that helps you easily setup all required configuration and database structure Table of Contents 1 2 3 as S E 2 Systemi TE SUI SINGING M V 4 6 221 Pre installation Steps oo ober bed o a M peru
7. LDAP authentication needs a few more parameters to set g ldap server iilo casinos ldap port WS ldap root dn dc mycompany dc com ldap organization e g organizationname Traffic ldap uid field uid Use sAMAccountName for Active Directory g ldap bind dn Left empty if you LDAP server allows anonymous binding g ldap bind passwd Left empty if you LDAP server allows anonymous binding 4 5 Configuration of global functionality You can configure the next parameters in config inc php file TL IMPORT LIMIT is maximum upload file size in bytes Default is 204800 You could increase this value if you import a bigger file There is also parameter IMPORT ROW MAX for maximal size of one line of exported file The value 10000 characters should be enough define TL IMPORT LIMIT 204800 define TL IMPORT ROW MAX 10000 4 5 1 Printing The next strings are used in front page of printed document Left blank to disable This constants must be changed in config inc php not in custom config inc php for historical reason TL DOC COMPANY TL DOC COPYRIGHT TL DOC CONFIDENT TL DOC COMPANY LOGO define TL DOC COMPANY Testlink Comunity define TL DOC COMPANY LOGO img alt TestLink logo title Our Logo Src S BASE HREFS TL THEME IMG DIR company logo png gt derine DOCRCOPYRIGHIY link
8. you want req doc id UNIQUE IN THE WHOLE DB system wide false you want req doc id UNIQUE INSIDE a SRS 5 Localization TestLink supports localization of texts date and time There is default value in configuration but each user can set own language Language code is according to common standards g default language en GB 5 1 String localization A directory exists for every localization with a standard strings txt file inside TL INSTALL DIR locale de DE strings txt TL INSTALL DIR locale de DE custom strings txt TL INSTALL DIR locale en GB strings txt To want to change some of the original translations without changing the provided with the original file provided you can use custom strings txt You need to place this file in the corresponding localization directory and use the same format and rules used in the original strings txt If can redefine a value present on strings txt without need of commenting it on the original file Instruction and help pages has own location testlink root gt gui help lt language gt 5 1 1 Date and Time Localization For every defined locale you can set the format for date and time presentation This is configured using the following associative arrays g locales date format g locales timestamp format At time of this writting the configuration is g locales date format array GB gt d m Y
9. config inc php The benefit is that your modification is easy to copy during upgrade procedure cfg bug tracker cfg php set access to database of a bug tracking tool 4 1 1 custom config inc php Instead of make changes to config inc php we suggest to add your changes to file custom config inc php This allows you better to save your configuration for the case of update Example To configure mail server settings copy following lines into custom config inc php and make changes according to you configuration tl admin email tl admin8127 0 0 1 for problem error notification g from email testlink_system 127 0 0 1 email sender g return path email no replay 127 0 0 1 Urgent 1 Not Urgent 5 Disable 0 g mail priority 5 SMTP Configuration g smtp host localhost SMTP server MUST BE configured Configure only if SMTP server requires authentication g smtp username user g smtp password password 4 2 Configuration of Bug Tracker To enable this feature you need to change a configuration paramenter on the configuration file custom config inc php The interface is disabled by default value NO The available values are BUGZILLA MANTIS JIRA TRACKPLUS EVENTUM or g interface bugs MANTIS See system requirements chapter for supported versions The particular BTS configuration file could
10. define TL DOC CONFIDENT You must share this document 4 5 2 Charset TestLink supports UTF 8 by default g defaultCharset UTF 8 ISO 8859 1 is possible to configure for backward compatibility Advanced users also can use another set We strongly recommend to use unicode character set UTF 8 DB SUPPORTS UTFS TRUE FALSE Set this to FALSE for MySQL Versions prior to 4 1 no utf8 support so all pages have charset ISO 8859 1 and data will be stored with charset latini into the db For MySQL Versions gt 4 1 set it to TRUE to enable full UTF 8 support in pages and also data will be stored with charset utf8 into the db TL TPL CHARSET This defines a correct html charset All languages could leave this option unchanged Modify it only if you know what you do desine DENDUPENCHARSEDU Sg deraul tCharset 4 5 3 Test Case Generation from Requirement One of the unique features of Test Link is Requirement Management After creating the Software Requirements Specifications SRS and populating it with requirements you can choose to create test cases for every requirement Component and Category are also created Using the configuration object g req cfg you can configure Name to give to the Test Suite created used for generated Test Cases g req cfg gt default_testsuite name Component Created by Requirement Auto Test Suite s Scope 5 req cfg gt t
11. OK you will find the icon to add bugs in the execute screen Several checks are done when you try to add the bug BugID is present on BTS Bug ID format is valid Appendix B Revision History Description Date Author 1 0 Initial creation of the document DocXML 2005 03 12 Morsing 1 1 Corrected title updated structure and added new 2005 04 12 Havlat sections 1 2 Added some words for MySQL 4 1 UTF8 support 2005 06 27 A Morsing Description Date Author 1 3 Updated automatic installation part 2005 09 12 Mancardi 1 4 Updated for TL 1 6 added configuration parameters 2005 09 13 Havlat restructured created pre installation steps section corrected layout added phpMyAdmin steps description 2 0 Converted to OO2 format added DB Charset update 2005 12 04 Havlat explanation from Kevin 2 1 Corrected layout for export to HTML and PDF 2005 12 11 Havlat 2 2 Some small changes 2005 12 17 Morsing 2 3 Minor layout and grammar update 2006 02 14 Havlat 2 4 Updated for TL 1 7 2006 11 17 Havl t 2 5 Updated for TL 1 7 restructured merged BTS case 2007 09 13 Havl t layout update prepare for 1 7 0 release 2 6 Added several new parameters for 1 7 updated styles 2008 01 02 Havl t configuration divided into logical chapters 2 7 Fixed 0001347 0001284 0001331 2008 02 02 Havl t New sections Add a
12. be cfg bugzilla cfg php cfg eventum cfg php cfg jira cfg php cfg mantis cfg php cfg trac cfg php cfg trackplus cfg php Contains configuration parameters to access to particular issue tracking system You need to edit this file is you want to access issue information from testlink bugtracking system integration feature See Appendix for an example of configuration 4 3 Logging TestLink has own logging system You can use it for troubleshooting A log file is created for each user Configure the next parameters in config inc php file LOG LEVEL Set this to the default level of logging NONE ERROR INFO DEBUG EXTENDED Note that TestLink doesn t verify a size of a created files I e Use DEBUG level only for development or bug investigation to save disc place ERROR level is recommended for production It s default settings g_log_level ERROR LOGGING PATH The path for the logging of TestLink E g tmp for linux and c temp for winxp si TATE SE AD HM mw Dour PHP logging has Error level by default We want php errors to show up for users You can modify it of course See php net for more m ATTI 4 4 Login authentication TestLink supports two kinds of authentication MDS use encrypted password stored on internal database LDAP use password from LDAP Server Internal password is default g login method USE
13. case Backup all files of the previous version in testlink directory e Remove the all files from directory e Copy a new version to the same directory e Copy config db inc php and custom config inc php file to the new structure and modify configuration parameters acording your previous settings e Upgrade of DB is not required Exception TL main page informs you if small upgrade of DB schema is required rel 1 7 1 e Now it should work 3 4 2 Automatic upgrading major version e Follow check preinstallation steps Requirement changes e From a web browser http lt testlinkwebdir gt install index php e Choose Upgrade Installation link Run the scripts until you see that process is finished e After a successful upgrade you should remove the testlinkwebdir install directory for security reasons The next part involves configuring the installation to work with your specific setup See configuration section for description of configurable parameter e Report any issues or feedback to TestLink Bug tracking system page 3 4 3 Manual upgrading This chapter describe changes in against previous versions The automatic upgrade is recommended Use this chapter for a special cases and fiddling config You can do it of course after a study of changes in database and installation script Good idea is to compare SQL files for create db tables your current version and a new one 3 5 Backward comp
14. enabled TRUE disabled FALSE g_attachments gt enabled TRUE The type of the repository can be database or filesystem TL REPOSITORY TYPE DB gt database TL REPOSITORY TYPE FS gt filesystem g repositoryType TL REPOSITORY TYPE FS TL REPOSITORY TYPE FS the where the filesystem repository should be located g repositoryPath TL ABS PATH upload area DS We recommend to change the directory for security reason Compression used within the repository TL REPOSITORY COMPRESSIONTYPE NONE gt no compression TL REPOSITORY COMPRESSIONTYPE GZIP gt gzip compression g repositoryCompressionType TL REPOSITORY COMPRESSIONTYPE NONE The maximum allowed file size for each repository entry default 1MB define TL REPOSITORY MAXFILESIZE MB 1 Also check your PHP settings default is usually 2MBs Users should add a title for the attachment You can allow left it empty FALSE TRUE The actions for validation TRUE Default is none just write on db an empty title use filename use filename as title g attachments allow empty title TRUE attachments action on save empty title none Title is used as link description for download if title is empty what the system has to do when displaying show icon the g attachments access icon will be used show label gt the value of g attac
15. srcz TL THEME IMG DIR company logo png gt 59 logo navbar img alt TestLink title TestLink src TL THEME IMG DIR company logo png gt 4 6 3 Define HTML text editor Text data editing is solved via javascript editor with toolbar over text area FCKeditor is used by default as full featured component You can define using another editor or just simple text without formating fckeditor tinymce none use plan html textarea input field g_gui gt webeditor fckeditor 4 6 4 Using Your own Smarty templates GUI definition If You want to test a different solution for the user interface you can develop your own Smarty Templates At the time of this writting we have defined the following configuration array tpl with the following entries g tpl tcView g tpl tcSearchView 9 tpl tcEdit g tpl tcNew g tpl execSetResults This allows you to create templates with different names that the original Testlink without the risk to overwrite them during the next upgrade Note Not all TestLink pages are ready for this kind of configuration The standard configuration g tpl tcView tcView tpl tpl tcSearchView tcSearchView tpl Se o tpl tcNew tcNew tpl 5 tpl execSetResults execSetResults tpl 4 7 Attachments Attachment feature could be
16. HARACTER SET utf8 COLLATE utf8 general ci By choosing UTF8 you should also change the value of DB SUPPORTS UTF8 to TRUE in your testlinkdir config inc php See Configuration for more o Create tables for the newly created database mysql u user p lt password gt dbname lt testlinkdir gt install sql testlink create tables sql E g mysql u testlink ppass testlink var www html testlink install sql testlink create tables sql o Populate initial data for the newly created database admin account default roles mysql u user p lt password gt dbname testlinkdir install sql testlink create default data sql Alternatively you can use phpMyAdmin o Create new database from main page recommended UTF 8 character set o Optionally create a new user and assign him correct rights for the created 3 4 database o Select the created database in the left pane o Navigate to SQL window o Upload SQL request from files install sql testlink create tables sql and run the script o Upload SQL request from files install sql testlink create default data sql and run the script Create a lt testlinkdir gt config_db inc php file with the following data example lt php Automatically Generated by TestLink Installer derine IDE Vase ue derine AUD SEU cerae DE PASSU scc Mos derrite RHO STU MEI Glee aioe mesten NT
17. Mu Hp A E 6 3 2 AUTOMATIC IrstallattOti 6 CR MANUAL 7 3 4 Upgtading ETT UL mec 8 3 4 1 Hot Fix release UP Cate 8 3 4 2 Automatic upgrading major ppt 9 24 2 Rm 9 3 5 Backward equa rv FR n ena EY PU sai sme 9 3 5 1 Database schema changes eei a on e het el ed a ted sn d rte 9 LP MM enda 9 3 5 3 Obsolete functionality from M NN Pm 10 3 5 4 Test Plan relation to Test PrOJEGE ose deo dod QR P RUNE 10 3 5 5 Latin to UTF 8 conversion upgrade from 1 5 and 10 32 240 Keyword MONETE ense sus iaa disons da esi oral omi Vli cu en us eR 12 CONT OUT AU MT 13 4 1 Configuration Files OVERVIEW 13 4 1 1 iogstom config aL s 13 42 Contiguration or Bug 14 XEM COMING NR M Y 14 4 4 15 4 5 Configuration of global 2 220 01000000000 000000000908 nennen 15 qood
18. UTF 8 Try to switch DB_SUPPORTS_UTF8 to FALSE in config inc php Smarty error is shown instead of login page Smarty include C Inetpub wwwroot testlink gui templates_c 6A 6A5 6A537DD8 Slogin tpl php function Smarty include failed to open stream No such file or directory in C Inetpub wwwroot testlink third_party smarty Smarty class php on line 1247 Linux unix users Verify if write permissions are for temp directory default testlink root gt gui template c Fix by command chmod atw testlink root gui template IIS users Give the iis user write access to the template c directory Does Testlink support Secured HTTPS connection Yes it s settings of your web server lang api php Error is shown instead of login page Fri Now 02 error client Fatal error Call to undefined function iconv in home qa site lib functions lang_api php on line 54 Note to Windows Users In order to enable this module on a Windows environment you need to put a DLL file named iconv dll or iconv 1 3 dll prior to 4 2 1 which is bundled with the PHP Win32 binary package into a directory specified by the PATH environment variable or one of the system directories of your Windows installation This module is part of PHP as of PHP 5 thus iconv dll and php_iconv dll is not needed anymore How to upload images into text http www teamst org index php opti
19. atibility 3 5 14 Database schema changes user password is encrypted 1 5 A new tables for SRS feature requirements req coverage requirement doc 1 6 Attachments 1 7 Custom fields 1 7 3 5 2 Terminology Product gt Test Plan Component Category gt Test Suite 3 5 3 Obsolete functionality from 1 7 Personal metrics on main page parameter MAIN PAGE METRICS ENABLED 3 5 4 Test Plan relation to Test Project TL 1 0 4 has not relation Test Plan relation to Test project Product The solution from TL 1 6 table include field TestProjectID in the Test Plan table Test Plans could be available over all Test projects Products Such Test Plan has TestProjectID value 0 Configuration within testlink root config inc php g show tp without prodid 1 Sg ui show check filter tp by testproject 1 3 5 5 Latin to UTF 8 conversion upgrade from 1 5 and older TestLink 1 6 allows for UTF 8 encoded character rendering therefore any extended character data that may have snuck into your database and didn t show up in 1 5 may start appearing in 1 6 UI You can turn UTF 8 support off in testlink by modifying a value in the testlinkinstalldir config inc php file but then you will be missing out on the ability to use characters beyond ASCII If you have the same problem I did and see lots of extended characters appearing in your data after upgrading to 1 6 and having UTF 8 supp
20. cfg const inc php custom config inc php lt create it if do not exist yet e locale en GB custom strings txt lt create it instead of editing strings txt gui themes theme m2 css testlink css 1 Open cfg const inc php and search for g tc status 2 Copy following lines into custom config inc php 3 Add new statuses and save tcstatus 1 gt code tcstatus 2 gt codew 4 custom config inc php will be tcstatus 2 gt w Sig Starts CSS array 15 lt Starts p g tc status verbose labels array gt suene starus Moone gt Hrest Suecus MoL Hassa gt Voest Storis vassal bech gt test stetus meuble Upleckect aee kedi M pet ToU unknown gt test status unknown tcstatus 1 gt test status new one tcstatus 2 gt test status new two g tc status for ui array gt Wrest stats posses gt rest starus tcstatus 1 gt test status new tcstatus 2 gt test status new two radio button selected by default g tc status for ui default blocked 5 Modify css if you want new colors I 1 1 olor black background yellow sieKes ubis 2 Cily testatus 2 T Colon black background orange
21. de html octal table you can see octal values 000 177 are normal ascii characters The perl script that is provided searches based on octal values http web cs mun ca michael c ascii table html description of tr perl operation http www unix org ua orelly perl learn ch15 05 htm 3 5 6 Keyword Management If you don t want to create multiple times the same keyword for the same Test Project g allow duplicate keywords FALSE 4 Configuration This chapter describe the most important configuration parameters Additional information are together with parameters definition in configuration files 4 1 Configuration Files overview All configuration parameters are inside the file config inc php and included files For this release these are the configuration files lt testlink installation directory gt config inc php lt testlink installation directory config db inc php testlink installation directory custom config inc php testlink installation directory cfg bug tracking system cfg php config inc php Main configuration file This file is included into nearly each page See below for more config db inc php Contains configuration parameters to access the database This file is created by the installer during the installation or upgrade process Normally you don t need to change it manually custom config inc php serve for modification of default values of parameters in
22. estLink main directory gt cfg mantis cfg php Environment example TestLink and Mantis installed on the same web server Mantis URL http calypso mantis Test Link URL http calypso testlink MySQL user password to access Mantis mantis bt user mantis bt password DB Anonymous login into mantis has to be turned on A mantis user with viewer rights to all public projects must be created anonymous account Change add following lines in your mantis config inc php replace dummy with the anonymous account you will use Allow anonymous login i anonymous g allow anonymous login ON g anonymous account dummy A III Enable BTS integration Check the following lines from config inc php Bug Tracking systems g interface bugs NO and closed bugs If they are it will strike through them no bug tracking system integration BUGZILLA edit configuration in TL ABS PATH cfg bugzilla cfg php MANTIS edit configuration in TL ABS PATH cfg mantis cfg php 0 TestLink uses bugtracking systems to check if displayed bugs resolved verified Copy it to custom_config inc php and change line g interface bugs NO Final result g interface bugs MANTIS A IV Check interface After your configuration is
23. estsuite details Component Category Test Cases generated from Requirements For the Test Suite name you can configure the following options g req cfg use req spec as testsuite name TRUE Then REQuirement Specification Title is used a Test Suite name g req cfg use req spec as testsuite name FALSE Then g req cfg use req spec as testsuite name is used a Test Suite name 4 5 4 Duplicate names for Test Projects Test Suites and Test Cases As you know is possible to create one of this objects Test Projects Test Suites and Test Cases doing a copy of an existing one You can configure how to proceed when the copy is done if you set g check names for duplicates TRUE then the following checks will be done 1 Test Project name is unique 2 Test Suite Name inside Test Project is unique 3 Test Case Name inside Category is unique One you have set g_check_names_for_duplicates TRUE you can configure how to proceed if a duplicate name is found using g action on duplicate name The options are e allow repeat allow the name to be repeated backward compatibility with version 1 0 4 and 1 5 x generate new generate a new name using the value of g prefix name for copy and the original object name block return with an error Example of formatting g action on duplicate name allow repeat g prefix name for copy strftime SY m3d H 3M S time
24. ext steps if not localhost Next untar gunzip it to the directory that you want The usual command is 1 step tar zxvf lt filename tar gz gt or gunzip lt filename tar gz gt tar xvf lt filename tar gt Winzip Stuffit 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 simpler like testlink You will use the mv command to rename a directory Windows users substitute the ren command or use explorer mv directory name testlink Continue Installation or Upgrade AUTOMATIC Installation TestLink includes installation scripts that helps you setup all required configuration and database structure The following details the basic steps for installation on any system The instructions may seem unix centric but should work fine on Windows systems Barring complications it should take you about 10 30 minutes to install configure and be using TestLink This installation process has changed with release 1 6 Next we will create the necessary database tables and a basic configuration file 1 From your web browser access http lt yoursite gt testlink install index php 2 This page will walk through the following steps check basic parameters for the web server php config and DB version prompt for the database type and location and a database user password pair For installatio
25. hments access string will be used g_attachments gt action on display empty title show icon g attachments access icon img src THEME IMG DIR new f2 16 png style border none gt 5 attachments access string You can set own display order of uploaded files g attachments order by ORDER BY date added DESC 4 8 Requirements Requirement functionality could be enabled disabled on Test Project level not configuration via Test Case could be generate from Requirements TestLink will create such Test cases into special Test Suite You can define that the related SRS title is used TRUE use req spec as testsuite name FALSE gt test cases are created and assigned to a test suite with name g req cfg default testsuite name TRUE REQuirement Specification Title is used as testsuite name f Dgaseg esge cuseaseg specllasatesisuieanmames The next test suite title is used if you set the previous parameter as FALSE 59 req cfg gt default testsuite name Test suite created by Requirement Auto The next default text will be added here 9 req cfg 5testsuite details lt b gt Test suite Test Cases generated from Requirements lt b gt g req cfg 5testcase summary prefix b Test Case generated from Requirement lt b gt lt br gt Requirement identification string must be unique true
26. n an administrative user password pair can also be provided The operating user requires ALTER SELECT INSERT and UPDATE privileges For installation INDEX CREATE DELETE and DROP privileges are also required create the database and tables Warning A DEFAULT ADMINISTRATOR level account is created Use this when you first login to TestLink Immediately go to Manage and create at least one administrator level account You can recreate it but you should delete the account to prevent the cookie_string from being used to trick the package It would be even better to rename the account or delete it permanently SECURITY After setting up the package remove the default admin account perform some post installation checks on the system 3 After a successful upgrade you should remove the lt testlinkwebdir gt install directory for security reasons 4 The next part involves configuring the installation to work with your specific setup See configuration section for description of configurable parameter 3 3 MANUAL Installation If you want to perform a Manual installation not recomended here are the steps needed for a successful installation For installing the DB you can either choose the command line tools available in your MySQL installation or any MySQL Database Client e g phpMyAdmin Prepare MySQL via command line tools o Create a new empty MySQL database for MySQL gt 4 1 with UTF8 do CREATE DATABASE testlink C
27. new type of Test results on execution page drafted by Francisco Define HTML text editor
28. ng attributes of html inputs like maxlength and size we have code it on TL INSTALL DIR gui templates input dimensions conf 4 6 1 Cascading Style Sheet You can change TestLink appearance writing you own CSS Cascading Style Sheet files You have to change the following constants define TL LOGIN CSS gui css tl login css All Login Logout pages CSS define CSS gui css testlink css Main CSS define DOC BASIC CSS gui css tl doc basic css Used in Reports Important paths to CSS are relative to the testlink installation directory If you want to use your own CSS files we suggest you to proceed as follow 1 create a new directory inside the gui directory example gui css my css 2 copy the testlink original files to the new directory you can change the names if you want 3 modify them at your will 4 edit config inc php Original configuration define TL LOGIN CSS gui css tl login css define TL TESTLINK CSS gui css testlink css define TL DOC BASIC CSS gui css tl doc basic css define TL LOGIN CSS gui css my css tl login acqua css define TL TESTLINK CSS gui css my css testlink acqua css define TL DOC BASIC CSS gui css my css tl doc basic css 4 6 2 Logo You can set own logo instead of TestLink default 5 logo login page img alt TestLink title TestLink
29. on com_content amp task view amp id 43 amp ltemid 2 Allocated memory problem for tree menu Fatal error Allowed memory size of 8388608 bytes exhausted tried to allocate 16 bytes in wamp www testlink173 third party phplayersmenu lib layersmenu common inc php on line 795 phplayersmenu is resource expensive Switch to another tree component jtree or dtree Add into custom config inc php g tree type JTREE Appendix A Setup Mantis bugtracking system integration A I Overview The integration between TestLink and a Bug Tracking System BTS has the following characteristics All communication between Test Link and the BTS is done through database tables TestLink at the time of this writing is neither able to send data to the BTS either able to receive data from the BTS in the traditional model of function call After all the configuration is up and running from a TestLink user point of view the process will be 1 While executing a test it fails 2 User saves execution result 3 User clicks on link that opens BTS web page used for issue reporting 4 After issue reporting user has to take note of issue ID assigned by BTS to input it into TestLink 5 User returns to TestLink test execution page and writes the issue ID in the bug input 6 After user saves the execution TestLink will display data taken from the BTS database A II Mantis DB Configuration Edit file your T
30. ort turned on you should read through the following instructions Be sure to practice this exercise on a test machine before performing on your deployment system The instructions will help you clear out any non ASCII characters from your database and setup your database to support UTF 8 e First make a backup of your current database using the mysqldump utility usr bin mysqldump u root testlink15 p gt testlink15 backup Now edit testlink15 backup so schema definitions for EACH table has utf8 encoding specified Change the CHARSET for each table from latini to utf8 For example the following line in the definition of 1 table which reads as follows ENGINE MyISAM DEFAULT CHARSET latinl COMMENT This table holds the bugs filed for each result should be changed to ENGINE MyISAM DEFAULT CHARSET utf8 COMMENT This table holds the bugs filed for each e Then ran testlink15 backup thru my the perl script below as follows replaceScript pl lt testlink15 backup gt testlink15 cleaned replacesceript piisas follows e Created an empty testlink16 db with utf8 charset as follows e Install the tables into the new database You can verify your database s Db characterset is now set to utf8 by using the following command e Run the upgrade installation provided by Testlink 1 6 Other resources what the heck is UTF 8 http www joelonsoftware com articles Unico
31. uires these applications as background Database MySQL 4 1 x and higher 4 0 x doesn t support UTF 8 Postgres 8 x and higher MS SQL 2000 and higher experimental php 5 x and higher at least version 5 2 is recommended Webserver Apache 1 3 x or 2 x and higher IIS 3 and higher etc See php root install txt for more information Bugtracking system optional Bugzilla 0 19 1 and higher e Mantis 1 0 1 and higher JIRA 3 1 1 and higher e TrackPlus 3 3 and higher Eventum 2 0 and higher Trac 0 10 and higher There is no requirement about your operating system tested on Linux and MS Win32 You can run also your database on different server than TestLink php scripts scripts 3 Installation You can use automatic scripted installation or manual steps If you are upgrading from a previous version of TestLink look at the Upgrading section 3 1 Pre installation steps Do the next steps before installation 1 3 2 Install environment Webserver with php5 and database MySQL or Postgres Refer to documentation of these products You can also find installations package of all these products and install it together for example XAMPP EasyPHP Uniform Server etc PHP4 is not supported from TL 1 7 version Transfer the TestLink installation file to your webserver using whatever method you like best ftp scp etc You will need to telnet ssh acces into the server machine for the n
Download Pdf Manuals
Related Search