日: 2007年6月6日

TestLink1.6.0安装说明 [by chen]

Windows:: TestLink1.6.0安装说明
TestLink1.6.0安装说明

Judy Shen

TestLink是基于Web的,开源的测试管理和执行系统。它可以让测试团队在创建和管理测试用例的同时,在测试计划中对测试用例进行组织。TestLink可以和Bugzilla、Mantis、Jira等缺陷管理工具进行集成。因为网上TestLink的资料很少,考虑到测试用例的管理对于测试过程的有效开展很重要,所以,笔者把在安装TestLink1.6.0中碰到的问题及安装过程的注意事项进行了总结,供同行参考。

本文不包括对TestLink的优化及使用说明的介绍,这部分内容将在《TestLink1.6.0使用说明》中进行描述。

本文适用于对PHP、Apache、MySQL不熟的读者。本文的描述适用于在windows上的安装。

1 介绍
TestLink目前最新的版本是1.6.0,它的运行需要一些应用程序的支持。TestLink开发团队推荐的环境配置为:MySQL4.1.x+php4.3.x和更高的版本(php5不支持但估计也可以运行)+Webserver(Apache1.3.x或2.0.x,IIS3等)。这里要强调php和MySQL的版本问题,在TestLink1.6.0的环境搭建上,高版本不兼容低版本的php和MySQL。笔者刚开始时使用的环境配置为:PHP5.1.1+MySQL5.0.18+Apache2.0.55,但是经过努力,笔者发现对于1.6.0版本的TestLink,在WinXP下无法是使用这个环境配置将TestLink安装并正确运行。所以,笔者推荐的环境配置为:PHP4.4.1+MySQL4.1.16+Apache2.0.55。

下面我对这些应用程序的安装与配置步骤分别进行描述。

2 安装Apache2.0.55
Apache2.0.55安装程序可在Apache网站http://httpd.apache.org/下载。2.0.55版本的下载地址为:

http://dla.pchome.net/internet/server/web/apache_2.0.55-win32.msi

Apache的安装只需要按照安装界面的步骤进行即可。这里需要说明的是,如果你的机器上安装了其它web服务器,或者说你机器上的80端口已经被占用的话,那么安装时Apache服务不会成功创建。对于这个问题,有两个解决办法:

1. 将机器上的其它web服务器占用80端口的服务暂停

2. 虽然服务创建不成功,但是其它组件均已经安装了。可以修改Apache配置文件, Apache2confhttpd.conf,将80端口改为其它端口,如8080。然后重新运行安装程序即可。

安装Apache后,在任务栏的托盘上会显示Apache的图标。如果安装成功的话,在浏览器输入htpp://yoursite(如http://172.16.111.39:8080),会进入Apache测试界面。

3 安装PHP4.4.1
PHP有两种形式的安装包,一种是压缩包的方式,需要手工配置;另一种是安装包的方式,安装时自动配置IIS,PWS和Xitami,但是可扩展性较差。所以一般是建议下载压缩包,手工配置PHP。下面的安装步骤针对压缩包方式。

PHP4.4.1压缩包可在php网站http://www.php.net/上下载。4.4.1版本的下载地址为:

http://cn2.php.net/get/php-4.4.1-Win32.zip/from/cn.php.net/mirror

以下安装步骤都是针对PHP4,PHP5的安装步骤和它有些不同。PHP4安装步骤如下:

1. 将压缩包解压缩到C:PHP,可以选择其它的路径但最好不要用中间有空格的路径(例如:C:Program FilesPHP就不太好),如果这样做有些 web 服务器会崩溃。

2. 将位于dlls和sapi文件夹中的文件移动到主文件夹中(例如 C:PHP)
下面两个服务器模块是后面的步骤中要用到的:

l sapi/php4activescript.dll – ActiveScript 引擎,允许将 PHP 嵌入 Windows 应用程序中。

l sapi/php4apache2.dll – Apache 2.0.x 模块。

