CVSTracNT

CVSTrac 是與 CVS 搭配使用的任務(wù)管理和錯(cuò)誤跟蹤工具，基于 WEB 方式訪問。
這個(gè)輕量級(jí)的工具很好地?cái)U(kuò)展了 CVS 的功能，支持以下特性：

* 使用內(nèi)建的 SQLite3 數(shù)據(jù)庫(kù)引擎，不需要外部數(shù)據(jù)庫(kù)支持
* 支持 CGI、inetd 或 web 服務(wù)器方式
* CVS 帳號(hào)和訪問權(quán)限管理
* CVS 更新日志 Timeline 功能
* CVS 倉(cāng)庫(kù)在線瀏覽、分析
* Ticket 任務(wù)單管理跟蹤功能
* 可自定義任務(wù)單報(bào)表格式
* 內(nèi)建 Wiki 發(fā)布網(wǎng)站功能

CVSTrac 通常在 Unix/Linux 下使用，官方主頁(yè)上有一份文檔介紹了 Windows下編譯安裝的方法，不過配置非常復(fù)雜。為了方便大家使用，我花了點(diǎn)時(shí)間做了一些工作，現(xiàn)在可以非常方便地在 Windows 下使用了。

我所做的工作有：

* 在 cygwin 下編譯 SQLite3 和 cvstrac
* 編寫 CVSTracSvc.exe 服務(wù)程序，可在 NT 系統(tǒng)中以服務(wù)方式啟動(dòng) cvstrac
* 編寫 CVSTracOption.exe 以方便配置使用
* 編寫 CTSender.exe 及擴(kuò)展插件用來(lái)發(fā)送更新通知
* 修改 cvstrac 源碼使之使用 GB2312 字符集以支持中文
* 一個(gè)服務(wù)程序同時(shí)支持 CVS/SVN/GIT 多種版本控制系統(tǒng)
* 翻譯 cvstrac 除 Wiki 文檔外所有界面
* 支持在 CVSNT 下使用 passwd 方式管理用戶帳號(hào)
* 增加 cvstrac 數(shù)據(jù)庫(kù)用戶列表導(dǎo)入導(dǎo)出等實(shí)用功能
* 增加用戶自定義字符集的支持
* 解決其它一系列與 CVSNT 不兼容的問題

編譯環(huán)境：

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

已測(cè)試的平臺(tái)：

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


3. 安裝
-------
使用以下步驟進(jìn)行安裝：

* 執(zhí)行安裝程序進(jìn)行安裝，安裝前不需要卸載舊的版本。
* 運(yùn)行 CVSTrac 配置程序。
* 點(diǎn)擊“自動(dòng)導(dǎo)入”按鈕導(dǎo)入在 CVSNT 中定義的 CVS Repository 倉(cāng)庫(kù)。
* 雙擊各個(gè)子項(xiàng)，修改模塊前綴等，每個(gè)數(shù)據(jù)庫(kù)對(duì)應(yīng)一個(gè)倉(cāng)庫(kù)。
* 在數(shù)據(jù)庫(kù)設(shè)置目錄中可導(dǎo)入、導(dǎo)出 CVSTrac 用戶列表。
* 也可手工添加、刪除 CVS 倉(cāng)庫(kù)。

測(cè)試使用：

在設(shè)置程序中選擇一個(gè)數(shù)據(jù)庫(kù)，點(diǎn)擊“瀏覽”按鈕，如果能看到登錄界面，表示安裝已經(jīng)成功，恭喜！

默認(rèn)管理員帳號(hào)是 setup 密碼 setup，登錄成功后可建立其它帳號(hào)。
如果系統(tǒng)中存在 anonymous 帳號(hào)，則允許匿名訪問。


4. 使用
-------
幾個(gè)概念：

* CVS Repository: 在 CVSNT 中指定的 CVS 倉(cāng)庫(kù)路徑。
* CVS 模塊: 一個(gè) CVS 倉(cāng)庫(kù)下可有多個(gè)模塊，每個(gè)模塊對(duì)應(yīng)一個(gè)子目錄。
* CVSTrac 數(shù)據(jù)庫(kù): 保存 CVS 更新信息及錯(cuò)誤跟蹤任務(wù)單的數(shù)據(jù)庫(kù)，所有數(shù)據(jù)庫(kù)文件統(tǒng)一放在同一個(gè)目錄下。每個(gè)數(shù)據(jù)庫(kù)要求設(shè)置一個(gè) CVS 倉(cāng)庫(kù)路徑，并可指定一個(gè)模塊前綴（可選）來(lái)進(jìn)行模塊過濾。如果有必要，也可為同一個(gè) CVS 倉(cāng)庫(kù)下每個(gè)模塊創(chuàng)建數(shù)據(jù)庫(kù)（分別定義模塊前綴）。

注意事項(xiàng)：

* 修改數(shù)據(jù)庫(kù)路徑、端口號(hào)或語(yǔ)種后需要重新啟動(dòng)服務(wù)才能生效。
* 增加、刪除或修改 CVS 倉(cāng)庫(kù)不需要重新啟動(dòng)服務(wù)。
* 系統(tǒng)運(yùn)行后，建議不要修改 CVS 路徑和模塊前綴，除非移動(dòng) CVS 倉(cāng)庫(kù)。
* 備份時(shí)只需要備份整個(gè)數(shù)據(jù)庫(kù)目錄即可，恢復(fù)時(shí)覆蓋掉原目錄。
* 如果要使用任務(wù)單更新通知功能，需要設(shè)置任務(wù)單通知插件。

使用 Passwd 文件：

* 創(chuàng)建本地用戶 cvsuser，賦予 CVS 倉(cāng)庫(kù)目錄和臨時(shí)目錄的訪問權(quán)限。
* 在配置工具中設(shè)置 CVSTrac 數(shù)據(jù)庫(kù)支持 Passwd 管理。