TestLink1.6.0安装说明

TestLink1.6.0安装说明 

 

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

 

    本文不包括对TestLink的优化及使用说明的介绍，这部分内容将在《TestLink 1.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          安装Apache 2.0.55

       Apache 2.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          安装PHP 4.4.1

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

 

       PHP 4.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）
下面两个服务器模块是后面的步骤中要用到的：

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:\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          安装MySQL 4.1.16

       MySQL 4.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          安装TestLink 1.6.0

       TestLink 1.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

 

    在安装TestLink 1.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的初始密码。

6          小结

 

    TestLink 1.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