CVSTrac 管理员手册
CVSTrac 中文版
管理员手册
作者:周劲羽(master@cnpack.org)
发布:http://www.cnpack.org
版本:V1.0.0.0
创建:2004-05-21
更新:2005-05-11
(C)Copyright 2001-2005 CnPack 开发组 第 1 页 共 40 页
CVSTrac 管理员手册
(C)Copyright 2001-2005 CnPack 开发组 第 2 页 共 40 页
一、 概 述
1、 关于 CVSTrac 及本手册
CVSTrac 是一个开放源代码、与 CVS 搭配使用的任务管理和错误跟踪工具,基于 Web 方式访问,
非常适合网上分布式小团队协同开发使用。
CVSTrac 具有如下一些特点:
z 基于 WEB 方式管理 CVS 的 CVSROOT/passwd 用户账号文件
z 根据 CVS 提交注释自动生成变更集日志
z 可自定义查询报表格式及颜色显示
z 单一的可执行文件支持 CGI、inetd 及独立的 WEB 服务器方式运行
z 内建一个 CVS 仓库 WEB 浏览器
z 内建一个 Wiki 可在线编辑的内容发布系统
z 内建一个文件型数据库引擎 SQLite
z 非常少的内存、硬盘、CPU 占用
z 支持为每个用户设定单独的权限
z 支持匿名访问
z 支持 Unix/Linux/Windows 及不同平台间数据库兼容
z Unix/Linux 下支持 Chroot 安全运行方式
z 在 GNU Public License
下发布
本文档所介绍的 CVSTrac 版本是 1.1.5 简体中文版。
官方网站: http://www.cvstrac.org
中文网站: http://www.cnpack.org
本手册针对项目开发中的配置管理员编写,包括 CVSTrac 在 Linux/Windows 下的安装部署、系统
配置等内容,普通用户请查阅《CVSTrac 使用手册》。
本文档最后的“常见问题解答”列出了使用CVSTrac最常见的一些问题,大家在使用时遇到问题,建
议先看看这部分的内容。如果常见问题中没有答案,可以通过文档最后的方式 获取技术支持。
2、 管理员要求
使用者要求有以下几项基本技能:
1) 熟悉 Linux 或 NT 服务器配置。
2) 熟悉 CVS 服务器配置。
3) 有软件开发的经验。
4) 有软件配置管理和团队开发的经历。
CVSTrac 管理员手册
(C)Copyright 2001-2005 CnPack 开发组 第 3 页 共 40 页
3、 管理原则
管理员在管理过程中,要遵循以下基本原则:
1) 经常做数据库备份。
2) 合理分配用户权限,注意网站安全。
4、 术语解释
4.1 CVS/CVSNT
CVS 表示并行版本控制系统,这是一个基于 TCP/IP 协议,支持服务器/客户端访问模式,开放源代
码的版本控制系统。支持 Windows/Linux 等平台。CVSNT 是 CVS 在 Windows 下的移植版本。
4.2 CVSTrac/CVSTracNT
CVSTrac 是与 CVS 搭配使用的任务管理和错误跟踪工具,基于 Web 方式访问。CVSTracNT 是
CVSTrac 在 Windows 下的移植版本。
4.3 CVS 仓库及模块
CVS 仓库指 CVS 服务器上存储文件数据的场所,可以用一个本地文件系统的绝对路径来访问。每个
有效的 CVS 仓库目录下都有一个 CVSROOT 子目录。
CVS 仓库中的模块对应着仓库中的子目录,可以是一级子目录,也可以是多级子目录。
4.4 CVSTrac 数据库
用于保存 CVSTrac 网站中的任务单、提交历史
、Wiki 页面及附件文件等数据的数据库文件,使
用 SQLite 文件型内嵌数据库系统。同一个服务器上可以有多个数据库,每一个数据库文件对应着一个独
立的 CVSTrac 网站,可以关联一个 CVS 仓库或通过模块前缀仅关联仓库下的子模块。
服务器上保存的数据库文件默认以.db 为扩展名,实际使用时数据库指不带.db 扩展名的数据库文件
名。
4.5 Wiki
WikiWikiWeb 是指一种内容的创建、更新、监控、审查和档案管理都非常自由开放,同时遵循一定
技术规则和文化的网站,我们简称 Wiki。
Wiki 本质上是一种非常松散和开放的网络协作方式,它所有活动都以“文档”为中心,特点是简单易用,
维护管理成本低。
CVSTrac 管理员手册
(C)Copyright 2001-2005 CnPack 开发组 第 4 页 共 40 页
本文中的 Wiki 指 CVSTrac 中集成的用于团队信息发布、交流及管理的 WEB 平台。
4.6 里程碑
里程碑是表示项目活动中重要的事件及时间点。例如:“软件发布时间 2004-02-02”就是一个里程
碑。CVSTrac 中的里程碑仅存在于 CVSTrac 数据库中,与 CVS 仓库没有直接的关系。
5、 系统结构及部署
CVSTrac 网站可以看作是一个小型的 B/S 系统,其系统结构如图 1.1 所示:
图 1.1 系统结构图
在服务器端,同时部署 CVS 服务及 CVSTrac 服务。
CVSTrac 服务直接访问服务器的本地 CVS 仓库数据,调用 RCS 进程获得 CVS 文件的指定版本及执
行版本比较等操作,并使用内嵌的 SQLite 文件型数据库引擎访问本地数据库。同时 CVSTrac 作为 http
服务进程运行(支持 CGI、inetd 或独立的 web server 方式),允许客户端使用 WEB 浏览器进行访问。
CVS 以服务器/客户端的方式运行,用户在客户端使用 CVS 客户端软件通过 TCP/IP 协议访问 CVS
服务器。
客户端 1 表示项目开发人员,他们同时使用 CVS 客户端进行项目开发及访问 CVSTrac。
客户端 2 表示项目管理人员,他们可以不安装 CVS 客户端,而只通过 CVSTrac 来创建和分配开发任
务以及错误
,并随时了解项目开发进度,进行监督和控制。
客户端 1(开发)
客户端 2(管理)
服务器(Linux/NT)
CVS 服务进程
CVS 仓库
CVSTrac 服务进程
(cgi,inetd,web server)
CVS 客户端
WEB 浏览器
CVSTrac 数据库
WEB 浏览器
文件系
统访问
内嵌 SQLite
文件数据库
http 协议
TCP/IP 协议
本地进
程调用
RCS进程
CVSTrac 管理员手册
(C)Copyright 2001-2005 CnPack 开发组 第 5 页 共 40 页
二、 Unix/Linux 下的安装
1、 安装环境及准备工作
1.1 安装环境
CVSTrac 使用 Ansi C 编写,支持 Unix/RedHat/SuSE/FreeBSD/OpenBSD/Cygwin 等
Unix/Linux 环境。
本文档以 Red Hat 9.0 为例,以下设置在 Red Hat 9.0 下测试通过。
1.2 准备工作
首先需要确定是使用源代码编译还是二进制包安装方式,如果你使用的操作系统没有兼容的二进制预
编译包下载,则需要手工编译源代码。
注:以下列出的下载地址,如果不可用,请到 CVSTrac 官方网站或 CVSTrac 中文网站上查询最新的
下载地址。
编译方式安装,需要下载以下包:
1) CVSTrac 源代码(以下几种方式,根据需要任选一种)
z 英文版源代码包下载:
http://www.cvstrac.org/cvstrac-src.tar.gz
z 英文版 CVS 下载:
cvs -d :pserver:anonymous@cvs.cvstrac.org:/cvstrac login
cvs -d :pserver:anonymous@cvs.cvstrac.org:/cvstrac checkout cvstrac
z 中文版源代码下载:
http://www.cnpack.org/download/cvstrac-src-cn.tar.gz
z 中文版 CVS 下载:
cvs -d :pserver:anonymous@www.cnpack.org:/var/cvshome/cnpack login
(输入密码 anonymous)
cvs -d :pserver:anonymous@www.cnpack.org:/var/cvshome/cnpack checkout -r
CVSTracNT_CHS -d cvstrac cvstracnt/Source/cvstrac
2) SQLite 2.4.6 以上版本
z 官方下载:
http://www.sqlite.org/download.html
二进制方式安装,需要下载以下包:
1) CVSTrac 二进制包(以下几种方式,根据需要任选一种)
CVSTrac 管理员手册
(C)Copyright 2001-2005 CnPack 开发组 第 6 页 共 40 页
z 英文版二进制包下载:
http://www.cvstrac.org/cvstrac.bin.gz
z 中文版二进制包下载:
http://www.cnpack.org/download/cvstrac-bin-cn.tar.gz
公共辅助包:
以下两个包通常 Linux 安装时会默认安装,如果你的系统中没有,需要手工下载
1) diffutils 2.8.1
http://www.gnu.org/software/diffutils
2) rcs 5.7
http://www.gnu.org/software/rcs
2、 源代码编译及安装
本文档使用的源代码包:
CVSTrac 1.1.5 简体中文版源代码包 cvstrac-src-cn.tar.gz
SQLite 2.8.13 源代码包 sqlite-2.8.13.tar.gz
编译源代码
1) 登录到服务器上,切换到 root 身份
2) 将 CVSTrac 和 SQLite 源代码包复制到/home 目录下
3) 执行以下命令:
cd /home
解压源代码包
tar -zxf cvstrac-src-cn.tar.gz
tar -zxf sqlite-2.8.13.tar.gz
编译 SQLite
mkdir sqlite_make
cd sqlite_make
../sqlite/configure
make install
cd ..
准备 CVSTrac Make 文件
mkdir cvstrac_make
cd cvstrac_make
cp ../cvstrac/linux-gcc.mk Makefile
编缉 Makefile 文件,修改 SRCDIR 为 cvstrac 源码所在目录,修改 INSTALLDIR 为安装目录
修改完 Makefile 文件名,开始编译
make install
也可以先编译完再手工复制到安装目录下
make
strip cvstrac
CVSTrac 管理员手册
(C)Copyright 2001-2005 CnPack 开发组 第 7 页 共 40 页
mv cvstrac /usr/bin
安装二进制文件
如果是下载的二进制发布包,直接解压到安装目录下即可。
本文档假定安装到/usr/bin 目录下。
3、 CVSTrac 命令行参数
CVSTrac 命令行参数如下:
Usage: cvstrac
?? ??
Or: cvstrac chroot ?? ??
Or: cvstrac server ??
Or: cvstrac chroot server ??
Where:
is one of "cgi", "http", "init", or "update".
is the directory that contains the project database.
is the name of the project.
is a TCP port number to listen on.
is a chroot jail directory.
is the user to run as.
第一种形式的命令行,用来以 cgi 或 inetd 方式运行 CVSTrac,以及初始化(init)及更新(update)
数据库。
第三种形式的命令行,用来以独立的 Web 服务器方式启动 CVSTrac 服务。
目录参数指向包含有 CVSTrac 数据库的目录。
可选参数,表示CVSTrac数据库名,不需要扩展名。如果指定了该参数,用户访问CVSTrac
服务时不需要再指定数据库名,此时 CVSTrac 服务只支持一个数据库。如果省略该参数,该 CVSTrac 服
务可以同时支持多个数据库,由用户在 URL 中指定数据库的名称。
第二和第四种形式的命令行,用于高安全性的 chroot 方式启动 CVSTrac 服务。chroot 运行方式本
文档不做介绍,如果需要使用,请查阅 CVSTrac 官方文档:
http://www.cvstrac.org/cvstrac/wiki?p=ChrootJailForCvstrac
不同运行方式下启动 CVSTrac 的方法详见随后的内容。
4、 初始化数据库
安装完 CVSTrac 后,需要初始化 CVSTrac 数据库。
出于安全考虑,CVSTrac 不允许以系统管理员身份运行。切换到普通用户身份,使用以下命令行来初
始化 CVSTrac 数据库:
cvstrac init ?? ??
参数含义如下:
z cvstrac 为可执行文件
CVSTrac 管理员手册
(C)Copyright 2001-2005 CnPack 开发组 第 8 页 共 40 页
z init 为初始化数据库命令参数
z directory 可选参数,表示保存数据库文件的目录。如果省略默认为当前路径。
z project 可选参数,表示 CVSTrac 数据库名,不需要扩展名。如果省略默认为 cvstrac。
举例:
cvstrac init /var/cvstrac test
命令执行后,会生成一个/var/cvstrac/test.db 数据库文件。
注:所有刚初始化的数据库,文件内容都是一样的(不同语种如中文版和英文版的 CVSTrac 初始化
出来的数据库内容有所不同),用户随后需要自己配置数据库的参数,详见第四部分 CVSTrac WEB 配置。
5、 启动运行 CVSTrac
5.1 CVSTrac 运行环境
要正确地运行 CVSTrac,需要为其提供一定的运行环境,包括外部程序支持及提供 CVSTrac 进程足
够的权限。绝大部分 CVSTrac 配置问题都是因为权限引起的,建议管理员仔细阅读下列内容。
CVSTrac 运行时需要以下外部程序的支持,请检查你的系统中存在以下程序:
z co:该命令用来从 CVS 仓库的“*,v”文件中取出某个版本的文件。
z diff:该命令间接被 rcsdiff 命令调用。
z rcsdiff:用来获得 CVS 文件两个版本之间的差异。
z rlog:用来从 CVS 文件中查找提交注释、分支以及标签信息。
CVSTrac 对权限的要求:
z 基于安全考虑,CVSTrac 不能以 root 身份运行。
z CVSTrac 进程要有对 CVSTrac 数据库所在目录的读写权限(sqlite 写数据库时需要在数据库目
录中创建临时文件)
z CVSTrac 进程要有对 CVSTrac 数据库文件的读写权限。
z CVSTrac 进程要有对 CVS 仓库文件以及 CVSROOT/history 文件的读权限。
z 如果设置由 CVSTrac 管理 passwd 文件,CVSTrac 进程要有对 passwd、readers、writers
文件的写权限,如果 passwd 等文件不存在,还需要有对 CVSROOT 目录的写权限。另外,由
于 CVSTrac 管理 passwd 文件时,会将 CVSTrac 进程所有者作为 passwd 文件中的本地映射
帐号,故间接地还需要 CVSTrac 进程所有者帐号有对 CVS 仓库的读写权限。
z CVSTrac 进程要有对前述几个外部程序的运行权限。
另外,还要检查服务器防火墙是否打开了 CVSTrac 服务的端口。
以下操作假定用户系统环境如下:
z cvstrac 的安装目录:/usr/bin
z CVSTrac 数据库目录:/var/cvstrac
z CVSTrac 数据库:/var/cvstrac/test.db
z CVS 仓库路径:/var/cvs/test
CVSTrac 管理员手册
(C)Copyright 2001-2005 CnPack 开发组 第 9 页 共 40 页
z 服务器 IP 地址:192.168.1.10
z 有 CVSTrac 数据库及 CVS 访问权限的用户:cvs
5.2 CGI 方式运行
在 CGI 方式下,CVSTrac 以 Web 服务器(如 Apache)的 CGI 网关程序运行。使用该方式的优点
是不需要占用其它的端口,缺点是配置相对复杂,限制较多。以下以 Apache 为例介绍用 CGI 方式运行
CVSTrac 的方法。
运行于 CGI 方式下,最容易遇到的问题是 CVSTrac 进程的权限问题,因为 Apache 进程一般会以非
常低权限的用户身份来运行 CGI 脚本(如 www、apache 或 nobody),这些用户对 CVS 仓库不一定有
访问权限。
通常有两种方式来解决权限问题,第一种是设定 CVSTrac 数据库及 CVS 仓库的权限,使其能够被
Apache 进程用户访问,第二种是使用 Apache 提供的 suEXEC 命令,在执行 CVSTrac 时切换到权限较
高的用户。第二种方法配置比较复杂,一般不推荐使用,本手册仅介绍第一种方法。
CGI 方式的启动命令行如下:
cvstrac cgi ?? ??
假定系统环境如下:
z Apache 的 cgi-bin 目录:/var/www/cgi-bin
z Apache 的运行身份:apache
首先,创建一个 CVSTrac 启动脚本/var/www/cgi-bin/cvstrac 内容如下:
#!/bin/sh
/usr/bin/cvstrac cgi /var/cvstrac
创建完成后,为脚本设置执行权限:
chmod +x cvstrac
指定数据库的访问权限(此处要将/var/cvstrac 目录本身及下面的数据文件都对 apache 用户开放写
权限):
chown -R apache:apache /var/cvstrac
指定 CVS 仓库的访问权限(此处简单地把 CVS 仓库的 owner 指定为 apache,如果管理员熟悉 CVS
配置,也可以用其它方法设置权限):
chown -R apache:apache /var/cvs/test
配置完成后,客户端使用该地址:
http://192.168.1.10/cgi-bin/cvstrac/test/index
应该可以出现登录界面了,管理员登录上面可以设置 CVS 仓库等参数,详见“第四部分 CVSTrac
WEB 配置”的内容。
如果看不到登录界面,或出现其它错误,请查看 Apache 的配置及检查 CVSTrac 正常运行时需要的
权限是否满足。
如果服务器上只运行一个 CVSTrac 数据库,也可以将 cgi-bin/cvstrac 脚本修改为:
/usr/bin/cvstrac cgi /var/cvstrac test
CVSTrac 管理员手册
(C)Copyright 2001-2005 CnPack 开发组 第 10 页 共 40 页
将数据库名加到命令行中,此时客户端访问地址变为(省略了数据库名):
http://192.168.1.10/cgi-bin/cvstrac/index
5.3 inetd/xinetd 方式运行
CVSTrac 支持以 inetd/xinetd 服务方式运行,在这种方式下因为可以指定运行服务的用户身份,故
比 CGI 方式更为灵活,性能也不错。
inetd/xinetd 方式的启动命令行如下:
cvstrac http ?? ??
1) 以 inetd 方式下运行 CVSTrac,假定用户环境如下:
z CVSTrac 服务端口号:80
在/etc/inetd.conf 中增加一行:
80 stream tcp nowait.1000 cvs /usr/bin/cvstrac cvstrac http /var/cvstrac
重新启动 inetd 服务:
/sbin/service inetd restart
配置完成后,客户端使用该地址:
http://192.168.1.10/test/index
应该可以出现登录界面了。如果有问题,请检查 inetd 设置及 CVSTrac 运行权限。
2) 以 xinetd 方式运行 CVSTrac,假定用户环境如下:
z Web 服务器未启动,xinetd 接管 http 服务
创建一个/etc/xinetd.d/http 文件,内容如下:
service http
{
socket_type = stream
wait = no
user = cvs
server = /usr/bin/cvstrac
server_args = http /var/cvatrac
}
重新启动 xinetd 服务:
/sbin/service xinetd restart
配置完成后,客户端使用该地址:
http://192.168.1.10/test/index
应该可以出现登录界面了。如果有问题,请检查 xinetd 设置及 CVSTrac 运行权限。
如果服务器上已经安装有 Web 服务器,或者 http 服务被占用,由管理员需要为 CVSTrac 指定一个
新的服务,参见 xinetd 的配置说明,此处不再详述。
CVSTrac 管理员手册
(C)Copyright 2001-2005 CnPack 开发组 第 11 页 共 40 页
5.4 WEB Server 方式运行
CVTrac 还支持以独立的 Web Server 方式运行,这种模式下不需要其它 Web 服务平台的支持,也
可以灵活地配置。
Web Server 方式的启动命令行如下:
cvstrac server ??
假定用户环境如下:
z CVSTrac 服务端口:2040
以 cvs 用户身份执行以下命令行:
/usr/bin/cvstrac server 2040 /var/cvstrac &
启动 CVSTrac 服务,命令行后面的&号表示以后台进程方式启动。
为了方便使用,还可在/usr/bin 下创建 CVSTrac 服务脚本 cvstrac.sh 内容如下:
#!/bin/sh
case "$1" in
start)
/usr/bin/cvstrac server 2040 /var/cvstrac &
;;
stop)
killall cvstrac
;;
restart)
$0 stop
$0 start
;;
*)
echo "Usage: cvstrac.sh {start|stop|restart}"
;;
esac
exit 0
并设置该脚本具有可执行属性,这样使用 cvstrac.sh start|stop|restart 就可以“启动|停止|重新
启动”CVSTrac 服务了。
为了让每次系统启动时自动启动 CVSTrac 服务,可以在/etc/rc.d/rc.local 中增加以下一行:
su - cvs -c '/usr/bin/cvstrac.sh start'
服务启动后,客户端使用该地址访问:
http://192.168.1.10:2040/test/index
CVSTrac 管理员手册
三、 Windows 下的安装及配置
1、 安装环境及准备工作
1.1 安装环境
为了方便大家在Windows下使用CVSTrac,CnPack开发组 对CVSTrac进行了移植和汉化。发布文
件为CVSTracNT。
CVSTracNT 支持 Windows2000/XP/2003 等 NT 平台,以服务的方式启动,可以搭配 CVSNT 使
用。目前最新版本为 V1.1.5 多语言版。
本文档以 Windows2000 SP4 为例。
1.2 准备工作
在 Windows 上安装 CVSTracNT,只需要下载 Windows 安装程序即可。
1) 如果没有安装 CVS,先下载并安装 CVSNT
http://www.cvsnt.org
2) 下载 CVSTracNT 多语言版
http://www.cnpack.org/download/CVSTracNT.exe
注:版本兼容性问题
安装时请查看 CVSTracNT 的版本兼容说明。CVSTracNT V1.1.5 已测试支持的 cvsnt 最高版本为
2.0.51d,不支持 2.5.0.1910 版本。
2、 安装 CVSTracNT
执行 CVSTracNT 安装程序,装载完成后显示语言选择窗口如图 3.1 所示:
图 3.1 CVSTrac 安装程序语言选择
此处选择的语言会影响到安装程序的界面及开始菜单程序组中快捷方式的名称,此处选择默认值简体
中文。
(C)Copyright 2001-2005 CnPack 开发组 第 12 页 共 40 页
CVSTrac 管理员手册
进入安装界面后,一路点击“下一步”,完成安装过程。图 3.2 为安装路径选择界面:
图 3.2 CVSTrac 安装程序路径选择
安装完成后,会自动启动 CVSTracNT 设置程序及打开自述文件。
注:如果是升级方式安装,如果安装程序没有特别指明,不需要删除旧版本的程序,直接安装新版本
即可。
3、 配置 CVSTracNT
CVSTracNT 所有设置在 CVSTracNT 配置程序中进行,用户不需要了解 CVSTrac 的命令行参数及数
据库操作。从开始菜单中启动 CVSTracNT 配置程序,可执行以下设置。
3.1 第一次启动配置程序
第一次启动 CVSTrac 配置程序时,如果服务器上安装有 CVSNT,配置程序会提示自动导入 CVS 仓
库并初始化数据库,如图 3.3 所示:
图 3.3 CVSTrac 配置程序自动导入数据库提示
点击“是”由程序自动为每个 CVS 仓库创建一个 CVSTrac 数据库,如图 3.4 所示:
(C)Copyright 2001-2005 CnPack 开发组 第 13 页 共 40 页
CVSTrac 管理员手册
图 3.4 CVSTrac 配置程序自动导入数据库完成提示
点击“确定”进入配置程序主界面,如图 3.5 所示:
3.2 配置程序主界面
图 3.5 CVSTrac 配置程序主界面
3.3 CVSTrac 服务设置
在配置程序中可以修改 CVSTrac 服务相关参数,这些参数修改后程序会提示重新启动服务以应用参
数。
1) 数据库目录:保存 CVSTrac 数据库的目录。CVSTracNT 要求所有数据库文件都保存在同一目录
(C)Copyright 2001-2005 CnPack 开发组 第 14 页 共 40 页
CVSTrac 管理员手册
下,用户备份时只需要备份该目录下所有文件即可。
2) 服务端口:选择 CVSTrac 作为 WEB 服务器时使用的 http 服务端口。如果本机 80 端口没有占
用,可以为它分配 80 端口。
3) 安装/卸载/启动/停止:控制 CVSTrac 服务的状态。
4) 语种选择:切换当前界面语种及 CVSTrac WEB 界面语种。
注:在配置界面上选择的当前语种同时决定了 CVSTrac WEB 服务的界面语种,另外还决定了新初始
化数据库使用的语种。在不同语种设定中初始化的数据库,请不要混用。
3.4 数据库管理
CVSTrac 数据库列表中列出了当前存在的 CVSTrac 数据库,可以执行以下操作:
1) 增加:创建一个新的数据库,点击该按钮弹出对话框如图 3.6 所示。
图 3.6 增加数据库
z 仓库路径:新数据库需要关联的 CVS 仓库的根路径,用户可以在下拉列表中选择在 CVSNT 中
定义的仓库,或点击右边的按钮手工指定一个路径,如果用户指定的路径不是有效的 CVS 仓库
路径,将会弹出提示信息。
z 模块前缀:设置仓库中用来过滤的模块前缀名。如果设置了模块前缀,则只有符合该前缀的文件
才会被 CVSTrac 管理。如果需要管理 CVS 仓库下所有文件,模块前缀可以留空。
z 数据库名:新建数据库的名称。
z 字符集:单独为数据库指定 Web 页面使用的默认字符集。如果您需要在英文版本中显示中文或
其它字符集的文本时,可以在此指定。字符集同网页中的 charset 定义,如中文可以指定为
gb2312。
z 由 CVSTrac 管理 CVS 用户及读写权限:如果选择此项,则 CVSTrac 会自动在管理员更新用
(C)Copyright 2001-2005 CnPack 开发组 第 15 页 共 40 页
CVSTrac 管理员手册
户帐号时,同步更新 CVSROOT/passwd 文件。
z 映射用户:如果选择由 CVSTrac 管理 CVS 用户,此处输入 passwd 文件中映射为本地用户的
用户名,该用户名必须对 CVS 仓库有访问权限。
在“更新通知页”,可以设置当任务单变更时的自动通知功能,如图 3.7 所示:
图 3.7 更新通知设置
z 更新通知方式:选择当任务单变更时的通知方式。如果选择“通知器”通知方式,用户需要在主
界面中设置通知器插件,见随后的部分。用户还可以在Web方式下为CVSTrac数据库设定更新通
知命令行,详见“CVSTrac WEB配置”部分。
z 使用该插件执行通知:选择一个通知插件后,选中该检查框,表示在任务单发生变更时,使用该
插件进行通知。用户可以同时选择多种通知方式。
z 插件设置:如果选中了“使用该插件执行通知”,点击该按钮设置当前插件。
z 确定/取消:确定或取消创建新数据库的操作。
2) 删除:删除当前选择的数据库。
3) 设置:修改当前选择的数据库,设置界面如下图 3.8 所示。主要内容同“新建数据库”中的操作。
另外,“导出/入用户列表”功能允许用户在不同的数据库之间同步用户列表。
(C)Copyright 2001-2005 CnPack 开发组 第 16 页 共 40 页
CVSTrac 管理员手册
图 3.8 CVSTrac 数据库设置
4) 浏览:在本地 Web 浏览器中打开当前选择的数据库页面。此处打开的链接是以 localhost 作为主
机名的,客户端的用户可以把它替换成服务器的 IP 地址、域名或机器名来访问服务器上的
CVSTrac 网站。
5) 导入仓库:该功能用于自动为 CVSNT 中的仓库创建 CVSTrac 数据库,导入时会忽略掉已经关联
有 CVSTrac 数据库的仓库。
注:在 CVSTrac 配置工具中修改数据库,并不会影响到 CVS 仓库下的 passwd 文件,管理员需要到
Web 管理界面中随便修改一下用户帐号,才会将 CVSTrac 用户帐号更新到 CVS 的 passwd 文件中去。
3.5 任务单通知设置
在主界面中点击“任务单通知”,切换到任务单通知设置界面,如图 3.9 所示:
(C)Copyright 2001-2005 CnPack 开发组 第 17 页 共 40 页
CVSTrac 管理员手册
图 3.9 任务单通知配置界面
1) 任务单设置:配置任务单通知公共参数。
z 本机域名:在自动通知邮件中,会包含一个指向变更任务单的链接,此处应输入 CVSTrac 服务
器的域名、IP 地址或机器名。
z 保存任务单通知日志:指定是否在任务单通知时保存日志文件,如果接收不到任务单通知,可以
选择该功能,以便原因。
z 查看日志:打开日志文件夹。
2) 邮件插件:使用邮件方式发送任务单更新通知。
使用 smtp 服务器发送邮件,支持从 CVSTrac 数据库中读取用户信箱及指定另外的信箱。其设置界
面如图 3.10 所示:
(C)Copyright 2001-2005 CnPack 开发组 第 18 页 共 40 页
CVSTrac 管理员手册
图 3.10 邮件服务器设置界面
z 发信人邮箱:自动发送通知邮件中显示的发信人邮件地址。
z 发信人名称:自动发送通知邮件中显示的发信人名称。
z SMTP 服务器:用来发送通知邮件的 SMTP 服务器地址。
z SMTP 端口:用来发送通知邮件的 SMTP 服务器端口。
z 服务器需要身份验证:如果 SMTP 服务器需要登录身份验证,选择该选项,并在下面输入登录用
户名及登录密码。
z 网络超时:连接邮件服务器的最大等待时间。
z 测试:使用当前的设置登录服务器,测试连接情况。
3) 信使插件:使用 Net Send 命令在局域网内发送通知的插件。
该插件不需要配置。
4) RTX 腾讯通插件:使用 RTXServer SDK 开发的插件。
使用该插件要求先安装 RTXServer SDK,当任务单更新时自动发送消息到 RTX 客户端。其设置界
面如图 3.11 所示:
图 3.11 邮件服务器设置界面
z RTX 服务器:RTX 服务器的 IP 地址。
z RTX 端口:RTX 服务器的端口。
(C)Copyright 2001-2005 CnPack 开发组 第 19 页 共 40 页
CVSTrac 管理员手册
(C)Copyright 2001-2005 CnPack 开发组 第 20 页 共 40 页
z 测试:检查本机是否已经安装了 RTXServer SDK。
5) 其它插件:新版本的 CVSTracNT 可能还会提供其它的插件,用户也可以自己开发特定的插件,
见插件开发说明。
CVSTrac 管理员手册
四、 CVSTrac WEB 配置
1、 第一次登录
当管理员配置好 CVSTrac 服务器并设定好 CVSTrac 数据库后,需要通过 Web 登录到 CVSTrac 中
进行一些初始化设置。
假定 CVSTrac 服务器地址为:
http://192.168.1.10/test/index
在浏览器中输入该地址,管理员以用户名 setup,密码 setup 登录,如图 4.1 所示:
图 4.1 管理员登录 CVSTrac
点击“登录”后出现主界面如图 4.2 所示:
(C)Copyright 2001-2005 CnPack 开发组 第 21 页 共 40 页
CVSTrac 管理员手册
图 4.2 CVSTrac 主界面
2、 设定 CVS 仓库及用户数据库
通常情况下,管理员首先需要为 CVSTrac 数据库关联 CVS 仓库及设定用户数据库。
在图 4.2 界面中点击“设置”,进入系统设置界面如图 4.3 所示:
(C)Copyright 2001-2005 CnPack 开发组 第 22 页 共 40 页
CVSTrac 管理员手册
图 4.3 CVSTrac 设置主页面
点击“CVS 仓库”链接,进入 CVS 仓库设置界面,如图 4.4 所示:
(C)Copyright 2001-2005 CnPack 开发组 第 23 页 共 40 页
CVSTrac 管理员手册
图 4.4 配置 CVS 仓库页面
在“CVS 仓库”中输入要关联的 CVS 仓库的绝对路径,在“模块前缀”中输入需要过滤的模块前缀
名,如果希望 CVSTrac 管理 CVS 仓库下的所有模块,将模块前缀名留空。
完成后点击“提交”按钮。
如果原来指定过 CVS 仓库,现在重新了修改仓库路径,在提交后可以点击“重新读取
CVSROOT/history”按钮,更新数据库中的相关数据,如图 4.5 所示:
(C)Copyright 2001-2005 CnPack 开发组 第 24 页 共 40 页
CVSTrac 管理员手册
图 4.5 重新读取 CVSROOT/history 页面
CVSTrac 通过分析 history 文件来获得 CVS 提交记录及 CVS 文件名称的,点击“重新构造”按钮
将清空现有数据库,重新构造提交记录编号。通常建议使用“重新扫描”功能,这样将尝试保留现有的数
据。页面上的“备份”链接可以转到备份数据库页面。
完成 CVS 仓库设定后,可回到“主设置菜单”,在图 4.3 页面中点击“用户数据库”链接,进入用户
数据库设置页面,如图 4.6 所示:
图 4.6 设置用户数据库联接页面
(C)Copyright 2001-2005 CnPack 开发组 第 25 页 共 40 页
CVSTrac 管理员手册
CVSTrac 可以用于管理 CVS 的 passwd 文件,允许用 CVSTrac 的用户帐号访问 CVS 并进行读写权
限控制。管理员应根据实现需要,决定是否由 CVSTrac 控制 CVS 的用户帐号。
在设置页面中选择“是”或“否”,点击提交按钮更新设置。
“导入 CVS 用户”按钮将会自动从已有的 passwd 文件中导入用户帐号到 CVSTrac。
建议管理首先进行CVS仓库设定和用户数据库设置,这样在修改用户帐号时可以同步更新CVS帐号。
注:如果使用 Windows 下的 CVSTracNT 配置工具设定了 CVS 仓库路径及用户数据库管理方式,
则此步骤可以跳过。
3、 增加用户帐号
在图 4.2 中点击“用户”链接,进入用户帐号管理页面,如图 4.7 所示:
图 4.7 用户帐号设置页面
点击“新增用户”链接,显示新增用户页面如图 4.8 所示:
(C)Copyright 2001-2005 CnPack 开发组 第 26 页 共 40 页
CVSTrac 管理员手册
图 4.8 新增用户页面
输入新用户信息,并分配相应的权限,点击“应用修改”或“删除用户”进行相应操作。
在图 4.7 中点击用户名,也会显示图 4.8 的界面,可以修改用户设置。
如果系统中存在 anonymous 帐号,则该 CVSTrac 网站允许匿名访问。同时,用户可以使用以下的
链接来访问时间线的 rss 数据:
http://服务器:端口/数据库/timeline.rss
在该例子中,rss 地址为:
http://192.168.1.10/test/timeline.rss
注:管理员第一次登录后,为了系统安全,应该将管理员帐号密码修改为更复杂的密码。如果在
Windows 下使用 CVSTracNT 配置工具为数据库导入了用户帐号,则用户设置部分可以跳过。
4、 数据库及运行环境设置
完成以上的基本设置后,管理员根据需要还可以进行更多的系统参数设置,这些设置在图 4.3 中可以
访问。
(C)Copyright 2001-2005 CnPack 开发组 第 27 页 共 40 页
CVSTrac 管理员手册
4.1 日志文件设置
在图 4.3 中点击“日志文件”链接,显示如图 4.9 所示:
图 4.9 设置日志文件页面
如果需要日志访问记录,可以在日志文件框中输入一个文件名。如果设定了日志文件,CVSTrac 会记
录每一次页面访问,日志文件内容格式如下:
2004-06-01 22:46:06 192.168.1.201 /test/setup_cvs 200 setup 0.04 0 0 0
2004-06-01 22:46:08 192.168.1.201 /test/setup_cvs 200 setup 0.01 0.02 0 0
2004-06-01 22:46:09 192.168.1.201 /test/setup 200 setup 0 0.03 0 0
4.2 附件设置
在图 4.3 中点击“附件”链接,显示如图 4.10 所示:
图 4.10 附件设置页面
CVSTrac 的附件文件是保存在数据库中的,如果文件太大的话,建议不要做为附件上传。此处的设置
同时对任务单及 Wiki 页面的附件有效。
(C)Copyright 2001-2005 CnPack 开发组