TestLink安装配置手册.docx

范围本文仅作为安装和配置TestLink的参考文档。本文的第一部分为TestLink的安装步骤，第二部分是TestLink的配置方法。本文和其他相关文档可在TestLink网站上找到。您也可以在TestLink的论坛中寻求帮助一般TestLink安装的步骤如下：1.下载TestLink2. 解压文件3. 创建数据库4. 导入缺省数据5. 编辑配置文件6.PHP文件扩展7. 登录TestLink系统需求要使TestLink正常运行，需要安装以下软件：MySQL 4.1.x及以上php 4.3.x及以上WebServer （Apache 1.3.x或2.0.x及以上，IIS 3及以上，等等，更详细的信息请参见/install.txt）对于操作系统平台没有特别要求（TestLink已经在Linux和MS Win32平台上测试通过）你也可以将数据库与TestLink分别安装在不同的服务器上安装步骤在安装TestLink之前应先完成以下步骤：1. 安装环境：Webserver、php4和MySQL，安装方法参见这些应用软件的安装文档。我是在winXP下安装的，webserver是IIS，PHP5.1.2，MySql的版本是5.0.18IIS的安装就不多说了，下面主要讲讲PHP从5.0开始，PHP对MySql的支持需要手动配置将php_mysql.dll 和libmySQL.dll 文件拷贝到winntsystem32目录里，这两个文件可以在PHP安装目录里找到。编辑目录下php.ini，将;extension=php_mysql.dll前面的“;”去掉2. 将TestLink的安装文件复制到服务器上。3. 解压缩Testlink的安装文件。自动安装手工安装创建MySQL数据库CREATE DATABASE testlink CHARACTER SET utf8 COLLATE utf8_general_ci创建数据表# mysql -u -p /install/sql/testlink_create_tables.sql导入缺省数据# mysql -u -p /install/sql/testlink_create_default_data.sql也可以使用mysql客户端工具进行创建数据库的操作。在目录下创建config_db.inc.php文件配置配置文件/config.inc.php 主要的配置文件，后面会做详细介绍/config_db.inc.php 包含访问数据库的所有配置参数。这个文件在安装或升级过程中产生。通常不必做手工修改/cfg/.cfg.php/cfg/bugzilla.cfg.php )/cfg/mantis.cfg.php/cfg/jira.cfg.php包含访问bugzilla、mantis或者jira等缺陷跟踪系统的配置参数。如果想从TestLink直接访问这些系统，需要手工修改这些文件，另外这个功能需要在config.inc.php文件中修改一个配置参数。必须修改的参数DB_SUPPORTS_UTF8MySQL4.1以前的版本不支持utf8，因此所有的页面使用ISO-8859-1字符集而数据则以latin1字符集存入数据库，令DB_SUPPORTS_UTF8 = FALSE；MySQL4.1及以后的版本，令DB_SUPPORTS_UTF8 = TRUE，使全部页面支持UTF-8而数据以utf8字符集存入数据库。可能需要修改的参数TL_LOG_LEVEL_DEFAULT日志记录的缺省级别，日志级别有（NONE、ERROR、INFO、DEBUG）。DEBUG级别只在开发或者与bug系统集成时使用TL_LOG_PATH日志文件的文件名和路径MAIN_PAGE_METRICS_ENABLED这个参数控制矩阵表格是否显示在主页上，允许“TURE”和“FALSE”两个值TL_INTERFACE_BUGS设置testlink和缺陷跟踪系统的接口。允许的值为：“NO”、“BUGZILLA”、“MANTIS”与BUGZILLA的接口配置参见cfg/bugzilla.cfg.php，支持0.19.1与MANTIS的接口配置参见cfg/mantis.cfg.php，支持1.0.0.a3TL_TREE_KIND这个参数用于配置testlink所使用的树形菜单，允许的值为“LAYERSMENU”、“JTREE”、“DTREE” LAYERSMENU 是缺省值；在这里，JTREE的性能最好；其他的两种树形菜单，可以记住上一次的位置。TL_IMPORT_LIMIT最大可以上传的文件的大小，单位是bytes。缺省值是200000。如果需要上传一个更大的文件，你可以加大这个值。另外还有一个参数：TL_IMPORT_ROW_MAX，用户规定导出文件一行最长可以有多长字符，10000字符已经足够了。$g_fckeditor_toolbar定义fckeditor工具条，你可以修改其内容。这个部件的更详细的信息参见fckeditor的主页（/）TL_TPL_CHARSET中文用户只需要设置：define(TL_TPL_CHARSET,gb2312)；这样就定义了正确的html字符集。其他的语言可以不必修改这个参数TL_DEFAULT_LOCALE置缺省语言，必须是$g_locales的一个值。缺省值是en_GB。TL_COMPANY,TL_DOC_COPYRIGHT，TL_DOC_CONFIDENT用于文档抬头，如果不用写抬头，就置这些参数为空。自定义参数 级联样式表可以编写你自己的级联样式表改变TestLink的外观。 你必须修改以下定义：define(TL_LOGIN_CSS,gui/css/tl_login.css); - 登录、登出的CSS文件 define(TL_TESTLINK_CSS,gui/css/testlink.css); - 主页的CSS文件 define(TL_DOC_BASIC_CSS,gui/css/tl_doc_basic.css); - 用于测试报告重要：CSS文件的路径是相对于的路径，是相对路径如果要使用自己的CSS文件，建议进行如下操作：1. 在gui目录下创建一个新的目录，例如 “gui/css/my_css/” 2. 复制testlink原文件到新的目录 3. 按你的想法修改它们 4. 编辑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);当产品、部件、分类、测试用例重名时的处理当从一个已经复制一个产品、部件、分类、测试用例时，经常会发生重名的情况。你可以配置如何处理复制：如果你设置$g_check_names_for_duplicates=TRUE，那么系统就会进行以下的检查1. 产品名是否唯一 2. 产品下的部件名是否唯一3. 部件下的分类名是否唯一 4. 分类下的测试用例名是否唯一一旦置$g_check_names_for_duplicates=TRUE，你可以配置如果进行操作，如果发现重名的情况，就使用$g_action_on_duplicate_name，选项如下：allow_repeat：允许重名（可以和1.0.4、1.5.x兼容）generate_new：生成新名称，将$g_prefix_name_for_copy的值和原名合并，成为一个新名字 block：返回一个错误例如：$g_action_on_duplicate_name=allow_repeat;$g_prefix_name_for_copy= strftime(%Y%m%d-%H:%M:%S, time();允许重复，并将当前时间以（年月日时分秒）的格式做为原来的名字的前缀。测试计划和产品的关联从1.6版开始，当创建一个测试计划（Test Plan）时，缺省情况下测试计划会和当前所选择的产品相关联。这意味着你可以以产品为关键字过滤测试计划（Test Plan）。在1.6版本之前，Test Plan没有和指定的产品相关联，当从1.5.x升级到1.6时，安装程序不能将测试计划和产品相关联从而将测试计划的product ID项置为0。这样做将导致老的测试计划将不能被看到。要解决这个问题，必须添加以下参数：$g_show_tp_without_prodid=TRUE;你也可以通过在数据库中手工关联，以便使用以前的数据。通过产品过滤测试计划使用以下参数：$g_ui_show_check_filter_tp_by_product你可以：允许用户通过界面来使能测试计划过滤功能。$g_ui_show_check_filter_tp_by_product = TRUE时，在测试计划之前显示了一个复选框。$g_ui_show_check_filter_tp_by_product = FALSE时。强制测试计划的过滤，并且用户不能修改关键字管理如果不想为同一个产品创建相同的关键字：$g_allow_duplicate_keywords=FALSE;日期和时间本地化设置日期和时间的显示方式。使用两个关联的数组进行配置：$g_locales_date_format 和 $g_locales_timestamp_format.$g_locales_date_format = array( 丛UJ躴蹗 ? en_GB = %d/%m/%Y, it_IT = %d/%m/%Y, es_AR = %d/%m/%Y, es_ES = %d/%m/%Y,de_DE = %d.%m.%Y, fr_FR = %d/%m/%Y, pt_BR = %d/%m/%Y ); $g_locales_timestamp_format = array(en_GB = %d/%m/%Y %H:%M:%S, it_IT = %d/%m/%Y %H:%M:%S,es_AR = %d/%m/%Y %H:%M:%S, es_ES = %d/%m/%Y %H:%M:%S, de_DE = %d.%m.%Y %H:%M:%S, fr_FR = %d/%m/%Y %H:%M:%S, pt_BR = %d/%m/%Y %H:%M:%S, );在上述数组中没有找到匹配的本地化格式，以下配置参数将被使用：$g_date_format 和 $g_timestamp_format例如：$g_date_format =%d/%m/%Y; $g_timestamp_format = %d/%m/%Y %H:%M:%S;从需求生成测试用例在创建需求SRS之后，可以选择为每个测试需求创建测试用例（部件和分类也同时被创建）使用配置参数：$g_reg_cfg,你可以配置：创建的部件的名字：$g_req_cfg-default_component_name=Component Created by Requirement - Auto; 部件的范围：$g_req_cfg-scope_for_component=Component/Category/Test Cases generated from Requirements; 创建的分类的名字：$g_req_cfg-default_category_name=TODO; 分类的目标描述：$g_req_cfg-objective_for_category=Category/Test Cases generated from Requirements;分类的名字可以作如下配置：$g_req_cfg-use_req_spec_as_category_name=TRUE; 将需求名称做为分类名称 $g_req_cfg-use_req_spec_as_category_name=FALSE; 那么$g_req_cfg-default_category_name将做为分类的名称使用自己的Smarty模板（GUI定义）使用自定义模板，要用到以下参数：$g_tpl$g_tpltcView$g_tpltcSearchView$g_tpltcEdit$g_tpltcNew$g_tplexecSetResults允许创建新的模板，而且新的模板采用不同于原始TestLink模板的名字，以避免在下次升级过程中被覆盖注意：不是所有的TestLink页面都可以进行这样的配置标准配置如下：$g_tpltcView = tcView.tpl;$g_tpltcSearchView = tcSearchView.tpl; $g_tpltcEdit