TestLink1.9.2完整安装说明

 

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

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

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

1          介绍

       TestLink目前最新的版本是1.9.2，它的运行需要一些应用程序的支持。TestLink开发团队推荐的环境配置为：MySQL4.1.x＋php4.3.x和更高的版本（php5不支持但估计也可以运行）＋Webserver（Apache1.3.x或2.0.x，IIS3等）。笔者刚开始时使用的环境配置为：PHP5.1.1＋MySQL5.0.18＋Apache2.0.55，但是经过努力，笔者发现对于此版本的TestLink，在WinXP下无法是使用这个环境配置将TestLink安装并正确运行。所以，笔者推荐的环境配置为：PHP4.4.0＋MySQL5.0.67＋Smart Apache V1.3.3。

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

2          安装Smart Apache V1.3.3

Apache安装程序可在Apache网站http://httpd.apache.org/下载。V1.3.3版本的下载地址为：http://www.skycn.com/soft/31924.html

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

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

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

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

3          安装PHP4.4.0

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

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

         http://xiazai.zol.com.cn/detail/6/50194.shtml

    以下安装步骤都是针对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          安装MySQL5.0.67

       MySQL5.0.67安装程序可在MySQL网站http://dev.mysql.com下载。5.0.67版本的下载地址为：http://www.duote.com/soft/3169.html     

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

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

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

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

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

5          安装TestLink1.9.2

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

         http://nchc.dl.sourceforge.net/sourceforge/testlink/testlink_1_9_2.zip

    在安装TestLink1.9.2前，需要完成以下步骤：

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

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

3.         将TestLink安装包解压缩到Apache的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的初始密码。

 

 

这个是前人成功配置的经验

1.安装apache_2.2.4-win32-x86-no_ssl.msi到 d:\phpWeb\APACHE\

  步骤:下一步下一步

2.安装php-5.2.0-Win32.zip 到 d:\phpWeb\php\

  步骤:(1)解压压缩包到d:\phpWeb\php\ 

       (2)找到php目录里的 php.ini-dist 重命名为 php.ini 并拷到 windows目录里

       (3)将php目录里的 php5ts.dll,libmysql.dll 拷到 系统目录(system/system32)

3.配置apache

  步骤:(1)打开 d:\phpWeb\APACHE\conf\httpd.conf 这个文件

       (2)找到 DocumentRoot "D:/phpWeb/APACHE/htdocs" 将其改为你的WEB目录（可不改有时改了会出错）   

       (3)找到DirectoryIndex index.html这一行,在后面加入index.html.var index.htm index.php

       (4)找到#LoadModule ssl_module modules/mod_ssl.so这行,在后面加上一行:LoadModule php5_module d:/phpWeb/php/php5apache2_2.dll

       (5)找到AddType application/x-gzip .gz .tgz这行,在后面加上一行:AddType application/x-httpd-php .php

4.配置php

  步骤:(1)找到c:\windows\php.ini并打开 (刚才拷进去的)

       (2)找到extension_dir = "./" 改为 extension_dir = "d:/phpWeb/php/ext"

       (3)找到;extension=php_mysql.dll将前面的;号去掉

       (4)找到;session.save_path = 去掉前面;并设路径"d:/phpWeb/php/session_temp"并在该路径下新建文件夹session_temp 

5.mysql下一步下一步地装就行了

汉化：
1） config.inc.php------>localization项:
 
2) config.inc.php------>logging项:
3） config.inc.php------>bug tracking systems项:
4) *****\locale\zh_CN下strings.txt文件替换为下载的中文的strings.txt.
          小结 
      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）。
        参考资料 
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