3. 将 PHP 目录添加到PATH环境变量中,目的是为了让CGI和web服务器模块需要使用的php4ts.dll文件能正确被搜索到,同时便于将来升级 PHP。

4. (可选)如果在 Windows NT、2000、XP 或 2003 中使用 NTFS 分区,确认运行 web 服务器的用户有权限读取 php.ini(例如将其设置为Everyone 可读)

5. 将php.ini-recommended拷贝到c:php目录下,重命名为php.ini

6. (可选)编辑新的 php.ini 文件。如果计划使用 OmniHTTPd,不要执行下一步。设置 doc_root 并指向 web 服务器的 doc_root。例如:

doc_root = c:inetpubwwwroot // for IIS/PWS

doc_root = c:apachehtdocs // for Apache

7. 注册动态链接库。准备好全部所需文件后,必须在系统中注册 DLL。做法是打开命令提示行窗口(位于开始菜单),然后输入类似cd C:php的命令进入 PHP 目录,最后输入regsvr32 php4activescript.dll注册该 DLL。
要测试ActiveScript是否正确工作,请创建一个新文件,命名为 test.wsf(这个扩展名很重要)然后输入:

保存并双击这个文件。如果您看到一个小窗口,内容为“Hello World!”,说明安装成功。

8. 将PHP集成到Apache 2.0。以Apache模块方式安装,将以下两行加入到 Apache 的 httpd.conf 配置文件中,用来设定Apache 2.0的 PHP 模块:

# 对 PHP 4 用这两行:

LoadModule php4_module “c:/php/php4apache2.dll”

# 别忘了从 sapi 目录中把 php4apache2.dll 拷贝出来!

AddType application/x-httpd-php .php

# 配置 php.ini 的路径

PHPIniDir “C:/php”

注:记得用自己 PHP 实际所在的路径替换掉上例中的 c:/php/。要留意在 LoadModule 指令中用的是 php4apache2.dll,而不是 php4apache.dll,后者是设计用于 Apache 1.3.x 的。

注:记住在 Windows 下给 Apache 的配置文件中加入路径值的时候,所有的反斜线例如 c:directoryfile.ext 必须转换成正斜线,如 c:/directory/file.ext。

9. 验证PHP是否正确安装。现在已经完成了 PHP 的配置,我们在命令行提示窗口执行一个简单的脚本,以测试安装。下面的代码是一个简单的 PHP 脚本,用于测试您的PHP环境。

将上述代码复制到一个名为test.php的文件中,并将它保存在 PHP 主目录中。在命令行提示窗口下,输入php c:phptest.php >1.txt(因为输出内容较多,所以将输出结果保存到文本文件)。界面上会显示PHP的环境信息。

你也可以将上面刚刚创建的 test.php 文件复制到 Web 服务器的 htdocs 目录下。然后打开浏览器,输入 http://yoursite/test.php,例如: http://172.16.111.39:8080/test.php,界面上将显示PHP的版本信息。

10. 设置Session存储路径。修改php.ini文件,设置session.save_path = C:windowstemp 。默认路径是UNIX上的写法,在Windows上不能正常工作。

4 安装MySQL4.1.16
MySQL4.1.16安装程序可在MySQL网站http://dev.mysql.com下载。4.1.16版本的下载地址为:

http://dev.mysql.com/get/Downloads/My … irror.vmmatrix.net/mysql/

MySQL的安装步骤比较简单,按照安装界面的默认设置逐步执行即可。注意以下几点:

1. 数据库编码选择utf-8编码,避免中文发生乱码现象。

2. root帐号是否选择修改密码。Root初始密码为空,在安装界面中默认是要修改密码的。

3. 是否允许root远程访问数据库。安装界面默认不允许root帐号远程访问数据库。

4. 如果服务器上启用了防火墙,那么需要在防火墙设置中添加一个例外端口,如端口号为3306。

5 安装TestLink1.6.0
TestLink1.6.0的安装包可在TestLink网站http://testlink.sourceforge.net/docs/testLink.php 下载。1.6.0版本的下载地址为:

