TestLinkMILY: 宋體">安裝配置手冊
范圍
本文僅作為安裝和配置TestLink的參考文檔。
本文的第一部分為TestLink的安裝步驟，第二部分是TestLink的配置方法。
本文和其他相關文檔可在TestLink網站上找到。您也可以在TestLink的論壇中尋求幫助
一般TestLink安裝的步驟如下：
1. 下載TestLink
2. 解壓文件
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及以上，等等，更詳細的信息請參見<php安裝目錄>/install.txt）
對于操作系統平臺沒有特別要求（TestLink已經在Linux和MS Win32平臺上測試通過）
你也可以將數據庫與TestLink分別安裝在不同的服務器上，如下圖：
安裝步驟
在安裝TestLink之前應先完成以下步驟：
1. 安裝環境：Webserver、php4和MySQL，安裝方法參見這些應用軟件的安裝文檔。
我是在winXP下安裝的，webserver是IIS，PHP5.1.2，MySql的版本是5.0.18
IIS的安裝就不多說了，下面主要講講PHP
從5.0開始，PHP對MySql的支持需要手動配置
將php_mysql.dll 和libmySQL.dll 文件拷貝到winnt\system32目錄里，這兩個文件可以在PHP安裝目錄里找到。
編輯<windows>目錄下php.ini，將;extension=php_mysql.dll前面的“;”去掉
2. 將TestLink的安裝文件復制到服務器上。
3. 解壓縮Testlink的安裝文件。
數據庫安裝
自動安裝（略）
手工安裝
創建MySQL數據庫
CREATE DATABASE testlink CHARACTER SET utf8 COLLATE utf8_general_ci
創建數據表
# mysql -u <user> -p<password> <dbname> <<testlinkdir>/install/sql/testlink_create_tables.sql
導入缺省數據
# mysql -u <user> -p<password> <dbname> < <testlinkdir>/install/sql/testlink_create_default_data.sql
也可以使用mysql客戶端工具進行創建數據庫的操作。
在<testlinkdir>目錄下創建config_db.inc.php文件
<?php // Automatically Generated by TestLink Installer
define('DB_TYPE', 'mysql');
define('DB_USER', 'root');
define('DB_PASS', 'root');
define('DB_HOST', 'localhost');
define('DB_NAME', 'testlink');
?>
配置
配置文件
<testlink installation directory>/config.inc.php － 主要的配置文件，后面會做詳細介紹
<testlink installation directory>/config_db.inc.php － 包含訪問數據庫的所有配置參數。這個文件在安裝或升級過程中產生。通常不必做手工修改
<testlink installation directory>/cfg/<bug_tracking_system>.cfg.php
/cfg/bugzilla.cfg.php
/cfg/mantis.cfg.php
/cfg/jira.cfg.php
包含訪問bugzilla、mantis或者jira等缺陷跟蹤系統的配置參數。如果想從TestLink直接訪問這些系統，需要手工修改這些文件，另外這個功能需要在config.inc.php文件中修改一個配置參數。
必須修改的參數
DB_SUPPORTS_UTF8
MySQL4.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.a3
TL_TREE_KIND
這個參數用于配置testlink所使用的樹形菜單，允許的值為“LAYERSMENU”、“JTREE”、“DTREE”
LAYERSMENU 是缺省值；在這里，JTREE的性能最好；其他的兩種樹形菜單，可以記住上一次的位置。
TL_IMPORT_LIMIT
最大可以上傳的文件的大小，單位是bytes。缺省值是200000。如果需要上傳一個更大的文件，你可以加大這個值。另外還有一個參數：TL_IMPORT_ROW_MAX，用戶規定導出文件一行最長可以有多長字符，10000字符已經足夠了。
$g_fckeditor_toolbar
定義fckeditor工具條，你可以修改其內容。這個部件的更詳細的信息參見fckeditor的主頁（http://www.fckeditor.net/）
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文件的路徑是相對于<TestLink的安裝目錄>的路徑，是相對路徑
如果要使用自己的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兼容）$g_prefix_name_for_copy
'generate_new'：生成新名稱，將""的值和原名合并，成為一個新名字
'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(
'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_tpl['tcView']
-
$g_tpl['tcSearchView']
-
$g_tpl['tcEdit']
-
$g_tpl['tcNew']
-
$g_tpl['execSetResults']
允許創建新的模板，而且新的模板采用不同于原始TestLink模板的名字，以避免在下次升級過程中被覆蓋
注意：不是所有的TestLink頁面都可以進行這樣的配置
標準配置如下：
$g_tpl['tcView'] = "tcView.tpl";
$g_tpl['tcSearchView'] = "tcSearchView.tpl";
$g_tpl['tcEdit'] = "tcEdit.tpl";
$g_tpl['tcNew'] = "tcNew.tpl";
$g_tpl['execSetResults'] = "execSetResults.tpl";
FAQ
以下是常見問題，更多問題請查看TestLink的論壇
問1：我從老版本升級后，不能登錄
答：你的原始數據庫版本不支持不同字符集。從1.6版起，缺省的字符集是UTF-8。請在config.inc.php文件中置DB_SUPPORTS_UTF8＝FALSE。
問2：登錄頁面顯示Smarty error
答：Linux/unix 用戶: 確認當前用戶是否有臨時目錄的存取權限。缺省臨時目錄：<testlink_root>/gui/template_c/
文章來源于領測軟件測試網 http://www.kjueaiud.com/
