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.2
  * Delphi 7

已测试的平台：

  * Windows Server 2003 Stardard Edition
  * Windows 2000 Server SP4
  * CVSNT 2.1.1

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

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

测试使用：

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

http://localhost:2040/Test/index

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

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

4. 设置 CVSNT
-------------
设置 CVSNT 以支持 Passwd 方式管理帐号：

  * 在服务器上创建一个用户 cvsuser，并正确设置临时目录及 CVS 仓库
    目录的权限允许 cvsuser 访问。设置完成后使用该用户应能用
    :pserver 协议访问 CVS。
  * 打开“开始”｜“程序”｜“管理工具”｜“本地安全策略”，在“安
    全设置”｜“本地策略”｜“用户权限分配”中，修改“创建标记对
    象”，把 cvsuser 添加进去。
  * 打开控制面板下的“服务”管理，显示 CVSNT 服务的属性，在“登录”
    页中设置登录身份为“此帐户”，并输入用户名 cvsuser 及用户密码。
    确定后重新启动 CVSNT 服务。
   （因为 CVSNT 在使用 passwd 文件时要求服务进程拥有“创建标记对象”
    的权限，我试过为 SYSTEM 帐号分配这个权限，但还是不能正常工作，
    尝试另建一个帐号来运行 CVSNT 成功）

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

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

注意事项：

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

升级问题：

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

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

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

  * 运行反安装程序即可

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

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

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

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

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

8. 更新记录
-----------

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