TestLink1.6.0安裝說(shuō)明
Judy Shen
TestLink是基于Web的，開(kāi)源的測(cè)試管理和執(zhí)行系統(tǒng)。它可以讓測(cè)試團(tuán)隊(duì)在創(chuàng)建和管理測(cè)試用例的同時(shí)，在測(cè)試計(jì)劃中對(duì)測(cè)試用例進(jìn)行組織。TestLink可以和Bugzilla、Mantis、Jira等缺陷管理工具進(jìn)行集成。因?yàn)榫W(wǎng)上TestLink的資料很少，考慮到測(cè)試用例的管理對(duì)于測(cè)試過(guò)程的有效開(kāi)展很重要，所以，筆者把在安裝TestLink1.6.0中碰到的問(wèn)題及安裝過(guò)程的注意事項(xiàng)進(jìn)行了總結(jié)，供同行參考。
本文不包括對(duì)TestLink的優(yōu)化及使用說(shuō)明的介紹，這部分內(nèi)容將在《TestLink1.6.0使用說(shuō)明》中進(jìn)行描述。
本文適用于對(duì)PHP、Apache、MySQL不熟的讀者。本文的描述適用于在windows上的安裝。
1 介紹
TestLink目前最新的版本是1.6.0，它的運(yùn)行需要一些應(yīng)用程序的支持。TestLink開(kāi)發(fā)團(tuán)隊(duì)推薦的環(huán)境配置為：MySQL4.1.x＋php4.3.x和更高的版本（php5不支持但估計(jì)也可以運(yùn)行）＋Webserver（Apache1.3.x或2.0.x，IIS3等）。這里要強(qiáng)調(diào)php和MySQL的版本問(wèn)題，在TestLink1.6.0的環(huán)境搭建上，高版本不兼容低版本的php和MySQL。筆者剛開(kāi)始時(shí)使用的環(huán)境配置為：PHP5.1.1＋MySQL5.0.18＋Apache2.0.55，但是經(jīng)過(guò)努力，筆者發(fā)現(xiàn)對(duì)于1.6.0版本的TestLink，在WinXP下無(wú)法是使用這個(gè)環(huán)境配置將TestLink安裝并正確運(yùn)行。所以，筆者推薦的環(huán)境配置為：PHP4.4.1＋MySQL4.1.16＋Apache2.0.55。
下面我對(duì)這些應(yīng)用程序的安裝與配置步驟分別進(jìn)行描述。
2 安裝Apache2.0.55
Apache2.0.55安裝程序可在Apache網(wǎng)站
http://httpd.apache.org/下載。2.0.55版本的下載地址為：
http://dla.pchome.net/internet/server/web/apache_2.0.55-win32.msiApache的安裝只需要按照安裝界面的步驟進(jìn)行即可。這里需要說(shuō)明的是，如果你的機(jī)器上安裝了其它web服務(wù)器，或者說(shuō)你機(jī)器上的80端口已經(jīng)被占用的話(huà)，那么安裝時(shí)Apache服務(wù)不會(huì)成功創(chuàng)建。對(duì)于這個(gè)問(wèn)題，有兩個(gè)解決辦法：
1． 將機(jī)器上的其它web服務(wù)器占用80端口的服務(wù)暫停
2． 雖然服務(wù)創(chuàng)建不成功，但是其它組件均已經(jīng)安裝了?？梢孕薷腁pache配置文件，<ApacheDir> \Apache2\conf\httpd.conf，將80端口改為其它端口，如8080。然后重新運(yùn)行安裝程序即可。
安裝Apache后，在任務(wù)欄的托盤(pán)上會(huì)顯示Apache的圖標(biāo)。如果安裝成功的話(huà)，在瀏覽器輸入htpp://yoursite（如
http://172.16.111.39:8080），會(huì)進(jìn)入Apache測(cè)試界面。
3 安裝PHP4.4.1
PHP有兩種形式的安裝包，一種是壓縮包的方式，需要手工配置；另一種是安裝包的方式，安裝時(shí)自動(dòng)配置IIS，PWS和Xitami，但是可擴(kuò)展性較差。所以一般是建議下載壓縮包，手工配置PHP。下面的安裝步驟針對(duì)壓縮包方式。
PHP4.4.1壓縮包可在php網(wǎng)站
http://www.php.net/上下載。4.4.1版本的下載地址為：
http://cn2.php.net/get/php-4.4.1-Win32.zip/from/cn.php.net/mirror以下安裝步驟都是針對(duì)PHP4，PHP5的安裝步驟和它有些不同。PHP4安裝步驟如下：
1. 將壓縮包解壓縮到C:\PHP，可以選擇其它的路徑但最好不要用中間有空格的路徑（例如：C:\Program Files\PHP就不太好），如果這樣做有些 web 服務(wù)器會(huì)崩潰。
2. 將位于dlls和sapi文件夾中的文件移動(dòng)到主文件夾中（例如 C:\PHP）
下面兩個(gè)服務(wù)器模塊是后面的步驟中要用到的：
l sapi/php4activescript.dll - ActiveScript 引擎，允許將 PHP 嵌入 Windows 應(yīng)用程序中。
l sapi/php4apache2.dll - Apache 2.0.x 模塊。
3. 將 PHP 目錄添加到PATH環(huán)境變量中，目的是為了讓CGI和web服務(wù)器模塊需要使用的php4ts.dll文件能正確被搜索到，同時(shí)便于將來(lái)升級(jí) PHP。
4. （可選）如果在 Windows NT、2000、XP 或 2003 中使用 NTFS 分區(qū)，確認(rèn)運(yùn)行 web 服務(wù)器的用戶(hù)有權(quán)限讀取 php.ini（例如將其設(shè)置為Everyone 可讀）
5. 將php.ini-recommended拷貝到c:\php目錄下，重命名為php.ini
6. （可選）編輯新的 php.ini 文件。如果計(jì)劃使用 OmniHTTPd，不要執(zhí)行下一步。設(shè)置 doc_root 并指向 web 服務(wù)器的 doc_root。例如：
doc_root = c:\inetpub\wwwroot // for IIS/PWS
doc_root = c:\apache\htdocs // for Apache
7. 注冊(cè)動(dòng)態(tài)鏈接庫(kù)。準(zhǔn)備好全部所需文件后，必須在系統(tǒng)中注冊(cè) DLL。做法是打開(kāi)命令提示行窗口（位于開(kāi)始菜單），然后輸入類(lèi)似cd C:\php的命令進(jìn)入 PHP 目錄，最后輸入regsvr32 php4activescript.dll注冊(cè)該 DLL。
要測(cè)試ActiveScript是否正確工作，請(qǐng)創(chuàng)建一個(gè)新文件，命名為 test.wsf（這個(gè)擴(kuò)展名很重要）然后輸入：
<job id="test">
<script language="ActivePHP">
$WScript->Echo("Hello World!");
</script>
</job>
保存并雙擊這個(gè)文件。如果您看到一個(gè)小窗口，內(nèi)容為“Hello World!"，說(shuō)明安裝成功。
8. 將PHP集成到Apache 2.0。以Apache模塊方式安裝，將以下兩行加入到 Apache 的 httpd.conf 配置文件中，用來(lái)設(shè)定Apache 2.0的 PHP 模塊：
# 對(duì) PHP 4 用這兩行：
LoadModule php4_module "c:/php/php4apache2.dll"
# 別忘了從 sapi 目錄中把 php4apache2.dll 拷貝出來(lái)！
AddType application/x-httpd-php .php
# 配置 php.ini 的路徑
PHPIniDir "C:/php"
注：記得用自己 PHP 實(shí)際所在的路徑替換掉上例中的 c:/php/。要留意在 LoadModule 指令中用的是 php4apache2.dll，而不是 php4apache.dll，后者是設(shè)計(jì)用于
Apache 1.3.x 的。
注：記住在 Windows 下給 Apache 的配置文件中加入路徑值的時(shí)候，所有的反斜線(xiàn)例如 c:\directory\file.ext 必須轉(zhuǎn)換成正斜線(xiàn)，如 c:/directory/file.ext。
9. 驗(yàn)證PHP是否正確安裝?，F(xiàn)在已經(jīng)完成了 PHP 的配置，我們?cè)诿钚刑崾敬翱趫?zhí)行一個(gè)簡(jiǎn)單的腳本，以測(cè)試安裝。下面的代碼是一個(gè)簡(jiǎn)單的 PHP 腳本，用于測(cè)試您的PHP環(huán)境。
<!-- begin of test.php-->
<?php phpinfo(); ?>
<!--end of script-->
將上述代碼復(fù)制到一個(gè)名為test.php的文件中，并將它保存在 PHP 主目錄中。在命令行提示窗口下，輸入php c:\php\test.php >1.txt（因?yàn)檩敵鰞?nèi)容較多，所以將輸出結(jié)果保存到文本文件）。界面上會(huì)顯示PHP的環(huán)境信息。
你也可以將上面剛剛創(chuàng)建的 test.php 文件復(fù)制到 Web 服務(wù)器的 htdocs 目錄下。然后打開(kāi)瀏覽器，輸入 http://yoursite/test.php，例如：
http://172.16.111.39:8080/test.php，界面上將顯示PHP的版本信息。
10. 設(shè)置Session存儲(chǔ)路徑。修改php.ini文件，設(shè)置session.save_path = C:\windows\temp 。默認(rèn)路徑是UNIX上的寫(xiě)法，在Windows上不能正常工作。
4 安裝MySQL4.1.16
MySQL4.1.16安裝程序可在MySQL網(wǎng)站
http://dev.mysql.com下載。4.1.16版本的下載地址為：
http://dev.mysql.com/get/Downloads/MySQL-4.1/mysql-4.1.16-win32.zip/from/http://mirror.vmmatrix.net/mysql/MySQL的安裝步驟比較簡(jiǎn)單，按照安裝界面的默認(rèn)設(shè)置逐步執(zhí)行即可。注意以下幾點(diǎn)：
1. 數(shù)據(jù)庫(kù)編碼選擇utf-8編碼，避免中文發(fā)生亂碼現(xiàn)象。
2. root賬號(hào)是否選擇修改密碼。Root初始密碼為空，在安裝界面中默認(rèn)是要修改密碼的。
3. 是否允許root遠(yuǎn)程訪(fǎng)問(wèn)數(shù)據(jù)庫(kù)。安裝界面默認(rèn)不允許root賬號(hào)遠(yuǎn)程訪(fǎng)問(wèn)數(shù)據(jù)庫(kù)。
4. 如果服務(wù)器上啟用了防火墻，那么需要在防火墻設(shè)置中添加一個(gè)例外端口，如端口號(hào)為3306。
5 安裝TestLink1.6.0
TestLink1.6.0的安裝包可在TestLink網(wǎng)站
http://testlink.sourceforge.net/docs/testLink.php 下載。1.6.0版本的下載地址為：
http://nchc.dl.sourceforge.net/sourceforge/testlink/testlink_1_6_0.zip在安裝TestLink1.6.0前，需要完成以下步驟：
1. 安裝運(yùn)行所需要的環(huán)境：Webserver、php4和MySQL?？梢詤⒄涨懊娴慕榻B進(jìn)行安裝。
2. 將TestLink安裝包保存到服務(wù)器
3. 將TestLink安裝包解壓縮到Apache2的htdocs目錄下，并重命名為testlink
TestLink的安裝有兩種方式，一是自動(dòng)安裝，二是手工安裝的方式。
5.1 自動(dòng)安裝
1. 在瀏覽器輸入訪(fǎng)問(wèn)地址
http://yoursite/testlink/install/index.php，如：
http://172.16.111.39:8080/testlink/install/index.php2. 選擇new install，在進(jìn)入的頁(yè)面中，輸入登錄MySQL的用戶(hù)名和密碼，如root，如果沒(méi)有為T(mén)estLink新建一個(gè)專(zhuān)用的用戶(hù)，也可以輸入初始用戶(hù)root。但是因?yàn)閞oot權(quán)限過(guò)多，所以，建議為T(mén)estLink新建專(zhuān)用的用戶(hù)，并為該用戶(hù)賦予ALTER、SELECT、INSERT、UPDATE、INDEX、CREATE、DELETE和DROP權(quán)限。操作的sql語(yǔ)句見(jiàn)
手工安裝的步驟43. 提示安裝成功。系統(tǒng)為testlink創(chuàng)建一個(gè)默認(rèn)管理員賬號(hào)，用戶(hù)名和密碼為：admin/admin。你可以使用這個(gè)賬號(hào)訪(fǎng)問(wèn)TestLink
在自動(dòng)安裝過(guò)程中，安裝程序主要做了以下事情：
1. 檢查web server的參數(shù)、php配置、數(shù)據(jù)庫(kù)版本
2. 創(chuàng)建數(shù)據(jù)庫(kù)和表，并導(dǎo)入初始數(shù)據(jù)
3. 在完成安裝后，系統(tǒng)會(huì)為testlink創(chuàng)建一個(gè)數(shù)據(jù)庫(kù)配置文件config_db.inc.php。
5.2 手工安裝
你也可以通過(guò)手工的方式來(lái)完成TestLink的安裝。安裝步驟如下：
1. 打開(kāi)命令行窗口，輸入：mysql –uroot –proot（注：假設(shè)安裝MySQL時(shí)將root帳戶(hù)的密碼修改為root），進(jìn)入MySQL
2. 創(chuàng)建數(shù)據(jù)庫(kù)。mysql> create database testlink;
3. 使用新創(chuàng)建的testlink數(shù)據(jù)庫(kù)。mysql> use testlink;
4. 創(chuàng)建用戶(hù)，并賦予適當(dāng)?shù)臋?quán)利。
mysql> grant select,insert,update,alter,index,create,delete,drop on testlink.* to tl@"%" identified by "123456";
mysql> grant select,insert,update,delete,index,drop,create,alter on testlink.* to tl@"localhost" identified by "123456";
如果不加上后面這句話(huà)，新建的用戶(hù)只能用IP地址訪(fǎng)問(wèn)本機(jī)，而不用用localhost的方式來(lái)訪(fǎng)問(wèn)本機(jī)。
5. 修改root和新創(chuàng)建的tl賬號(hào)的密碼。這個(gè)步驟主要是因?yàn)?.1版本后的MySQL使用了基于不同的密碼算法的認(rèn)證協(xié)議。如果服務(wù)器更新了版本，但是客戶(hù)端API沒(méi)有相應(yīng)更新，就會(huì)出現(xiàn)認(rèn)證失敗的情況。這個(gè)情況可以通過(guò)執(zhí)行以下sql語(yǔ)句來(lái)解決。
mysql> update mysql.user set password = OLD_PASSWORD(‘root‘) where host = ‘localhost‘ and user = ‘root‘;
mysql> update mysql.user set password = OLD_PASSWORD(‘123456‘) where host = ‘%‘ and user = ‘tl‘;
mysql> flush privileges;
記得用實(shí)際的用戶(hù)的信息替換上述的“user”、“host”信息。“OLD_PASSWORD”后面的括號(hào)內(nèi)輸入新的密碼。
最后一句命令flush privileges的意思是強(qiáng)制刷新內(nèi)存授權(quán)表，否則用的還是緩沖中的口令，這時(shí)非法用戶(hù)還可以用root用戶(hù)及空口令登陸，直到重啟MySQL服務(wù)器。
6. 切換用戶(hù)，使用tl用戶(hù)。使用quit命令退出mysql，然后再次執(zhí)行步驟2和步驟4，只是此時(shí)的root用戶(hù)信息改為tl用戶(hù)
7. 執(zhí)行數(shù)據(jù)庫(kù)初始化語(yǔ)句。依次將<Apache Install Dir>\ Apache2\htdocs\testlink\install\sql\文件夾下的testlink_create_tables.sql和testlink_create_default_data.sql的內(nèi)容在MySQL內(nèi)執(zhí)行。
8. 創(chuàng)建TestLink數(shù)據(jù)庫(kù)配置文件。參照下面的代碼創(chuàng)建<testlinkdir>/config_db.inc.php文件
<?php // Automatically Generated by TestLink Installer
define(‘DB_TYPE‘, ‘mysql‘);
define(‘DB_USER‘, ‘tl_16‘);
define(‘DB_PASS‘, ‘tl_16‘);
define(‘DB_HOST‘, ‘localhost‘); //建議使用IP地址來(lái)代替localhost
define(‘DB_NAME‘, ‘tl_16‘);
?>
9. 打開(kāi)瀏覽器，輸入：
http://172.16.111.39:8080/testlink/index.php，可以打開(kāi)TestLink登陸界面。建議使用IP地址，而避免使用localhost。如果使用IP地址，在步驟9定義的配置文件中，DB_HOST也要用IP地址替換。
無(wú)論是自動(dòng)安裝還是手工安裝，安裝成功后，要將安裝目錄下的install目錄移走，并在系統(tǒng)中修改admin的初始密碼。
6 小結(jié)
TestLink1.6.0的安裝過(guò)程如上面介紹的步驟進(jìn)行。更多的信息可以訪(fǎng)問(wèn)testlink網(wǎng)站（
http://testlink.sourceforge.net/docs/testlink.php），也可以在TestLink網(wǎng)站的論壇（
http://www.testlink.org/tiki/tiki-forums.php）中獲取更多的信息。另外，如果不想安裝，只想使用TestLink，那么也可以訪(fǎng)問(wèn)TestLink網(wǎng)站上的Demo（
http://testlink.org/demo/index.php）。
7 參考資料
l 《TestLink 1.6 Installation & Configuration Manual》 TestLink Development Team
l 《MySQL 5.0 Reference Manual》
（
http://dev.mysql.com/doc/refman/5.0/en/old-client.html） MySQL AB.
l 《PHP手冊(cè)》（
http://php.benscom.com/manual/zh/install.windows.php）The PHP Group