http://nchc.dl.sourceforge.net/source … stlink/testlink_1_6_0.zip

在安装TestLink1.6.0前,需要完成以下步骤:

1. 安装运行所需要的环境:Webserver、php4和MySQL。可以参照前面的介绍进行安装。

2. 将TestLink安装包保存到服务器

3. 将TestLink安装包解压缩到Apache2的htdocs目录下,并重命名为testlink

TestLink的安装有两种方式,一是自动安装,二是手工安装的方式。

5.1 自动安装

1. 在浏览器输入访问地址http://yoursite/testlink/install/index.php,如:http://172.16.111.39:8080/testlink/install/index.php

2. 选择new install,在进入的页面中,输入登录MySQL的用户名和密码,如root,如果没有为TestLink新建一个专用的用户,也可以输入初始用户root。但是因为root权限过多,所以,建议为TestLink新建专用的用户,并为该用户赋予ALTER、SELECT、INSERT、UPDATE、INDEX、CREATE、DELETE和DROP权限。操作的sql语句见手工安装的步骤4

3. 提示安装成功。系统为testlink创建一个默认管理员账号,用户名和密码为:admin/admin。你可以使用这个账号访问TestLink

在自动安装过程中,安装程序主要做了以下事情:

1. 检查web server的参数、php配置、数据库版本

2. 创建数据库和表,并导入初始数据

3. 在完成安装后,系统会为testlink创建一个数据库配置文件config_db.inc.php。

5.2 手工安装

你也可以通过手工的方式来完成TestLink的安装。安装步骤如下:

1. 打开命令行窗口,输入:mysql –uroot –proot(注:假设安装MySQL时将root帐户的密码修改为root),进入MySQL

2. 创建数据库。mysql> create database testlink;

3. 使用新创建的testlink数据库。mysql> use testlink;

4. 创建用户,并赋予适当的权利。

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”;

如果不加上后面这句话,新建的用户只能用IP地址访问本机,而不用用localhost的方式来访问本机。

5. 修改root和新创建的tl帐号的密码。这个步骤主要是因为4.1版本后的MySQL使用了基于不同的密码算法的认证协议。如果服务器更新了版本,但是客户端API没有相应更新,就会出现认证失败的情况。这个情况可以通过执行以下sql语句来解决。

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;

记得用实际的用户的信息替换上述的“user”、“host”信息。“OLD_PASSWORD”后面的括号内输入新的密码。

最后一句命令flush privileges的意思是强制刷新内存授权表,否则用的还是缓冲中的口令,这时非法用户还可以用root用户及空口令登陆,直到重启MySQL服务器。

6. 切换用户,使用tl用户。使用quit命令退出mysql,然后再次执行步骤2和步骤4,只是此时的root用户信息改为tl用户

7. 执行数据库初始化语句。依次将 Apache2htdocstestlinkinstallsql文件夹下的testlink_create_tables.sql和testlink_create_default_data.sql的内容在MySQL内执行。

8. 创建TestLink数据库配置文件。参照下面的代码创建/config_db.inc.php文件

http://172.16.111.39:8080/testlink/index.php,可以打开TestLink登陆界面。建议使用IP地址,而避免使用localhost。如果使用IP地址,在步骤9定义的配置文件中,DB_HOST也要用IP地址替换。

无论是自动安装还是手工安装,安装成功后,要将安装目录下的install目录移走,并在系统中修改admin的初始密码。

6 小结

TestLink1.6.0的安装过程如上面介绍的步骤进行。更多的信息可以访问testlink网站(http://testlink.sourceforge.net/docs/testlink.php),也可以在TestLink网站的论坛(http://www.testlink.org/tiki/tiki-forums.php)中获取更多的信息。另外,如果不想安装,只想使用TestLink,那么也可以访问TestLink网站上的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手册》(http://php.benscom.com/manual/zh/install.windows.php)The PHP Group

Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=577148

Continue reading