CnPack 开发组 与月共舞
http://www.cnvcl.org

1. CVSTrac 简介
--------------
CVSTrac 是与 CVS 搭配使用的任务管理和错误跟踪工具，基于 WEB 方式访问。
这个轻量级的工具很好地扩展了 CVS 的功能，支持以下特性：

  * 使用内建的 SQLite 数据库引擎，不需要外部数据库支持
  * 支持 CGI、inetd 或 web 服务器方式
  * CVS 帐号和访问权限管理
  * CVS 更新日志 Timeline 功能
  * CVS 仓库在线浏览、分析
  * Ticket 任务单管理跟踪功能
  * 可自定义任务单报表格式
  * 内建 Wiki 发布网站功能

非常适合网上分布式小团队协同开发使用。

官方网站: http://www.cvstrac.org
中文网站: http://www.cnvcl.org

2. Windows 移植中文版说明
-------------------------
CVSTrac 通常在 Unix/Linux 下使用，官方主页上有一份文档介绍了 Windows
下编译安装的方法，不过配置非常复杂。为了方便大家使用，我花了点时间做了
一些工作，现在可以非常方便地在 Windows 下使用了。

我所做的工作有：

  * 在 cygwin 下编译 SQLite 和 cvstrac
  * 编写 CVSTracSvc.exe 服务程序，可在 NT 系统中以服务方式启动 cvstrac
  * 编写 CVSTracOption.exe 以方便配置使用
  * 编写 CVSTracMail.exe 用来发送更新通知邮件
  * 修改 cvstrac 源码使之默认使用 GB2312 字符集以支持中文
  * 翻译 cvstrac 除 Wiki 文档外所有界面
  * 初始化时写入 CVS 仓库路径，以解决不支持 Timeline 和 Browse 的问题
  * 支持在 CVSNT 下使用 passwd 方式管理用户帐号
  * 增加 cvstrac 数据库用户列表导入导出等实用功能
  * 解决其它一系列与 CVSNT 不兼容的问题
  
编译环境：

  * cygwin-1.3.22-1
  * sqlite-2.8.6
  * cvstrac-1.1.3
  * Delphi 7

已测试的平台：

  * Windows Server 2003 Stardard Edition
  * Windows 2000 Server SP4
  * Windows XP Professtional SP1
  * CVSNT 2.0.34

3. 安装
-------
使用以下步骤进行安装：

  * 执行安装程序进行安装，安装前不需要卸载旧的版本。
  * 运行 CVSTrac 配置程序。
  * 点击“自动导入”按钮导入在 CVSNT 中定义的 CVS Repository 仓库。
  * 双击各个子项，修改模块前缀等，每个数据库对应一个仓库。
  * 在数据库设置目录中可导入、导出 CVSTrac 用户列表。
  * 也可手工添加、删除 CVS 仓库。

测试使用：

假设用户初始化一个 CVS 仓库，对应的数据库名为 Test，在浏览器中输入：

http://localhost:2040/Test/index

如果能看到登录界面，表示安装已经成功，恭喜！

默认管理员帐号是 setup 密码 setup，登录成功后可建立其它帐号。
如果系统中存在 anonymous 帐号，则允许匿名访问。

4. 使用
-------
几个概念：

  * CVS Repository: 在 CVSNT 中指定的 CVS 仓库路径。
  * CVS 模块: 一个 CVS 仓库下可有多个模块，每个模块对应一个子目录。
  * CVSTrac 数据库: 保存 CVS 更新信息及错误跟踪任务单的数据库，所有
    数据库文件统一放在同一个目录下。每个数据库要求设置一个 CVS 仓库
    路径，并可指定一个模块前缀（可选）来进行模块过滤。如果有必要，
    也可为同一个 CVS 仓库下每个模块创建数据库（分别定义模块前缀）。

注意事项：

  * 修改数据库路径或端口号后需要重新启动服务才能生效。
  * 增加、删除或修改 CVS 仓库不需要重新启动服务。
  * 系统运行后，建议不要修改 CVS 路径和模块前缀，除非移动 CVS 仓库。
  * 备份时只需要备份整个数据库目录即可，恢复时覆盖掉原目录。
  * 如果要使用任务单更新邮件通知功能，需要设置邮件发送信息。
  * 邮件通知只能定义一个目标信箱，用户可以把它指向一个邮件列表。

使用 Passwd 文件：

  * 创建本地用户 cvsuser，赋予 CVS 仓库目录和临时目录的访问权限。
  * 在配置工具中设置 CVSTrac 数据库支持 Passwd 管理。

升级问题：

  * 新版本使用同一端口对应多个 CVS 仓库，如果使用早期版本，只需要把原
    来创建的数据库文件 *.db 移动到数据库目录下即可使用。

详细使用方法见 cvstrac 自带的说明或 CnPack 开发组发布的 cvstrac 使用
手册。

5. 卸载
-------
使用以下步骤卸载：

  * 运行反安装程序即可

6. 源码下载
-----------
CVS 下载：

  * CVSROOT :pserver:anoncvs@www.cnvcl.org:/var/cvshome/cnpack
  * 模块    wincvstrac
  * 密码    anoncvs

取出完整模块后，cvstrac 中文版部分源码，需要更新以下模块到分支上：

  * 模块    wincvstrac/Source/cvstrac
  * 分支    Chinese_Localize

关于 CVS 的说明，请访问 CnPack 开发网站。

7. 更新记录
-----------

2004.04.09 V1.1.3 Build 20040409

  * 同步升级到官方版本 1.1.3
  + 新增访问流量限制功能
  + 新增对任务单追加备注的功能
  + 新增撤消对任务单的修改的功能
  + 新增为一次提交添加检查报告的功能
  * 更新相关文档

2003.12.14 V1.1.2 Build 20031213

  + 增加任务单更新邮件通知功能
  * 在时间线中显示提交者的全名
  * 修正 Wiki 文档比较时的错误
  * 修正已经有翻译错误和遗漏

2003.12.10 V1.1.2 Build 20031210

  + 增加对 CVSNT 下使用 passwd 文件的支持
  + 增加 CVSTrac 用户列表导入导出功能
  * 修正部分翻译问题

2003.11.15 V1.1.2 Build 20031115

  * 日期显示支持中文格式
  * 修改服务运行方式，只需要一个端口管理所有 CVS 仓库

2003.11.12 V1.1.2 Build 20031112

  * 第一版本发布

======================
CnPack 开发组 与月共舞(yygw@yygw.net)
http://www.cnvcl.org