CVSNT+Wincvs安装配置

pdf文档下载

目 录

基础篇... 2
1 CVSNT安装配置... 2
1.1 CVSNT安装:... 2
1.2.建立仓库... 2
1.3.建立用户... 3
2  Wincvs安装配置... 4
2.1安装... 4
2.2用户登陆... 4
2.3 管理CVS用户... 5
2.4 导入模块... 7
2.5导出模块... 10
进阶篇... 14
3使用脚本语言... 14
3.1安装脚本... 14
3.2指定语言库路径... 14
3.3使用脚本功能... 15
4 用户权限控制... 17
4.1设定管理员... 17
4.2建立用户组... 17
4.3赋予权限... 17
4.4权限规则... 20
结束语... 20

 

 

CVSNT+Wincvs安装配置

作者:oyoung   完成日期: 2006-8-16      邮件: oyoung6@hotmail.com

出处:http://blog.csdn.net/oyoung

版权声明:本文档可任意转载,但请勿修改内容,转载时请务必标明作者和出处信息。

 

CVS做版本控制已经有很长一段时间,有一些经验教训,很早之前就想下来,不过到现在才有时间把这些东西整理出来和大家一起分享,希望对大家有所帮助。

我们在网上看到很多CVS的文章都是基于用LinuxCVS服务器的,介绍windows的很少,不过用windows做服务器还是有的。下面我就介绍下Windows XP下的CVS服务和客户端的安装配置。

基础篇

1 CVSNT安装配置

 

1.1 CVSNT安装:

版本:cvsnt-2.5.02.2115

下载:http://www.march-hare.com/cvsnt/features/cvsnt/

 

CVSNTwindows下的CVS服务器,安装在服务器端。我们只需默认安装即可,然后重启。值得一提的是要注意版本,开源项目有些版本就是不稳定。我曾经试过安装过一个版本(具体不记得了,也是2.5的),用到rtag命令打标签,和用python产生baseline report时就报错,后来换成了现在这个版本就没问题了。这个版本用到现在还没发现有什么问题,个人认为应该是比较稳定的。

 

1.2.建立仓库

 

先建立需要放仓库的目录,比如D:/cvs_repository/oyoung。然后程序菜单里打开CVSNT->CVS NT Control Panel,在Repository Configurationadd,添加你的仓库路径和名字,如下图:

 

 

确认后,会提示要初始化仓库目录,确认即可。现在看下你的仓库目录D:/cvs_repository/oyoung,是不是多了个文件夹CVSROOT呢?如果有的话,就恭喜你了,这个CVSROOT就是这个仓库的配置管理文件库。

 

1.3.建立用户

 

在你的windows建立administators角色的用户cvsadmin cvsuser,用于映射后面的cvs管理员和普通用户。

 

1.4.确保上面建立的用户cvsadmincvsuser有权限访问你的CVS Temporary目录,如下图:

 

 

2  Wincvs安装配置

 

Wincvscvs的一个客户端图形工具,不管服务器是windows还是Linux,都可使用。Wincvs提供了大部分的图形操作界面,避免了直接用cvs命令来控制。如果你要用到高级的功能,也可以在它的命令窗口里输入执行。下面我们来介绍下wincvs的安装和配置。

 

2.1安装

版本:wincvs 2.0.2.4 (build 4)

下载:http://www.wincvs.org/download.html

 

直接点下一步即可。使用wincvs前请务必先安装cvsnt。因为上面我们说过,wincvs只是提供了图形的操作界面,图形的操作也是要转成相应的cvs命令来执行。但我们不是装服务器,所以不必配置cvsnt,只要安装就好了。

2.2用户登陆

现在我们打开wincvs,在菜单栏里选择“admin->login,勾选CVSROOT,点后面的“。。。”按钮,添加CVSROOT信息,如下图:

 

l         protoco:传输协议,默认用pserver,其他的没去研究.

l         respository:表示你的cvs仓库,刚才我们已经建立了仓库oyoung,前面加正反斜杠都可以

l         username:现在就是我们的操作系统帐号

l         password: 操作系统帐号密码

l         hostname:服务器的主机名或IP

l         port:cvsnt的端口号,默认为2401

