CVSTracNT

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

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

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

我所做的工作有：

* 在 cygwin 下编译 SQLite3 和 cvstrac
* 编写 CVSTracSvc.exe 服务程序，可在 NT 系统中以服务方式启动 cvstrac
* 编写 CVSTracOption.exe 以方便配置使用
* 编写 CTSender.exe 及扩展插件用来发送更新通知
* 修改 cvstrac 源码使之使用 GB2312 字符集以支持中文
* 一个服务程序同时支持 CVS/SVN/GIT 多种版本控制系统
* 翻译 cvstrac 除 Wiki 文档外所有界面
* 支持在 CVSNT 下使用 passwd 方式管理用户帐号
* 增加 cvstrac 数据库用户列表导入导出等实用功能
* 增加用户自定义字符集的支持
* 解决其它一系列与 CVSNT 不兼容的问题

编译环境：

* cygwin-1.5.18.1
* sqlite-3.5.9
* cvstrac-2.0.1
* Delphi 7

已测试的平台：

* Windows Server 2003 Stardard Edition
* Windows 2000 Server SP4
* Windows XP Professtional SP2
* CVSNT 2.0.58d/2.5.03 build 2382


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

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

测试使用：

在设置程序中选择一个数据库，点击“浏览”按钮，如果能看到登录界面，表示安装已经成功，恭喜！

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


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

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

注意事项：

* 修改数据库路径、端口号或语种后需要重新启动服务才能生效。
* 增加、删除或修改 CVS 仓库不需要重新启动服务。
* 系统运行后，建议不要修改 CVS 路径和模块前缀，除非移动 CVS 仓库。
* 备份时只需要备份整个数据库目录即可，恢复时覆盖掉原目录。
* 如果要使用任务单更新通知功能，需要设置任务单通知插件。

使用 Passwd 文件：

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