Home

TestLink - User Manual - Testlink 1.9.14 [DEV] (Padawan)

1. Installation amp Configuration Manual TestLink version 1 9 Version 2 15 Status Updated O 2004 2010 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 0 1 1 1 2 1 3 1 4 2 0 2d 2 2 2 3 2 4 2 5 2 6 2 7 2 8 2 9 2 10 2 11 2 12 2 13 2 14 2 15 Revision History Description Initial creation of the document in DocXML Corrected title updated structure and added new sections Added some words for MySQL 4 1 UTF8 support Updated automatic installation part Updated for TL 1 6 added configuration parameters restructured created pre installation steps section corrected layout added phpMyAdmin steps description Converted to 002 format added DB Charset explanation from Kevin update Corrected layout for export to HTML and PDF Some small changes Minor layout and grammar update Updated for TL 1 7 Updated for TL 1 7 restructured merged BTS case layout update prepare for 1 7 0 release Added several new parameters for 1 7 configuration divided into logical chapters updated styles Fixed 0001347 0001284 0001331 New sections Add a new type of Test re
2. cols the number of cols for tinymce and none e rows the number of rows for tinymce and none B a Hint After doing configuration changes clean you Browser s cookies and cache You could modify used editor toolbar or configuration for particular pages You can not define new areas without making changes to php code A RS on gt tease O executor axzayl Cope SS meme C E aa Performance with a lot of testcases ei Aus cont Ote Eo is NOChU cn Jetta pese TOO edson E SELLOS gt UL gt ez edo desiqu array coolser gt Val migas a ELE Soul Ske ceiicor vesigelam eicway use none fi Geleia UL teme celson loud apre o Cespe gt iekecdicon cooler gt dao eia an O E Ff elie a cesso selivor uses iso sal etc o yo gt Coina Do fi Quico eua gt ter cclicor colle astenh unos gt nes 5 IS gt A Ao AS A II A A none E Guilciiea gt E requirement Soee axcayl e gt none Performance warning The problem is that fckeditor uses iframe and each iframe needs to download fckeditor files So too much editors on page could make the loading problem 5 7 4 CKEditor custom configuration CKEditor could be configured via settings in file lt testlink gt cfg tl fckeditor config js This file include toolbar definitions and options as described in the editor documentation FCKeditor 2 x Developers Guide Configuration Configuration Options Past
3. eles LO es OOS rest lino drwxiwkrws 2 1024 Seo 30 11 12 testilinki33 drwxrwxrwx 12 1024 Jan 8 09 16 testlink184 drwxr xr x 12 1021 Soo O S restlinkico e From a web browser run http lt testlinkwebdir gt and you will be redirected to installation script http lt testlinkwebdir gt install index php e Choose Migration from link if your original version is available in menu Read and follow procedure steps e Run the migration scripts until you read that process is finished For example your version is TL 1 6 3 Run scripts under Migration from 1 6 2 to 1 7 x then run scripts under Migration from 1 7 2 or greater to 1 8 0 link e After a successful upgrade you should remove the lt testlinkwebdir gt install directory for security reasons e Check configuring for changes We add modify and remove configuration parameters Especially TestLink 1 8 means conversion of a lot parameters to new singleton structure tICfg See configuration section for description of configurable parameter e Check forum for troubleshooting Report any issues or feedback to TestLink Bug tracking system page Note Upgrade from version 1 6 and older to 1 7 needs to use the large scripted database migration because of major changes in DB schema It is an extra action in installation script follow the instructions of the script Warning scripts will extend web server PHP time limits you can need to enhance it more for huge amount
4. array Side Sol gt Esc eciter eres 0 y FCKeditor component is used by default as full featured component This is rich featured component and could be easily enhanced via configuration to allow more features and enhancements Side SC cet contem Med amasol ype d E Toop e ul E Se ewe AA O O 6S 5 This configuration will be used if no element with search key area is found on this structure Every element is a map with this configuration keys Parameter type fckeditor tinymce or none gt use plain text area input field The next line modifies using to a plain text in all places Se Ciro eai gt Es sob cor A a A SS AS FCKeditor Toolbar definition allows disables icons in text area menu We recommend to investigate it The default testlink toolbar definition is tl_default The customizable toolbar tl_default is defined in lt testlink_root gt cfg tl_fckeditor_config js file You can modify the content of toolbar as well as other configuration parameters for example templates styles spell checker etc See fckeditor homepage for more information about the component ToolbarSet Parameter configFile is also only applicable for type fckeditor See http docs fckeditor net for more information about CustomConfigurationsPath For example the next attributes could be defined by this parameter height the height in px for FCKEditor e width the width in px for FCKEditor
5. 4 2 2 Changed Terminology We continuously clarify terminology to fit testing standards You will experience the next changes e Product TL 1 6 gt Test Project e Component Category TL 1 6 gt Test Suite Test priority TL 1 5 gt Test urgency TL 1 8 Test priority composes from Importance and Urgency 4 2 3 Obsolete features The next feature was removed from TL 1 8 e Personal metrics on main page parameter MAIN PAGE METRICS ENABLED 19 4 2 4 Test Plan relation to Test Project upgrade from 1 5 and older Starting with version 1 6 when you create a Test Plan it s associated to the current selected Test Project as default TestLink 1 7 automatically offers to assign not associated Test Plans It Is not possible to share one Test Plan over more Test projects now Backward compatibility The solution in TL 1 6 tables 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 Warning unassigned Test Plans are not officially supported TestLink 1 7 automatically offered to assign not associated Test Plans You can also via DB administration assign this relation manually and use this feature for data from previous version Filtering Test Plans by Test Project As stated before the default behaviour is to filter Test Plan by Test Project Using the following configuration parameter se Ma Simon Cliscis da lite
6. ERROR INFO DEBUG EXTENDED Note that TestLink doesn t verify the size of 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 stc Los lemel GININOIR LOGGING OUTPUT There are two output channels files and database Both ways are up by default Set the next parameter to false if you would like to disable one or both channels og Loser Cite mule 4 ell Losgenas enalolec dedemlo oe Loc 0 clo enel FALSE true false So logge re fa tile enabled salon true false LOGGING PATH The path for the logging of TestLink E g tmp for Linux and c ltempl for winxp SECO OS postea SW NSS Ia oe Ds Note Using debug level for your production server can generate large files You can consider to create a script for periodic clean up PHP environment logging has Error level by default We want php errors to show up for users You can modify it of course See php net site for more SiO Soda ag VE MA SMARTY DEBUG WINDOW Developers should use this parameter to show extra window with list of all parameters and values that are sent from php script to Smarty template component The parameter must be false for production installation aC gt simetcey cleloug false 24 Show warning on login page and main page if there are security weak points The message is enabled by default TRUE Val
7. So 1 began removing permissions until I received and error Having both accounts with only R W E permissions allowed the application to load but everytime 1 would move to a new page of the TL web application I would receive the smarty error To fix this issue I had to give the IIS WPG account R W E M permissions This fixed the errors and they system is now running fine I found a MS KB article that describes this account in more detail and I will be reviewing it to make sure I have not left any security holes with this permission setup SBA Appendix A Recommended configuration parameters There is a list of parameters that users modify in the most of cases g smtp host g tl admin email g from email g return path email 9 interface bugs tICfg gt document generator gt company name tICfg gt document generator gt company copyright tICfg gt document generator gt confidential msg tICfg gt company logo g default language tICfg gt api enabled 55 Appendix B Set up Mantis bug tracking system integration B 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 except Trac 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 co
8. al Do not postpone back up to never CIE 3 5 4 Security Is it safe to use TestLink over the Internet I mean if I put critical requirements cases in TestLink and access it without VPN from my home what are the chances that data will remain secure We implement robust security features There is a role related system that allows access to certain pages only All input data are verified against danger characters Displayed data are also escaped if it s appropriate We recommend the next steps 1 Remove or disable default admin account 2 Remove installation directory 3 Use https protocol for access You can use certificates if you like 4 Dont share testlink URL on internet 5 Set up backup script to run every day 6 Configure all directories for temporary files write access required to non default path gui templates c logs upload 7 Disable write access for code directories I recommend to use linux apache These hints are not mandatory but highly decrease chance of attack 16 4 Upgrading There are two possibilities you need update DB schema or do not This DB schema update is required for major version upgrade You can upgrade either automatically via script or manually Release notes should state when DB schema update from the previous version is required 4 1 1 Code upgrade only This upgrade is common for bug fixing releases or release candidates Maintenance Bug fixing release i
9. copy during upgrade procedure cfg lt bug_tracker gt cfg php set access to database of a bug tracking tool cfg const inc php define constants and variables that are not supposed to modify gui templates input_dimensions conf Instead of hard coding attributes of html inputs like maxlength and size we have code it into this file there are exceptions for historical reasons e cfg tl_fckeditor_config js set up fckeditor component configuration 5 1 1 Use custom_config inc php for your changes Instead of making changes to config inc php we suggest adding your changes to file lt testlink root gt custom_config inc php This allows you to save your configuration in the case of update Example To configure mail server settings copy following lines from config inc php into custom config inc php and make changes according to your configuration if ls as O E CIN CO meleMiceteOn E Cusco eos e oo Sep EL Sima mel cence lice Semis crus SE wom Ewe gt testlink evstentccams cora DB Sep Lea saco email mo reolayiteamet ces E Sg ento most 10 20 30 40 s 5 2 Logging TestLink has its own logging system with two possible output channels files and database Records in database are visible via GUI You can use it for troubleshooting A log file is created for each user Configure the next parameters in custom_config inc php file LOG LEVEL Set this to the default level of logging NONE
10. gt Meo 5 silicio EI T siestas elos eta Ge T HE EE EE Ke ET ES EE nor cin pesca Ces Status Ossie real sor gt Messi sue cvs ter lec oo o TE Sree Ps Pais loco meu vallas leo cast Scars mor salas et unknown Veces e peles Lal dachias o SE Cie resullies a laloe for exe ul pas scan o sis rails Passed ro A gt E MIEN SC gt ess belt Us Jollee xecl 39 array Melhore gt estes elsa testa cs o 3 Add new statuses and save tcstatus 1 gt code q tcstatus 2 gt code w 4 custom config inc php will be Sig Cire ise Sites veel array Mie Ela LS cae er locked gt Do passed RA Oe SEO E TIO gt In T SA a unknown gt u cal Se ME testatus 1 gt q testatus 2 gt w Ci ss Des Sicercis Lele lo amena are o SE Sd See Sie ate SE ecc Sa ES IO PA pass cd Sto sis telas Sea le cl INES gt Bice CUS e MEA res star loca OR a SS SS scene a ie unknown SS LS afete A me wing Te tcstatus 1 gt test status new one testatus 2 gt test status new two Sig luC ie ses sue teense eles For e ese mt CS also ass cana reste colista e Ms ISO MS vn SS So o Polo checa cessar ls aca tcstatus 1 gt test status new one testatus 2 gt test status new two Salio esti donas Pat sal blocked 5 Modify css if you want new colours AQ es pelle a Do Colom ola lso backgrounds
11. id req Spec Sie Cite gt eee Cie T SPAS E 5 12 Configuration of misc functionality 5 12 1 Data import limits Web servers have defined a maximum upload file size PHP allows to clarify this limit and testlink uses default 409600 bytes You can call the phpinfo function to find the location of 45 your php ini file it will also tell you the current values for the following settings that we need to modify e file uploads e Upload max filesize e max_input_time e memory_limit e max execution time e post max size You could increase this value if you import a bigger file There is also parameter limiting maximal size of one line of exported file The value 10000 characters should be enough SECS aimpore max size ISSUE Sloan eo CIMO OR Note attachment repository has an extra constraints 5 12 2 Default user role Set the default role used for new users This values is used for users e created from the login page e offered by default when using user management e when their original role definition is deleting from TestLink sli L HEE oleic Wh Olas CUES Possible values TL ROLES TESTER TL ROLES GUEST TL ROLES NO RIGHTS and similar constants defined by you See const inc php for more 5 12 3 Time out limit Set the session time out for inactivity in minutes Default value of this internal limit is 60 minutes Time out is limited by both php ini and this parameter Lower value is applied Some a
12. install txt for more information Hint Improve security by using https protocol if your server is accessible from internet You need to configure your server not TestLink There is an exception collaboration with your bug tracking system BTS must be accessible without SSL PHP 5 2 and 5 3 PHP 6 0 was not available in the time of development and is not supported optional GD library with Free font support is required for Charts rendering Bug tracking system optional collaboration Bugzilla 0 19 1 and higher minor version Mantis 1 0 1 and higher minor version JIRA 3 1 1 and higher minor version TrackPlus 3 3 and higher minor version Eventum 2 0 and higher minor version Trac 0 10 and higher minor version Fogbugz 3 1 9 and higher minor version Gforce unknown version Redmine 0 6 3 and higher minor version Users help welcome We are looking for un compatibility reports for high versions of supported Bug trackers 2 2 1 soft SQL server doesn t support UTF 8 Some applications especially those that are Web based must deal with Unicode data that is encoded with the UTF 8 encoding method SQL Server 7 0 and SQL Server 2000 use a different Unicode encoding UCS 2 and do not recognize UTF 8 as valid character data This article discusses some options for dealing with this situation This limitation is valid for versions 2000 2005 There could be options Use a better database engine Use UCS 2 instead of UTF 8 Configu
13. of migrated data InstanceMaxRequests 10000 EnvironmentVars PHP FCGI MAX REQUESTS 10000 RequestTimeout 10000 Activity Timeout 10000 4 1 3 Manual upgrading The automatic upgrade is recommended However there are cases that user cannot use it For example upgrade from Beta versions or user has own incompatible DB schema changes 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 See testlink install sql lt db type gt testlink create tables sql DB schema should be modified via any DB administration tool then for example phpMyAdmin for MySQL 8 Older versions You can download previous TestLink version s and migrate in sequence between releases 9 You should run Upgrade Installation link before run the migration for 1 7 gt 1 8 e 4 2 Backward compatibility 4 2 1 Database schema changes New and enhanced functionality results into adaptation of e user password is encrypted 1 5 e A new tables for SRS feature requirements req coverage requirement doc 1 6 e Attachments 1 7 e Custom fields 1 7 e Test Suites 1 7 e Test Case versioning 1 7 SRS tree support 1 8 e Test prioritization 1 8 Events logging 1 8 e Inventory 1 9 e Test case steps 1 9 e Requirement versions 1 9 Note See lt testlink root gt install sql alter directory to see exact syntax of changes
14. printing of pages e t documents css used for generated documents for example Test Specification e tl_treemenu css specific settings for tree menu These filenames are defined as constants in const inc php file You could be modified it if you need to You can set own logo instead of the default TestLink image You must copy your image file into gui themes default images directory or within you layout theme to allow it SE companlogo AS Mp y OO Note This logo is used for both GUI and generated documents Login page could show the informational text in html format The value is empty by default SiC we S LOG ato Ss Please contact aecihm on stracor lt a href mailto jack caribic sea gt G B Shaw lt a gt if you have any question lt p gt You can modify the filename of bullet image Default schema includes arrow org gif and slide gripper gif default S TET ines slide ciemjyoei qui To specify the Test Project background colour S quito supo escollo mob ale legs Sa al Open the page edit Test project to specify particular colours Default value is none no background colour change is allowed e Default background colour is defined SlCr qui ac koro tato lo DEDE Set up a way to display name and surname instead of login only Specify a format of displayed name EC ms else tome gt LSO as ls Examples YofirstYo Yolast gt John Cook Mlast Yofirst gt Cook John YofirstYo Ylast Yl
15. strings txt You can redefine a value present on strings txt without need of commenting it in the original file Instruction and help pages have their own location lt testlink root gt gui help lt language gt 6 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 and Sg locales timestamp format At time of this writting the configuration is 9g locales date format array en GB gt S d Sm Y it _IT gt 2 d m Y es AR gt d m SY es ES gt d m Y MCS IOI Se ES a e O att aN We SY o aa ee Sg locales timestamp format array em GB gt 3d sm 2Y 3H 3M 2S A oc omy us ato cour es AR gt d m Y SH SM SS es ES gt d m SY H 3M S de DE gt Ed Sm SV MSN didi IIR oe rel H oie eS ot BR gt Sd m SY H 3M S 48 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 Sg date format d m Y Sep IMSS E o telas A so alla que Gs 6 1 2 Character set TestLink supports UTF 8 characters by default The character set value is used for both data database and GUI Smarty templates We strongly recommend using Unicode character set UTF 8 ISO 8859 1 and other char sets can be configur
16. to iy tesigomejqece Mv 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 OC tal Sino check Melee do Oy ESE SIO Scie DAS 4 2 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 lt testlinkinstalldir gt 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 support 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 set up your database to support UTF 8 e First make a backup of your current database using the mysqldump utility toy Use bin Ms q lau Suco bese link gt Co e link gt backup e Now edit testlink15 backup so schema definitions for EACH table has utf8 encoding specified Change the CHARSET for each table from l
17. yellow ques es ess O swesiwclielis 2 Color RR background orange ce gt vers e gt tels 2 margin px padding CPx text align center So oo Effect at user interface level will be LLE RESULS USE AUDITS ALA FEL aL TEST case 2 LUS LFU L L Test Results on Build BUILLL Test plan notes Build description Bulk TC status management set all to status Status ONE Not Run ee Passed Failed Blocked Status ONE YUMA aq 3 Status Two fa Marana raie hane PD MMI cr 10 G shock No tester assigned YUMA AQ 3 El Communications 3 Ea Handheld devices 2 Last execution Build BUILLL N Z Gamma Ray Storm Oe Subspace channels 1 A Build Tested by 2401 2008 07 29 10 BUILLL admin 5 9 Test Specification Layout of steps and expected result text area could be horizontal steps and expected results panes are side by side vertical steps pane is above the expected results default behaviour OG jose Cee Sse os results Les oute Mente eel Availability of test suite filter in the test specification navigator ENABLED gt User will see a test suite filter default behaviour DISABLED gt no filter available OC SSC Cie a SUS ea lie SPAIN Refreshing of Test specification navigator ENABLED gt every time user do an editing
18. IN related COMM UTAUION aca 28 Orla GWT CUStOMIZa CON dia 29 Iele E AA A SD CS E 29 Li UL La YOU Eo aus id DS ada SS Uau ada Da Da ASS Das eu LA 30 Did EXE area CUM a 32 SA lt CKEGICOF c stom CONTIGUA CON a 33 Sos TOO MENU CONNUT Oois aa O a o aaa 34 Os JAVA SC Pla des ana ATOS Ue O di 35 5 7 7 Using Your own Smarty templates GUI definiti0N cccccccccccccnncccnnnnnncncnn ns 35 5 0 Test GxGCuulony Setas css irreal aa La anil auTE 36 0d EXCCULON MISCO ada ies 37 KOA Mest execution navigator ise o asd E a doo tocada 37 5 8 3 Add a new type of Test results on execution PaQl occcccccccccccnnccnnnnn ca rnnn nac 39 Bo TestspeciicacO Nana ar 42 S91 Test specification templates aiii a 42 5210 Ataca 43 vida Requirements SUD DO ii odes Di a iu ss ee a aa 44 5 11 1 Generated Test Cases from Reguiremente c see ce e x e x e c x e K x e K x e e e eee 45 5 12 Configuration of misc functionality asia a r Li a le Data IMPOR MITS assar ns Io Casada a O o 3 5 12 1 AA A Sei Ole assa qi a a duguaeuniaedats A A SA A A A A 5 12 4 Title duplicity of Test Projects Test Suites and Test Cas8S occcccccccnnnnccnanananos 5 12 5 String checking and COnverslOng cc ccs cs scs secs e x e ce e e ereenn 6 Localization Onis SEIO JOCAZAUON erernu rd 6 6 Tole Date ana Time Bee lt 1 TEZ lt 1s OMisccvdewsraexdaasbsadtauseddvcesaroacteatwaext Gs bus deousredtedcbutanenens A A A ene eee 6 15 GUI Special ChHaraCh
19. INGS Dis CaS E AS DE e define EUG HUN CDE i T AS T s EE H E LES a SET MINACIS DIB PASS 5 joeisisimo lee E The constant BUG TRACK DB TYPE is related to supported DB types of ADODB component 5 3 2 TRAC configuration TestLink connector to TRAC uses XML RPC communication instead of direct access to database There is a few settings on TRAC side at first e The XmlRpcPlugin plugin should be installed in your Trac See http trac hacks swapoff org wiki XmIRpcPlugin e Add the permission of TICKET VIEW and XML RPC to the user anonymous in Trac Now configure the next parameters in testlink cfg trac cfg php file URL of TRAC plugin demas TUE TRAGA DE MOST mtrs Motta T You must map TestLink test project name against Trac project name part of URL Sg interface bugs project name mapping array o ES lt YOUrTRACeRenecel lt VOUrMLVeSstProcseceName2 gt Volum rasero eee 7 Enable BTS integration On custom config inc php create line Sg interface E BAC 5 3 3 BTS character set Garbled characters in BTS integration Check character set of your BTS database There is nothing to configure if it s the same like your TestLink database Configure the next constant in the corresponding bug tracking system configuration file directory testlink cfg if char set differs Character set can be defined like define BUG TRACK DB CHARSET ISO 8859 1 5 4 Generated documents The next
20. L request from files install sql testlink create default data sql and run the script e Create a lt testlinkdir gt config_db inc php file with the following data example lt php Automatically Generated by TestLink Installer Clee skins De MA y o ole ine DIE US esste minlkeie y ASIN We ASS H pass VE derine CPE PO Io e Niles I SNE Di Nal Cell Me Ue aS e 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 e Log into TestLink Default credentials are e user admin pass admin e Changing this password is a good security practice TestLink notifies if you don t do it e After a successful upgrade you should remove the lt testlinkwebdir gt install directory for security reasons e The next part involves configuring the installation to work with your specific set up See configuration section for description of configurable parameter e Report any issues or feedback to TestLink Bug tracking system page 3 4 MS SQL Database Troubleshooting Do you have problems with database Modify and run the next script The code fits MS SQL kind lt pap smyServer localhost SmyUser sa smyPass passwordl SmyDB testlink connection to the ca
21. SABLED gt disable Selic F SSO Cl mail cerco ea cc coloma ENREDO SECO See cts mb meee Coumcses solevieias ENA E Controls what happens in right frame when user clicks on a Test suite on tree menu Disabling this setting can help to avoid performance problems ENABLED gt show all test cases presents on test suite and children test suite old behaviour jas DISABLED gt nothing happens to execute a test case you need to click on test case DEFAULT VALUE MECO e Cig gt son Test suits coments Ul VAZIbE ID TBD applicable for which tree menu component Allow to edit execution notes on old executions Attention user must have test case execution right ENABLED gt user can edit execution notes on old executions Attention user must have test case execution right DISABLED gt no edit allowed DEFAULT VALUE STO eo cile 2ecit notes DISSED Filter Test cases a user with tester role can VIEW depending on test execution assignment all gt all test cases assigned to me gt test cases assigned to logged user DEFAULT VALUE assigned to me or ree gt test cases assigned to logged user or not assigned SEllCiie gt erec cl gt vis nmode gt resterc assioqued to me Filter Test cases a user with tester role can EXECUTE depending on test execution assignment all gt all test cases assigned to me gt test cases assigned to the current user DEFAULT VALUE assigned to me or fr
22. TF 8 http www joelonsoftware com articles Unicode 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 orell erl learn ch15 05 htm DD 5 Configuration This chapter describes the most important configuration parameters Additional information are together with parameters definition in configuration files Localization and API configuration are described in extra chapters below Note TestLink 1 8 introduced a new class tICfg to hold overall configuration Not all parameters are migrated yet 5 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 e config inc php Main configuration file and wrapper for other configuration files The file lists default values of configuration parameters 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 e custom config inc php serves for modification of default values of parameters in config inc php The benefit is that your modification is easy to
23. atini to utf8 For example the 20 following line in the definition of a 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 results Then ran testlink15 backup through my the perl script below as follows replace or IPE pl Eee ank G Upe a bese anka cleaned replace ocr IO pi mesas follows usr bin perl while lt gt 4 chomp E OOO AUD ees PS A Created an empty testlink16 database with utf8 charset as follows CREATE DATABASE testlink16 CHARACTER SET utf8 Install the tables into the new database Es cp AS root tes EE ah R E You can verify your database s DB character set is now set to utf8 by using the following command Terpin a Sl ql use testlink16 mysql Ss MS Dd a tor T ANS SS ON Conmecrron Las 26 Current database testlink15 SE nue e bugz localhost Sli Not in use Current pager stdout USENI OUE Eat liso E Using delimiter 7 oa e Server ers ton Protocol version Connect ron Server character DB character Client choracrer Conn character UNIX socket Uptime set set set sete A il 10 Localhost via UNIX socket dl ES KEINI Varra var lib mysql mysgl sock 86 min 55 sec e Run the upgrade installation provided by TestLink 1 6 Other resources what the heck is U
24. dministrators could shorten the session time specifically for TestLink for security reason without affect other applications The problem is that the value in php ini is not always controllable to you if installation in a hosted environment or safe mode restrictions or php is shared with other applications and because the timeout is coupled with probabilities see gc_probability and gc divisor it s not always predictable if the session will be cleaned up Stig ess tomate Timeout 60 46 5 12 4 Title duplicity of Test Projects Test Suites and Test Cases It is possible to create one of these objects Test Projects Test Suites and Test Cases doing a copy of an existing one 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 Test Suite is unique Note Name of a Keyword a requirements document a Test Plan and Requirements identifier must be unique within Test Project You can configure how to proceed when the copy is done The options are e generate new generate a new name using the value of g prefix name for copy and the original object name The prefix include timestamp by default e block return with an error e allow repeat allow the name to be repeated backward compatibility with version 1 0 4 and 1 5 x Example of formatting Sie lCre gt neme cimaliedey Checking generate nem 5 Note Obsolete pa
25. e TestLink API has its own kind of authentication via keys 5 6 2 Login related configuration TestLink allows new users to create accounts with default role by New user link on login page It speed up user administration procedure Administrator could disable this feature to fully control users in system by setting of the next parameter to value FALSE Siew SuUSseic self slots WAVE Regular expression is used to validate new user login names The default regular expressionvalue is w It aloows a z A z 0 9 as well as space and underscore Note If you change this parameter you may want to update the TLS valid user name format string in the language files to explain the rules you are DB e using on your site t1Cfg gt validation cfg gt user login valid regex Aw N S Regular expression is used when validating user email addresses ICO Set Lelatcilom eto user email valid regem de Cmt T ey eve alo E 27 dor SCS gt well eat on Cuc susec ete valio eg ams CL Ulala to eda we ve ao tp Sy LA Zea a TestLink makes security check on login and reports findings Configure the next parameter show config check warning to show result of config checks e TRUE messages are displayed on login screen and testlink desktop FALSE a two line message is displayed with indication about a file with check results StICfg gt show config check warning FALSE 5 7 GUI Customization 5 7 1 T
26. e re nl se Eee NO MOMO trac system dE SO EE IL e O it o a A Sa crop e pio MANTIS cd Ono eo ES Ane ro As lo K g interface bugs NO Copy it to custom config inc php and change line SO intenta ce nous No Final result Sg interface bugs MANTIS B IV Check interface After your configuration is OK you will find the icon to add bugs in the execute screen Several checks are done when you try to add the bug e Bug ID is present on BTS s Bug ID format is valid ADE Appendix C Revision History Description Date Author 1 0 Initial creation of the document in DocXML 2005 03 12 A Morsing fail Corrected title updated structure and added new sections 2005 04 12 M Havlat 1 2 Added some words for MySQL 4 1 UTF8 support 2005 06 27 A Morsing 1 3 Updated automatic installation part 2005 09 12 F Mancardi 1 4 Updated for TL 1 6 added configuration parameters 2005 09 13 M Havlat restructured created pre installation steps section corrected layout added phpMyAdmin steps description 2 0 Converted to 002 format added DB Charset update 2005 12 04 M Havlat explanation from Kevin 21 Corrected layout for export to HTML and PDF 2005 12 11 M Havlat 2 2 Some small changes 2005 12 17 A Morsing 2 3 Minor layout and grammar update 2006 02 14 M Havlat 2 4 Updated for TL 1 7 2006 11 17 M Havl t 2 5 Updated for TL 1 7 restructured merged BTS case la
27. e from Open Office or other document editors Consider the next option for default behaviour FCKConfig ForcePasteAsPlainText true FCKConfig AutoDetectPasteFromWord true You can also advertise using toolbar buttons Paste Text and Paste from MSWord Note Users can try to paste a text with unclosed html tags that causes rendering problems of the TestLink pages Enabling Image Uploading in FCKEditor Procedure is based on article from Bin Blog This tutorial is aimed at FCKEditor 2 3 2 but the principle works in other versions of FCKEditor as well Open the file FCKEditor fckconfig js Make sure that the default php connector is selected By default the ASP connector is enabled Search for 33 wee Eileseowserhencguage php 4 asp asox clm Lasso pezl pi o oy var OQuielayoloasciizneuess asi asp asox em Lasso ol Enable the connector Open FCKeditor editor filemanager browser default connectors php config php SECURITY You must explicitelly enable this connector Set it to true Contig Enabled Tee Make sure that the given UserFilesPath folder exists in the server and has write permission We suggest to modify similar to the examle SConfig UserFilesPath UserFiles SC paes STEP ROME ptos danes reed Meola T 0 Comment line Contig Uoer alec Aso ure Para any Enable the uploader Open file FCKeditor editor filemanager upload
28. ed for backward compatibility St LCio gt charsec UWN S MySQL Versions prior to 4 1 have not utf 8 support You can export data and convert exported file into Unicode for database upgrade Note that MySQL 5 is required to migration 1 6 gt 1 7 process MySQL see manual http dev mysql com doc refman 5 0 en charset connection html Character set of Bug tracking system uses the same value if you do not overwrite it via optional constant MySQL only Otherwise are used default values of BTS database Amas BUS MEC DS E US 6 1 3 GUI special characters Separation characters used to surround some texts in the user interface for example user role cito eua o seperairos Ossa 0 SiilCie gt euuai gt ro le separairor close 4 Title separators are used when composing a title using several strings The first one is used preferably for logic relation object name for example Test Plan MyTestLink 1 0 The second separator is used to separate parent child SIC ito of Sale separa I SY ee SEIU Cia SS secapairou 2 gt Each Test case has a unique identification number You can set up and use external ID as identifier instead of it The external ID is composed from a Test project prefix a separator defined below and a number related to a parent Test Suite Define the separator si licor ttesicsse Cig gt elve charscesrz E 49 Note The value cannot be empty Dll 7 T
29. ee gt test cases assigned to logged user or not assigned SEllCie gt egec Cro exec node gt rester assiqued to me User filter in Test Execution navigator logged user gt combo will be set to the current user none gt no filter applied by default DEFAULT VALUE SECC SSxeC Cro user litres cleraule nome Filtering TC by a priority defines the threshold values according to the formula Priority urgency x importance The meaning of values is e LOW all Test cases with Priority lt LOW Threshold e HIGH all Test cases with Priority gt HIGH Threshold e MEDIUM all Test cases with Priority gt LOW Threshold AND Priority lt HIGH Threshold 38 elem vito sae ds oie sia cie NOM less ol 8 6 SEC ite Sie simo gore sia ela ace lolo 9 8 3 L Add a new type of Test results on execution page You will need to work on the following files all paths are relative to installation directory Custom CONT 1g 121e pap locale en GB custom strings txt lt create it if do not exist yet lt create it instead of editing strings txt gui themes lt your theme gt css testlink css 1 Open cfg const inc php and search for t1Cfg gt results status code 2 Copy following lines into custom config inc php Elie eesullics D code array ceu gel gt ey locked gt pb passed gt p MOCE rUn gt ia mor ENE eoa gt a unknown gt u Ma
30. efault is TRUE The actions for validation TRUE e none just write on db an empty title e use filename use filename as title oC atcacimenta lLem emp E RUE Se EtEracimentte cto CM save T none Title is used as link description for download if title is empty e show_icon gt the g attachments gt access icon will be used e show_label gt the value of 9g attachments gt access string will be used Se eirtacients gt e cio om I emo cele sho icon See ementas ces icon Cimo Cree IDI 4 ae LS emo style border none gt do Elo eelclinNe mics gt acesss Sicicimc ql You can set own display order of uploaded files Deca ns Some loys ONDER By close ada dr 5 11 Requirements support Requirement functionality could be enabled disabled per Test Project level not via TL configuration Navigate to the Edit Test project page as Administrator One of the unique features of TestLink is Requirement Management Classic structure of requirements allows just two levels SRS document and a list of requirements The parameter child requirements mgmt allows a tree organization of requirements similar to test specification Possible values e ENABLED allow N level depth tree e DISABLED just one level SEliCiie gt eee cio Clan Jo recnivememes monte DS ASE 44 Requirement identification string req doc id must be unique TRUE gt identification is UNIQUE IN THE WHOLE DB syste
31. erS ua ssa qa as ada a E e lr 7 TestLink API 8 FAQ 2 System Requirements 2 1 Client side We support common web browsers Firefox 1 0 and higher and MS Internet Explorer 6 x and 7 x Generally any other browser should work if it supports JavaScript XHTML and CSS according to standards There are some issues with other browser because no one satisfy 100 standards as well as two ones above 2 2 Server side TestLink server PHP q module TestLink scripts Database There is no requirement about your operating system We test application on Linux and MS windows XP TestLink server requires these applications as background e Database You can run also your database on both the same or different server than TestLink php scripts e MySQL 4 1 x and higher 5 x is recommended e Postgres 8 x and higher e Not supported yet for 1 9 version usoft SQL 2000 and 2005 with limitations Any other TestLink satisfies SQL standards So you can use any well known database You need to set up related database schema Check directory testlink install sql and modify one of existing scripts 1 MySQL 4 0 doesn t support UTF 8 2 Database types MyISAM default and InnoDB are supported 3 soft SQL server misses an ability to work with UTF 8 character set We do not recommend to use for multi byte languages See more below 6 Web server Apache 1 3 x or 2 x and higher IIS 3 and higher etc See lt php root gt
32. es Configure authentication Sg smtp username Sg smtp password 5 6 User authentication TestLink supports two kinds of authentication 27 e MD5 use encrypted password stored on internal database e LDAP use password from LDAP Server Internal password is default Seo gt evitnemelcaton me Nodi MD5 5 6 1 External LDAP authentication LDAP authentication needs a few more parameters to be set SE JC te Si Elmeaia ca cartao R seven localhost s S O catete a 309 Sie Cite E cello cleo weies O oo Sie UC eS SENSIS to legis coors cla e mycompany de coml loo eM elmsinc calcio lelero Srl zeta e g organizationname Traffic SE LCG gt emithemeicaiiomn Ile mall a Vuia g SOT Sa a e a e 19 al cha Ciao cae sete ola o leio a pese Se galeno alo Alda ls a wee ils Check LDAP documentation to understand these settings The current last LDAP protocol version is 3 but some organizations could use version 2 invalid version causes connection problem UID field will be used to identify user against a value added via login form The default attribute name is uid For example Active directory uses sAMAccountName Parameters Idap bind dn and Idap bind passwd holds login information for LDAP access Left empty if you LDAP server allows anonymous binding More about LDAP http en wikipedia org wiki Lightweight_ Directory Access Protocol Not
33. estLink API SOAP API is disabled by default for security reason Set then next parameter to TRUE if you would like to use it Sali po iS E Format of showing the personal API identification within GUI View pages S eyo ae Se IR Bd n 8 FAQ Please also check the TestLink forum Smarty error or blank screen is shown instead of login page Slade iodo Sas 109 bas ato nao e ia ls qui e T Clic CON CAD AS SID login o A An monomando Er Sd to open stream No such file or directory in Ce basicos ie resi lia lala DELE siento sms clase oo cm Line 1247 Linux unix users Verify if write permissions are for temp directory default lt testlink root gt gui template c Fix by command i Climccl esr est las oO qui cemplace e IIS users Give the iis user write access to the template c directory See below it will not helps 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 Nov 02 error client XXX XXX XXX XXX PHP Fatal error Call to Macs ass Meto eon a cae ee se Jus a Lolas a a jolie om 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 installati
34. ftp scp etc You will need to telnet SSH access into the server machine for the next steps if not localhost 3 Decompress the package e Linux untar gunzip it to the directory that you want The usual command is 1 step tar zxvf lt filename tar gz gt Microsoft Total Commander Winzip Stuffit and other programs should also be able to handle decompression of the archive 4 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 testlink lt new directory name gt 5 You must allow write access to directories where TestLink expect to write Change the permissions of the templates c upload area and logs directory to be writeable by the web server Linux UNIX user can run from the TestLink root directory chmod 177 HO e ft chmod i logs clio 777 olor waned IIS users also needs to have allow it in dependence to IIS global configuration Security You can configure testlink to use another writeable directories for security reason later Modify TestLink configuration parameters to point another directories see configuration section 6 Continue Installation of database structure and configuration or Upgrade 3 2 AUTOMATIC Installation TestLink includes installation scripts that help you set up all mandatory configuration and database structure The foll
35. m wide e FALSE gt identification is UNIQUE INSIDE a SRS OG SC OS gt 1ERIOO Ler gt 18 system aee DEALSE 5 11 1 Generated Test Cases from Requirements You can choose to create test cases for every requirement after creating the Software Requirements Specifications SRS and populating it with requirements A specific Test Suite is created for the purpose You can define that the related SRS title is used TRUE FALSE gt test cases are created and assigned to a test suite with name defined via Sg req cfg gt default testsuite name TRUE gt Requirement Specification Title is used as testsuite name OG eq Crg 208S rec PSC aS cestemite mare RUDE The next test suite title is used if you set the previous parameter as FALSE Se ec efe gt esflamlt cesteunce mene Emiro e testeo Tes cases Two additional parameters values should be html or simple text o ee cleg gt testenite CStaLlls Test Cases la Che Test Suite ave generated from Requirements A refinement of test scenario is highly recommended oC KSC Cile gt restcase sumiso prstiz o Tie Wes Case wes qeneraitee rom che assigned requirement lt b gt lt br gt Links to other requirements requirement specifications are automatically generated from the corresponding Document ID Values ENABLED default DISABLED Usage e link to Requirements reglreq doc id reg e link to Requirement specifications req speclreqa spec doc
36. mnlare gt stepe cpe nome OG testease temolare gt stepe ovalime Y oC testoase templete o cc mc o mone oC testcase tempblete gt expected resules valme User can define the initial content of a new Test Suite description similar way oC tests tite renplare gt estalle gt eypes file e Cesp casu cs cemoleaite gt dele le gt velme D5 ws Mel nsec 2006010 Logs este ade Note wrong value for type results in no data assigned to Web Editor object 5 10 Attachments Attachment feature could be enabled TRUE disabled FALSE Sep el ca mmen e gt semelolec TRUE The type of the repository can be database or file system e TL REPOSITORY TYPE DB gt database TL REPOSITORY TYPE FS gt filesystem Sg repositoryType TL REPOSITORY TYPE FS TL REPOSITORY TYPE FS where the filesystem repository should be located Sg repositoryPath TL ABS PATH upload area DS Security We recommend to change the directory for security reason Compression used within the repository e TL REPOSITORY COMPRESSIONTYPE NONE gt no compression 43 e TL REPOSITORY COMPRESSIONTYPE GZIP gt gzip compression SC cs pos Ol y compres ss Lone gt Wh Os OE COMA Ss romeo The maximum allowed file size for each repository entry default 1MB COS SO SEO mes dalleeize gt ds Also check your PHP settings default is usually 2MBs Users should add a title for the attachment You can leave it empty FALSE D
37. nfiguration is up and running from a TestLink user point of view the process will be ie 2 While executing a test it fails User saves execution result User clicks on link that opens BTS web page used for issue reporting After issue reporting user has to take note of issue ID assigned by BTS to input it into TestLink User returns to TestLink test execution page and writes the issue ID in the bug input After user saves the execution TestLink will display data taken from the BTS database B II Mantis DB Configuration Edit file lt your TestLink main directory gt cfg mantis cfg php Environment example TestLink and Mantis installed on the same web server 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 56 Na E D n a LULL cuac aos ogia Sg_ allow anonymous login ON g anonymous account dummy B III Enable BTS integration Check the following lines from config inc php _ 2 Sic reinas Site Test linde uses bug tracking systems Co check rr displayed bugs resolved verified ame Closed Duge er echey amus
38. ogin gt John Cook ux555 Configure the default navigator frame frmWorkArea width on left side of window eee ramo mora na de rele nice The Test project combo box in top menu has configurable order value must be SQL compliant Sul US Ac opens ee er no iene else Joni CIBIDIBAR no de ie menos o DISS ls Examples ORDER BY name ORDER BY nodes hierarchy id DESC gt similar effect to order last created first Administrator could configure order of navigation topics on the Main Page PELCO gur layout Marn Pagelle re anta testProgjectl gt Laser Adenine tira rent requirements DS SS ope Cc Imation a SO oo uo eo AO Misas opio laa Carrao beste La Ss los co CD testPlanContents gt 3 Configure round percentages on the metrics Dashboard Ee o dels nio arco e oo 27 Control availability of rounded corners for some GUI elements You would like to disable it to improve rendering performance of pages value DISABLED Parameters are enabled by default SP io round Som SS xs o NE ME Celica our round Ciena Sictsy ET ID Sellen quis round coros e Spee SE NA Ian o a MES Enabled Demo mode disallows the next features User data and password role definition and assignment StICfg gt demoMode ON 5 7 3 Text area editor Text data editing is solved via Javascript editor with toolbar over text area fckeditor or tinymce or simple text area with plain text none The configuration is defined by the next
39. on This module is part of PHP as of PHP 5 thus iconv dll and php iconv dll is not needed any more How to upload images into text See 5 7 3 Text area editor Allocated memory problem You can receive similar error notice katal error Allowed memory Size Of 8566606 bytes exhausted trred to alllocate 1328642 bytes 52 You can enhance the memory limit in php ini Value 64 MB is reasonable We are aware that PHP is not sufficient environment for difficult application there are bad memory releasing So we refactorize continuously code for this reason I upgraded from old TestLink version and I cannot login Your original database could be in different charset The default from 1 6 version is UTF 8 Try to switch DB SUPPORTS UTF8 to FALSE in config inc php I cannot use functionality export XML a test case and open a file attachment word or excel Check session save path variable in php ini You need to put some directory with file write permission for example SS Salon cas penca ES colas This is in case you are using windows linux would probably be SSSI seme ola sm Sola ses Solas Either way you must have write permissions on those folders How can I improve performance There is several places where large data are proceed There is several hints to improve processing e Use EXT JS tree menu component default in 1 8 e Structure Test Cases to Test Suites properly 100 test cases directl
40. on script if you need to do it manually The next description is written for MySQL but these actions are applicable with different tools and syntax for other databases as well 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 e Prepare MySQL via command line tools o Create a new empty MySQL database CEI IDAS ss lis CARAC Slam Mets COLE Weis general em By choosing UTF8 you should also change the value of DB SUPPORTS UTF8 to TRUE in your lt testlinkdir gt config inc php See Configuration for more o Create tables for the newly created database mysql u lt user gt p lt password gt lt dbname gt lt Lestin ase L sel rert link create casles sql o mas ice spin ae mesi lials race ra oil res clas dae cal sell cestlini crsate caleles sal o Populate initial data for the newly created database admin account default roles mysql u lt user gt p lt password gt lt dbname gt lt ecer tlin oio dmscall sql cesclink cresce cea caca scl e Alternatively you can use phpMyAdmin o Create new database from main page UTF 8 character set o Optionally create a new user and assign him correct rights for the created database o Select the created database in the left pane 12 o Navigate to SQL window o Upload SQL request from files install sql testlink create tables sql and run the script o Upload SQ
41. operation on test specification tree is updated DISABLED gt tree will not be updated user can update it manually oC SSC cilo gt entoharie tree Wwetresio JSNJSILIsio Allow to edit an executed version of Test case ENABLED gt user can edit executed Test case versions DISABLED gt editing of executed Test case versions is blocked DEFAULT VALUE S testicass Cilg gt cam ed esecuirsel DISABLED E User can remove an executed version of test case at least one Test result exists from a Test plan Feature is ENABLED by default and could be DISABLED Delicia HESS ST Cig cana mov Te cuca EEE D 5 9 1 Test specification templates User can define the initial content of three text objects of a new Test case summary steps and expected results Each object configuration includes type and value The next types are possible e none gt template will not be used default will be a empty text area DEFAULT 42 VALUE string gt value of value member is assigned to FCK object e string id gt value member is used in a lang get call and return value is assigned to FCK object Configure string id on custom strings txt e file gt value member is used as file name The file is read and it s contents assigned to a text area component as input oC ltesticase tenolate gt Suimetsy ype sti 2G vestcase cemolace gt sunmary salue Soroogeccive MED lt gt lt econo Na poo oC testcoase te
42. owing 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 5 30 minutes to install configure and be using TestLink Next we will create the necessary database tables and a configuration file for database access You are installing TestLink Select your case New installation or Upgrade from older version Open Installation manual for more information or troubleshooting You could also look at README or Changes Log You are welcome to visit our forum to browse or discuss Mew installation Upgrade from 1 8 x versions to 1 9 x Older releases should be migrated to 1 8 version at first 1 From your web browser access http lt yoursite gt testlink web dir and you will be redirected to installation script http lt yoursite gt testlink web dir install index php 2 The installation process will consists from five steps P TestLink TestLink 1 9 Beta 3 Development New installation Acceptance of License El Verification of System and configuration requirements El Definition of DB access El Create DB testlink DB user structures and default data amp create configuration file El Verify the procedure result and continue to TestLink login El Select the New installation link and confirm GPL license 10 You may exercise the freedoms specified here p
43. php config php SECURITY You must explicitelly enable this uploader Configi Enabled true Make sure that the given UserFilesPath folder exists in the server and has write permission We suggest to modify similar to the examle SConfig UserFilesPath UserFiles SConfig UserFilesPath lt TL HOME gt upload area fckeditor upload area Comment line Conn UserilesAbsolutreParh os 5 7 5 Top menu configuration User can define own top menu or add own links Array tlCfg gt guiTopMenu has for each link one item The next parameters are supported e label label to display will be localized url resource to access when users click on menu item e right user right need to display menu item null gt no right check needed a e condition specific condition TestPlanAvailable e shortcut keyboard HTML shortcut e target window frame name mainframe in the most of cases The feature is available since TestLink version 1 9 Example of configuration Sele Z oun lopment iy waaay i label gt home A NS o ao E arb condition gt u T SI E Vins EH Recon 5 Dener cual op Me mim hm ana MMe gt qi SOSC1 Gey Eom url gt lib general frmWorkArea php feature editTc SEULGIMG gt qge vem ce condition gt Shore cut Us target gt mainframe Ne there is six items defined by default 5 7 6 Javascript Use EXT JS library GUI widgets is defaul
44. rameter Sg check names for duplicates FALSE could disable the functionalty 5 12 5 String checking and conversions Allow automatic convertion of www URLs and email adresses into clickable links used by function string display links for example by custom fields Valid values are ENABLED DISABLED StICfg gt html make links ENABLED Define the valid html tags for content driven single line and multi line fields Do NOT include tags with parameters eg lt font face arial gt lt IMG gt and lt A HREF gt It s used by custom fields functionality for example A A il case op ia ml Ol oi DS Lp 07 Wy Emil SECO mel welacl rage sincle line Ly 9 Uy em 47 6 Localization TestLink supports localization of text date and time There is a default value in configuration but each user can set own language Language code is according to common standards og cletanlie iLemcguace eau ess 6 1 String localization A directory exists for every localization with a standard strings txt file inside lt b JUNG WAIL DR Lose dle cle DE Ss ciclos y e lt b JUNI Ibi DIR Loca ke cle Jenson Seeing xe lt 1 INS TAJO DIU Lose Ike ein G13 Sc esas y re To change some of the original translations without changing those provided with the original file 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
45. rcabase Sclolaguaclle e o comece a ea N Ee 13 once Colo e commect Es SOL Server ones can selest e deraleas o Worl mula sselecieo mese selec clo omyle Gcloeemcile ole dale Cow Lola e osenldarabass Sm DS declare the SOL statement that will query the database Sete USmjnen dos quer E TEROM users execute the SOL query and return records oreet mesel query Sousa SnumRows mssql num rows Sresult echo a o Row aos cs W Returnec lt nil gt s display the results mise Seo E femea arenas SieSsullis Schon iit Srow FIRST NAME Ra O close the connection mese close Selomemelle ee 3 5 Post installation steps 3 5 1 Configure TestLink There is amount of settings that helps to tool for your case There is configuration section in this document In addition we recommend to read config inc php and cfg const inc php You find commented parameters here 3 5 2 Back up TestLink installation It s useful to have the last working configuration in extra back up Minimal list contains custom_config inc php config_db inc php and configuration for connection to you bug tracker if any You should make some modification and patches We suggest to backup all the directory after any change then 14 3 5 3 Database back up Important save your time spend a half of hour today with arranging a simple script than boring days later There are two thing
46. re TL and convert strings texts Use FreeTDS driver http www freetds org or ODBTP Use the ADO layer libraries and make database SQL changes as in the FreeTDS solution Now there is one new ADOdb 4 Installation via yum for example http www jasonlitka com 2007 06 01 upgrading to php 523 on rhel and centos 5 See http www libad ora FAQ PHP for more 6 http support microsoft com kb 232580 driver It s called mssql n and extends the standard mssql one just to intercept all the queries sent to DB in order to prepend all the SQL literals found with the N that guaranties that UCS 2 data will be handled properly by MSSQL Use ODBTP or FreeTDS with Unicode UTF8 lt gt UCS2 conversion enabled the new mssql_n ADOdb driver Wait for PHP6 PHP6 is supposed to have better handling for internationalization 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 Install environment Web server with php5 and database Refer to documentation of these products and TestLink System requirements 2 2 section You can also find installations package of all these products and install it together for example XAMPP EasyPHP Uniform Server etc 2 Transfer the TestLink installation file to your web server using whatever method you like best
47. ree menu TestLink tree menu is rendered by the external component EXT JS We select it because of the best performance as it uses asynchronous communication Show or hide Test case unique ID on tree menu SEE es sist Elion ces tcase nel RUE Allow Test case counters by status on tree menu ENABLED gt enable counters DEFAULT VALUE DISABLED gt disable a cilc gt enable e E Coummrers JNSSIGEID Node order Any type of node Test case Test Suite is added with ordering number 0 when creating an node in the tree The initial display order will be by node id A parent test suite has the next default values to separate child Test Suites and Test Cases These values must be gt 0 10 OBSOLETE Testlink 1 8 supported several tree menu components EXTJS LAYERSMENU DTREE JTREE Defined by tICfg gt treemenu type EXTJS 29 E gt cres einen era le reote ice orcs dA Se Lis reenen clean cesrease Orci gt 00 5 7 2 GUI Layout We have defined theme directory that includes CSS and image files lt testlink root gt gui themes default You should copy the default directory modify content and set the next parameter to point it St1Cfg gt theme dir gui themes your theme You can change TestLink appearance by writing your own CSS Cascading Style Sheet files The default files within theme directory e testlink css main style definition e tl print css specific settings for
48. rovided that you comply with the express conditions of this license The principal conditions are You must conspicuously and appropriately publish on each copy distributed an appropriate copyright notice and disclaimer of warranty and keep intact all the notces that refer to this License and to the absence of any warranty and give any other recipients of the Program a copy af tha DAM flonoral Drail l wanco sian cart tha Dranram Ane rare dater n tha ANE fanaral LI I agree to the terms set out in this license 3 The next page will walk through the system requirements and check basic parameters Checking if var www html tl head upload area directory exists OK Checking if var www html tl head upload area directory is writable OK Access to file var www html tl head custom_config inc php OK read only Define database User for Testlink access TestLink DB login my db user TestLink DB password This user will have permission only to work on Testlink database and will be stored in Testlink configuration A Testlink requests to the Database will be done with this user After successfull installation You will have the following login for TestLink Administrator login name admin password admin Process TestLink Setup for the web server php config and DB version You must fix errors to go ahead You will receive confirmation and the button Continue will be enabled 4 Now you need to define database acces
49. s You will be prompted for the database type and location and a database user password pair For installation 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 5 Now you are going to create the database DB account tables and default data 6 You should read that database was successfully filled Important A DEFAULT ADMINISTRATOR level account is created The account name and password are admin admin Use this when you first login to TestLink SECURITY Disable the default admin account is good practice Immediately go to 11 Manage and create at least one another 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 inactivate the account SECURITY After a successful upgrade you should remove the lt testlinkwebdir gt install directory 7 The next part involves configuring the installation to work with your specific setup See configuration section for description of configurable parameters 3 3 MANUAL Installation If you want to perform a manual installation here are the steps needed for a successful installation Warning We recommend using the automated script as there are some undocumented tweaks You can read the code of installati
50. s for example 1 6 0 gt 1 6 1 Database schema shouldn t changed in this case Please follow the next steps e Backup all files of the previous version in testlink directory and database e Remove the all files from directory e Copy a new version to the same directory Copy config db inc php and custom config inc php file to the new structure and modify other configuration parameters and changes according your previous settings for example in config inc php file e Now it should work 4 1 2 Automatic upgrading with DB schema changes Major versions have had typically new functionality and several changes in database against older TL main releases for example 1 6 gt 1 7 l e you are not able to use directly your original database Warning TestLink team doesn t support the scripted database migration from Beta versions See 3 3 MANUAL Installation Please follow the next steps e Follow check preinstallation steps Note that System requirements could change between versions e Copy new version code to your site Hint Unpack new version to a directory with version name and make symbolic link for the current version So you can fully prepare new version without breaking of testers work For example lrwxrwxrwx sn gen Sos ceccrlinc ue local apache hedocs tecr links s drwi ki x A Apr o ZOOS T IE R Giwxrwxrwx 12 1024 May 27 2009 test lanklisd 7 Occasionally for upgrade from Release Candidate or Hot Fix 17
51. s to back up daily database and attachments You could use sophisticated tool to store back up files store to back up files to another server or use raid to suppress a storage failure Create a script that collect data from database and attachment folder An example for Linux environment follows om la Script for backup TestLink service create filenames mydate date SySmSsd pace told none gel backup melo ode hone gel mes estais pose asa Cilememel Sloaelatjo wolceic test linik cls smyceine jock sql Dilenn backupo olde recti Melo om date lock toai dump data wo HHT ULOSE Some joss H 17 gt eae compress epa a oe oaa l backup attachments ele ea ame TTT save to backuped area on server titan mount titan export gat home gat backup titan o soft nosuld rw noauto user noexec tcp Sfilename gz home gat backup titan The script create two compressed files with date in file name There is also commented possibility to mount another server and copy back up files to another server Now you have a script that can do back up You need to set up system to run it every day Linux Unix offers cron service to do it There is example of settings root execute the script as user gat europa gt crontab 1 DO NOT EDIT THIS FILE edit the master and reinstall Te EMO crontabr 20820 nsralled on ros o see 7 004 PC rOn Vero mon e L T RE o O OE ADS Eaa e Ee A Cos o ceu om gana a a io H
52. st inc php att model mi gt shows upload button and title att model m2 gt hides upload button and title DEFAULT VALUE LC e iS ense moecel Sale moclel gt Availability to delete execution result by an user ENABLED gt User can delete an execution result DISABLED gt User can not DEFAULT VALUE Delicia cole ro daa a a SxScmeiom TETE 36 5 8 1 Execution history Define order of execution history ASC gt Ascending last execution at bottom DESC gt Descending last execution on top DEFAULT VALUE delicia ASIS O Cli Sie order gt Vase ts Define if whole execution history for the chosen build will be shown in execution window TRUE gt the whole execution history for the build will be shown FALSE gt just last execution will be shown DEFAULT VALUE SECO ASS Cuomo rom pon SL Sia Allow to show a results also for previous builds TRUE gt test case VERY LAST i e in any build execution status will be displayed FALSE gt only last result on current build DEFAULT VALUE SECO sx CAs slo last Exec cy E E Allow displaying of all builds execution history TRUE gt History for all builds will be shown FALSE gt Only history of the current build will be shown DEFAULT VALUE SDE gt SON so al lo ovules ESE 5 8 2 Test execution navigator Show test cases and test case counters coloured according to test case status ENABLED gt coloured test status DEFAULT VALUE DI
53. stallation 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 in default 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 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 set up all required configuration and database structure 1 3 TestLink License TestLink is released under the terms of GNU General Public License GPL version 2 TestLink is free to use and modify It is free to redistribute as long as you abide by the distribution terms of the GPL Table of Contents E ING e e TY re v e v a e ES ETS 5 Guel tinta dis inc ara ddaguis 3 1 1 Who should read this manual e e ee 3 Iese R 221 9 Krai 2 R CO Sr 3 e System Requires tail iio dE suis ad Riscado ad 6 Pde CNCE SIO nais a DD o oe 6 Lila SEVER SIGO dd na dia ds a a o DS 6 2 2 1 wsoft SQL server doesn t support UTF 8 iiiii errar 7 s ta Gn e lt 1 lt Te nOs 9 Sle S R l
54. strings are used in front page of printed document Left blank to disable 26 SECC gt clocumEme qenerator gt Conga meme vous Cones line cl Sue qeneraitor domo cla cojea e Lelare 2008 o Mesiclaink Oa 2 Elcio IIE EHH cenereiror gt comticentcial mes GRE Generated documents has own layout template You can modify CSS template to you own eller dl Suena qensraror gt ces comolace GelCio chems ch less ido cimentsiess Test case version could be included in a generated document together with Test case title lito ScloCumisinns GEET ol Es version emnalolse aisla 2 9 5 Send E MAIL TestLink has integrated mailing support for sending reports and notification You must set up the next values SMTP server delivers a generated email The value localhost is enough in the most cases Sie emo lao ete localhost Email address of administrator and sender are also mandatory parameters Se el acia emas Velie Memes c yee compota cem jp mos ope Lem Sciooi notre ae ier Se item Small no epla Utert akats cosmo 4 email eender shoged tOo recipient Se T a a mee a coiigemi com Important set up SMTP host and email addresses are mandatory configuration Optionally you can set priority of email The value not urgent is default Urgent 1 Not Urgent 5 Disable 0 Soma ro o Your SMTP server should requires login to relay emails The values remains empty in the most of cas
55. sults on execution page drafted by Francisco Define HTML text editor Updated for TL 1 8 include all new and missing features and refactorization of configuration files Language correction Layout update minor changes Update configuration to 1 8 RC3 Update configuration to 1 8 RC5 1 8 0 Updated chapter Upgrade Update according to issues TL 1 8 2 TestLink 1 9 related changes Added top menu cfg Date 2005 03 12 2005 04 12 2005 06 27 2005 09 12 2005 09 13 2005 12 04 2005 12 11 2005 12 17 2006 02 14 2006 11 17 2007 09 13 2008 01 02 2008 02 02 2008 06 06 2008 07 04 2008 07 07 01 15 09 03 15 09 03 25 09 04 30 09 23 02 10 04 03 10 Author A Morsing M Havlat A Morsing F Mancardi M Havlat M Havlat M Havlat A Morsing M Havlat M Havl t M Havl t M Havl t M Havl t M Havl t W Pollans M Havl t M Havl t M Havl t M Havl t M Havl t M Havl t 1 Introduction TestLink is popular 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 Scope This 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 by step in
56. t TR 211 1 s SPD Sins 9 dla AUTOMATIC ISTMO Andas 10 S758 MANUALE Instala 9 Ta Matas 12 3 4 MS SQL Database Troubleshooting coococccccrorcccccocccca nono 13 do POStcIMStalation SEEDS aran a A 14 SL Configure TES 14 5 5 2 BACKUP TESLLINK INStallatiO Marren A 14 Boys Data base DI K UD ariadna alzas 15 od CCU lesen DE E a a 16 UPON isa sa 17 dolls Code Upgrade OMA 17 4 1 2 Automatic upgrading with DB schema COange8sS cccccccccncccnnnncncnnnnnccn rn 17 dilo Manta UPpara did sidra rd SS SD Rae 18 2 gt DACKWALa COMPADRE A 19 4 2 1 Database schema E e Te L etiani a a a a a a 19 A 22s Changed RZ RI ste isa 19 Axl OBSOlete ee aa At 19 4 2 4 Test Plan relation to Test Project upgrade from 1 5 and older cccoocccccco 20 4 2 5 Latin to UTF 8 conversion upgrade from 1 5 and Older cccccccccccccccnnnnnnnnn noo 20 COM BIG IE LO a AAA AAA A 23 5 1 Configuration Files overview rr rr 23 5 1 1 Use custom config inc php for your CHANGES occcccccccccnnnnnnnnnnnnn anar 23 Dedo Reece A hace teenie Sra nao e aac ec a a a anon aera 24 A A RA 25 5 3 Configuration of Bug Tracker COnnectOr see e e e e eee 25 Sid le Connectors to database of e sle T ienirtu enana Ss a a cunts 25 iz TRACCON AdIcon A 26 Doro DIS e n lt Te lt Les SS AA a 26 5A Generated documents os ola 26 Sr Send E MAIL anadir ia Sa a da 27 O User QULHEMECATION tds td SA GT GC CCR 27 51691 External LDAP autentica nda 28 5 02 LOG
57. t value ENABLED You can disable id DISABLED to slightly improve performance Sg use ext js library ENABLED Define table sorting library The default value kryogenix org uses Stuart Langridge sortTable Empty string disables table sorting feature OG sole calos seas Uso elios eres 5 7 7 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 g_tp1 with the following entries 35 e 9_tpl tcView e g_tpl tcSearchView e g_tpl tcEdit e g tpl tcNew g_tpl execSetResults This allows you to create templates with different names than the original TestLink without the risk of overwriting them during the next upgrade Note Not all TestLink pages are ready for this kind of configuration The standard configuration Saco Tele cent con So mo cedem e Secc Ela a H EE a oc oll sentem Muse gol Sa ER es SERES ibe Vescesce eae ol 5 8 Test execution settings Allow XML RPC calls to external test automation server the special buttons will be displayed on execution pages ENABLED gt enable XML RPC calls DISABLED gt disable SiC IC e cilc gt cnasle test amcemeitica DISASIIED Different layout for the attachments management on execution page these variables are predefined in con
58. ue FALSE causes a file config check txt with a list is created to logging directory but users are not notified via GUI dElcig gt show config check warning TRUE 5 2 1 Event viever All events older this value days are removed from the database g removeEventsOlderThan 30 5 3 Configuration of Bug Tracker connector TestLink allows direct communication with your bug tracker To enable this feature you need to change a configuration parameter on the configuration file custom config inc php The interface is disabled by default value NO The available values are NO BUGZILLA MANTIS JIRA TRACKPLUS EVENTUM SEAPINE or TRAC For example g interface bugs MANTIS See system requirements chapter for supported versions The particular BTS configuration file could be for example cfg bugzilla cfg php cfg mantis cfg php generally cfg lt tracker name gt cfg php Contains configuration parameters to access to particular issue tracking system You need to edit this file if you want to access issue information from TestLink 5 3 1 Connectors to database of tracker The most of connectors uses direct access to database See Appendix for an example of Mantis configuration Other such connectors have same or similar parameters Generally you should set up connection settings authentication and DB type ose BUCH EAC Ds MOST Locas denme LUCHAR e Ca Die ELN Go le bike iS e define SUE W
59. y in one Test Suite is wrong practice e Disable rounded corners for some GUI elements See parameter Sticfg gt gui gt round corners above More troubleshooting for TestLink with IIS There are a few references here to IIS but most are in reference to IIS 5 Windows XP not IIS 6 Server 2003 On installation of TL version 1 7 1 1 7 3 I would receive the well known smarty error Merca Sence actas ey es jato Cuneo e Vas sie Mandl ora needs CVG 6A 6A5 6A537D D8 login tpl php keane eron omary aae ade ona OO cms tarea O SU lo its E Rosy anal no E PU oO res ld ac upa Sica enc e las Spa aDeve L227 On versions 1 7 4 1 8b I would receive a blank screen The common reason for this error is due to insufficient rights to the folder The common resolution for this error is to make sure that the Internet Guest Account has R W E permissions for the web directory This is needed and you will receive this error if you do not give these rights 53 However for my installation 1 had to dig a bit deeper With the IIS v6 integration of windows MS added another group IIS WPG This group is responsible for web processes To get a successful installation 1 had to give full rights to both the group and the account This allowed the web application to install and also solitified the fact that it is in deed a permissions error and not an issue with TL But of course 1 could not leave a group and an account with full access unneededly
60. yout 2007 09 13 M Havl t update prepare for 1 7 0 release 2 6 Added several new parameters for 1 7 updated styles 2008 01 02 M Havl t configuration divided into logical chapters 2 7 Fixed 0001347 0001284 0001331 2008 02 02 M Havl t New sections Add a new type of Test results on execution page drafted by Francisco Define HTML text editor 2 8 Updated for TL 1 8 include all new and missing features and 2008 06 06 M Havl t refactorization of configuration files 2 9 Language correction 2008 07 04 W Pollans 2 10 Layout update minor changes 2008 07 07 M Havlat 2 11 Update configuration to 1 8 RC3 01 15 09 M Havlat 2 12 Update configuration to 1 8 RC5 1 8 0 03 15 09 M Havlat s58 Description Date Author 2 13 Updated chapter Upgrade 03 25 09 M Havlat 2 14 Update according to issues TL 1 8 2 04 30 09 M Havl t 2 15 TBD M Havlat 59

TestLink - User Manual - Testlink 1.9.14 [DEV] (Padawan)

Contents

Download Pdf Manuals

Related Search

Related Contents