l         其余可不填(没去研究J

 

 

配置完后,点确定,如果wincvs输出框提示如下图信息,则表明登陆成功。注意一点,CVS exited normally with code 0表示操作成功,而“CVS exited normally with code 1表示操作失败,这个我们和经常用到的Boolean值刚好相反!

 

 

2.3 管理CVS用户

上面我们建立的是操作系统的用户,可以用来登陆CVS,但是这样就依赖于操作系统,而且我们不可能为每一个用户都建立一个操作系统帐号,所以我们应该用CVS的帐户管理。

         2.3.1添加用户:

wincvs->admin->command line,勾选“CVSROOT,选择刚才输入的CVSROOT信息,在命令框里输入“cvs passwd -a -r cvsadmin admin”,建立CVS帐号“admin”,并映射到系统帐号“cvsadmin,然后输入密码,如下图(详细可参考passwd命令):

 

这样我们已经为cvs添加了用户admin现在我们看下服务器仓库oyoung下的CVSROOT,就会发现多了个文件passwd。里面一行代表一个用户,记录了映射的操作系统帐号和cvs帐号和密码,如下:

 admin:A.f0Kvdiyy8q2:cvsadmin

        2.3.2 赋予管理员权限:

        上面我们已经添加了cvs帐号admin,但只是一般的用户,我们需要指定哪些帐号为管理员,以有权限进行配置管理。为此我们进入到服务器上仓库oyoung下的文件夹 CVSROOT,新建一个文件admin(注意无后缀名),里面添加admin为管理员。可以添加多个管理员,一个帐号一行,如下:

admin

 admin2

 

现在admin已经是管理员,可以使用管理员的功能了,如添加用户,管理用户权限等。现在我们就以admin身份了再添加一个普通用户 land,如下图:

 

 

添加用户成功,以后我们还会谈到用户权限控制问题。

 

2.3.3停用操作系统帐号

映射完毕后,我们就可以完全使用cvs帐号,而禁止操作系统帐号登陆。我们只需修改仓库oyoung下的CVSROOT/config文件(这个CVSROOT也可checkout到本地修改,下面2.5节会有介绍),将第2行修改,如下:

SystemAuth=YES

修改为:

SystemAuth=NO

 

现在我们再用刚才的cvsadmin操作系统帐号登陆就会失败了!

 

2.4 导入模块

        一切都准备好以后,我们就可以把需要进行版本控制的文件导入到我们刚建立好的oyoung仓库了。比如我要把spring文件夹里的全部东西导入到仓库oyoung里。这里有两种办法:

2.4.1 利用wincvs图形导入

wincvs下工具栏的浏览框里找到你要导入的目录spring,然后在左边树形菜单里右键spring,选择”import module…”,如下图:

 

 

Wincvs会对要导入的文件过滤,提示一些信息(如下图),但我们一般可以不理它,如果文件很多的话,这样的过滤会消耗很多时间,所以我们又可以用下面的第2种方法(命令行导入),这样就可以避免这些过滤。

 

       ok后,弹出对话框填写Repository(服务器上的模块名),Vendor tag(厂商标签)Release(发布标签),和选择CVSROOT.标签里不要使用空格,最好用下划线”_”连接。如下图:

 

       

 

确定后,如果提示如下信息,那么恭喜你!导入成功了!

 

 

2.4.2命令行导入

        上面提到过,可以用命令行导入来避免文件的过滤。实际上,我们在cvs上用到的一切操作,都是要转成CVS相应命令执行的。如上面的图形导入,我们在输入框里就可以看到它转成了下列的命令执行。如下图:

        现在我们打开”admin->command line”,为了避免和刚才导入的模块名spring重复,我们把模块名改成spring_cmd,最后命令如下:

 

cvs import -m "演示命令行导入" spring_cmd MiTAC_ECOM import

 

然后选择CVSROOT,如下图:

 

       

 

确定后,我们同样可以看到导入成功,并在服务器上看多了一个spring_cmd模块。

 

最后要注意的是,CVS默认认为空目录不存在,所以如果spring里有空文件夹,,这个空文件夹将不会被导入。但是有时我们需要导入一个空目录,比较笨的方法就是随便建立一个文件,空文件也可以。如上面的spring/empty,我就建了一个空文件readme.txt.如下图:

 

 

2.5导出模块

       在导入模块后,我们就可以在把模块导出来进行控制了。首先我们在cvs浏览框里选择你要把模块导出到哪里,比如我的是E:/dev,然后在菜单里右键dev.选择“checkout module“,如下图:

 

在弹出的对话框里填入相关信息,如下图:

 

 

l         Module name path on the server:   要导出的模块名或模块下的某个目录

l         Check out into directory: 导出到本地的目录结构

l         Don’t shorten module paths:截短模块路径,是Check out into directory的子项。勾选则把模块(包括WebRootsrc)导出到e:/dev/java/spring.;否则导出到e:/dev/java

l         CVSROOT:这里我们用普通用户land身份导出模块。

l         Do not recurse into sub-directory:不导出子目录的内容

l         Do not create the CVS administrative directory:不导出cvs管理文件。这在我们项目发布时相当有用。

 

如果我们不清楚模块名,或者只想导出模块下的某个目录,那么我们可以点“Module name path on the server “后面的浏览按钮。在对话框里选择CVSROOT和勾选List,再点”Refresh(F5)”,就可以看到刚才我们导入的两个模块,如下图:

 

这样我们就可以自由选择要导出的目录了。如果你是管理员身份,,那么你还可以看到CVSROOT仓库管理模块,你也可以导出到本地来修改文件。

 

另外我们还需要在Globals面板里设置Files为“Read-only,这样导出的文件为只读。以后我们commit一个文件后,文件也会变成只读,这对文件冲突管理相当有用。”Prune empty directory”,勾选则不导出空目录,这个视需要而定。其余选项就不多说了。如下图:

 

 

确定导出成功后,我们在e:/dev/java下看到了spring这个模块。如下图:

 

 

注意:导出的目录里不能有和cvs上的目录,文件名相同,否则会提示“it is in the way“错误。比较常见的情况是,可能我们项目中途才开始用CVS来管理,那么开发人员本地已经有了模块的某些部分(如已有了e:/eclipse/spring/WebRoot),只需没有那部分就行了(src)。那么我们想只需要在e:/eclipse/导出spring模块,WebRoot会被cvs上的覆盖,而src也导出来了。如下图:

 

 

确定后,我们发现src模块已经被成功导出,但WebRoot模块却出现了问题。如下图:

 

 

因为WebRoot模块里已经存在了userEdit.jspCVS就无法再将这个文件导出覆盖本地文件,所以userEdit.jsp状态还是Unkown,没有和cvs关联。解决办法就是在本地把WebRoot文件夹全部删除,然后再从CVS全部导出,实际上不算办法^_^(不知道CVS为什么不提供覆盖L)。

 

 

至此,CVS的安装和基础配置我们就已经做好,包括经建立cvs服务器,建立仓库,导进模块,导出模块。现在我们就可以使用cvs进行版本控制,至于wincvs的使用,很多文章都有介绍,我就不再废话了。下面讲下一些使用脚本语言和用户权限控制。

进阶篇

3使用脚本语言

3.1安装脚本

3.1.1 安装python

     版本:2.4.3

     下载地址:http://www.python.org/ftp/python/2.4.3/python-2.4.3.msi

     安装比较简单,直接点下一步即可。

3.1.2 安装perl

        版本:5.8.8.817

地址:http://downloads.activestate.com/ActivePerl/Windows/5.8

/ActivePerl-5.8.8.817-MSWin32-x86-257965.msi

安装比较简单,直接点下一步即可。
3.1.3 安装tcl

版本:8.4.13

 地址:http://downloads.activestate.com/ActiveTcl/Windows/8.4.13

/ActiveTcl8.4.13.0.261555-win32-ix86-threaded.exe

安装比较简单,直接点下一步即可.

 

3.2指定语言库路径

安装完3个脚本语言之后。打开wincvs->Admin->Preference->Wincvs.指定TCL DLL的路径到你安装的tcl库。注意不用指定Python,如下图:


 

3.3使用脚本功能

完成上述的步骤后,打开wincvs->Macros.我们就可以看到多了很多的功能。这些都是用上面3种语言写的,代码在你安装的Macros目录下,如D:/Program Files/GNU/WinCvs 2.0/Macros。当然,如果你也可以用这些脚本语言自己写一些功能。我们也可以下载脚本放到该目录下,相关下载见:

http://ximbiot.com/cvs/wiki/index.php?title=CVS_Clients

在这里,我们只介绍其中的一些功能,其他的自己可以试一下。

3.3.1  产生修改日志

    这个功能可以根据条件统计所有commit到服务器的文件。

首先进入 Macros->cvs->Build changeLog (advanced),给文件命名:ChangeLog20060816(land),如下图:

 

 

ok后,再填写选项,如下图:

l         w 只列出登陆人的修改文件。否则列出全部用户

l         r  列出某个分支,从开始到结束标签之间的

l         d 列出日期之间的。这里”<”表示大于等于开始日期,小于结束日期,所以上面命令d2006-08-16<2006-08-17只列出2006-08-16这一天的修改文件。

 

OK后就会在当前目录产生文件ChangeLog20060816(land),内容如下图:

我们可以看到,它列出了修改人land20060816,把修改后版本是1.3文件的userList.jsp Commit进了服务器,注释是:第二次修改。

 

3.3.2  利用输出窗口当命令窗口

      现在我们可以在wincvs的输出窗口里直接输入cvs命令,然后回车执行即可,非常方便。比如我们输入登录命令,然后回车,它就会以当前路径的CVSROOT登录,如下图:

 

 

4 用户权限控制

4.1设定管理员

 首先我们要指定管理员。添加一个帐号admin,然后赋予它管理员的权限,具体操作见上面2.3.

4.2建立用户组

我们可以把用户权限我们都分配到组,这样方便于管理。在仓库oyoungCVSROOT里建立文件group,并把相应帐号归到各个组下,帐号之间用空格间隔。如下:

PMGrp:land

RDGrp:simon oyoung

TestGrp:test

上面建立了3个组, PMGrpRDGrpTestGrp,然后我们把用户land归到PMGrpsimonoyoung归到RDGrptest归到TestGrp

4.3赋予权限

     CVS5种权限,read,write,create,tag,control,各种权限对应的操作如下:

 

l         Read:可以更新,读取

l         Write:可以编辑,commit,删除

l         Create:可以建新的文件

l         Tag: 可以打标签

l         Control:可有权限修改文件的权限,

 

.如果我们没有限制,那么全部用户都可以拥有上述前4种权限。而control这个权限会分配给文件创建者和管理员。

4.3.1 显示权限列表

命令:cvs lsacl(详细可参考Wincvs自带有的CVS帮助文档)

选项:

l         -d 只列出目录而非文件 

l         -R  递归

 

首先我们要以admin身份导出spring模块,为方便比较,模块还是导出到e:/dev/java,不过模块名改成spring(admin),以区分land身份导出的spring.如下图:

 

我们选中spring(admin)/WebRoott/WEB-INF,然后在Wincvs的输出框里,输入命令”cvs lsacl”,然后回车,结果如下图:

 

 

列出了WEB-INFowneradmin.

4.3.2 添加删除用户权限

命令:cvs chacl(详细可参考Wincvs自带有的CVS帮助文档)

选项:

l         -a 添加权限

l         -d 删除权限

l         -u 指定用户或组

l         -m 指定错误提示信息

l         -p 指定优先级

4.3.2.1 添加用户权限

     比如,我们禁止组PMGrpspring(admin)/WebRoot/WEB-INF的写权限,这样组成员land就不能updateedit WEB-IN文件夹里的所有文件。首先选中spring(admin)/WebRoot/WEB-INF,然后输入命令,如下图:

 

现在我们用cvs lsacl 看下权限分配情况,结果如下图:

已经显示添加了禁止写权限,那么我们再看下实际情况,我们选中spring/WebRoot/WEB-INF/struts-config.xml(这个是以land身份登录的),然后选中菜单栏的Trace->Reserved Edit 编辑它,如下图:

 

结果提示,编辑错误,如下图:

   如果我们强行修改,然后commit,也会提示错误,如下图:

4.3.2.2 删除用户权限

我们删除刚才添加的权限,修改命令,如下图即可:

 

 

4.4权限规则

有时我们对目录和其下的文件,或者对用户和所在的组设定不同的权限,这样就会带来权限的冲突。CVS会遵循一定的规则,经过实际测试,总结了以下几条规则:

1         目录权限>文件权限

当对目录和其下的文件赋予不同的权限给同一个用户时,则目录权限覆盖文件权限。

2         用户权限>组权限

当对同一文件赋予了不同的权限给用户和其所在组时,用户权限覆盖组权限。

3         顺序规则

当用户属于多个组,而各个组发生权限冲突时,则以cvs lsacl列出的顺序靠前的为准。而排序的参数是以我们设定权限时用-p指定的参数,排序规则按字符串升序排。

 

 

 

 

 

 

结束语

    花了3天时间终于把整个文档整理了出来,都有点累不想写了,所以后面权限规则我都没做实际演示,希望各位能够原谅。其实我还想写下Wincvs的日常使用,不过网上这方面的资料很多,我就懒得再去大费口舌了。需要提醒一点就是,关于文件冲突管理部分:我们编辑文件时最好用Reserved Edit(保留编辑),这样第2个人再用Reserved Edit编辑这个文件时,CVS就会告诉他错误,因为某某在哪什么时候正在编辑这个文件。好了,再说就不叫结束语了,希望这个文档对大家有所帮助!也欢迎来信交流指正!

 

 

 

 

 
阅读更多
想对作者说点什么? 我来说一句

没有更多推荐了,返回首页