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配置文件,<ApacheDir> \Apache2\conf\httpd.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 Files\PHP就不太好),如果这样做有些 web 服务器会崩溃。
2.将位于dlls和sapi文件夹中的文件移动到主文件夹中(例如 C:\PHP)
下面两个服务器模块是后面的步骤中要用到的:
。sapi/php4activescript.dll - ActiveScript 引擎,允许将 PHP 嵌入 Windows 应用程序中。
。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:\inetpub\wwwroot // for IIS/PWS
doc_root = c:\apache\htdocs // for Apache
7.注册动态链接库。准备好全部所需文件后,必须在系统中注册 DLL。做法是打开命令提示行窗口(位于开始菜单),然后输入类似cd C:\php的命令进入 PHP 目录,最后输入regsvr32 php4activescript.dll注册该 DLL。
要测试ActiveScript是否正确工作,请创建一个新文件,命名为 test.wsf(这个扩展名很重要)然后输入:
<job id="test">
<script language="ActivePHP">
$WScript->Echo("Hello World!");
</script>
</job>
保存并双击这个文件。如果您看到一个小窗口,内容为“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:\directory\file.ext 必须转换成正斜线,如 c:/directory/file.ext。
9.验证PHP是否正确安装。现在已经完成了 PHP 的配置,我们在命令行提示窗口执行一个简单的脚本,以测试安装。下面的代码是一个简单的 PHP 脚本,用于测试您的PHP环境。
<!-- begin of test.php-->
<?php phpinfo(); ?>
<!--end of script-->
将上述代码复制到一个名为test.php的文件中,并将它保存在 PHP 主目录中。在命令行提示窗口下,输入php c:\php\test.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:\windows\temp 。默认路径是UNIX上的写法,在Windows上不能正常工作。
4安装MySQL4.1.16
MySQL4.1.16安装程序可在MySQL网站 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的安装步骤比较简单,按照安装界面的默认设置逐步执行即可。注意以下几点:
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/sourceforge/testlink/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.执行数据库初始化语句。依次将<Apache Install Dir>\ Apache2\htdocs\testlink\install\sql\文件夹下的testlink_create_tables.sql和testlink_create_default_data.sql的内容在MySQL内执行。
8.创建TestLink数据库配置文件。参照下面的代码创建<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地址来代替localhost
define('DB_NAME', 'tl_16');
?>
9.打开浏览器,输入: http://172.16.111.39:8080/testlink/index.php ,可以打开TestLink登陆界面。建议使用IP地址,而避免使用localhost。如果使用IP地址,在步骤9定义的配置文件中,DB_HOST也要用IP地址替换。
无论是自动安装还是手工安装,安装成功后,要将安装目录下的install目录移走,并在系统中修改admin的初始密码。
本文不包括对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配置文件,<ApacheDir> \Apache2\conf\httpd.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 Files\PHP就不太好),如果这样做有些 web 服务器会崩溃。
2.将位于dlls和sapi文件夹中的文件移动到主文件夹中(例如 C:\PHP)
下面两个服务器模块是后面的步骤中要用到的:
。sapi/php4activescript.dll - ActiveScript 引擎,允许将 PHP 嵌入 Windows 应用程序中。
。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:\inetpub\wwwroot // for IIS/PWS
doc_root = c:\apache\htdocs // for Apache
7.注册动态链接库。准备好全部所需文件后,必须在系统中注册 DLL。做法是打开命令提示行窗口(位于开始菜单),然后输入类似cd C:\php的命令进入 PHP 目录,最后输入regsvr32 php4activescript.dll注册该 DLL。
要测试ActiveScript是否正确工作,请创建一个新文件,命名为 test.wsf(这个扩展名很重要)然后输入:
<job id="test">
<script language="ActivePHP">
$WScript->Echo("Hello World!");
</script>
</job>
保存并双击这个文件。如果您看到一个小窗口,内容为“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:\directory\file.ext 必须转换成正斜线,如 c:/directory/file.ext。
9.验证PHP是否正确安装。现在已经完成了 PHP 的配置,我们在命令行提示窗口执行一个简单的脚本,以测试安装。下面的代码是一个简单的 PHP 脚本,用于测试您的PHP环境。
<!-- begin of test.php-->
<?php phpinfo(); ?>
<!--end of script-->
将上述代码复制到一个名为test.php的文件中,并将它保存在 PHP 主目录中。在命令行提示窗口下,输入php c:\php\test.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:\windows\temp 。默认路径是UNIX上的写法,在Windows上不能正常工作。
4安装MySQL4.1.16
MySQL4.1.16安装程序可在MySQL网站 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的安装步骤比较简单,按照安装界面的默认设置逐步执行即可。注意以下几点:
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/sourceforge/testlink/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.执行数据库初始化语句。依次将<Apache Install Dir>\ Apache2\htdocs\testlink\install\sql\文件夹下的testlink_create_tables.sql和testlink_create_default_data.sql的内容在MySQL内执行。
8.创建TestLink数据库配置文件。参照下面的代码创建<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地址来代替localhost
define('DB_NAME', 'tl_16');
?>
9.打开浏览器,输入: http://172.16.111.39:8080/testlink/index.php ,可以打开TestLink登陆界面。建议使用IP地址,而避免使用localhost。如果使用IP地址,在步骤9定义的配置文件中,DB_HOST也要用IP地址替换。
无论是自动安装还是手工安装,安装成功后,要将安装目录下的install目录移走,并在系统中修改admin的初始密码。