1、前言:
CVS是版本控制的利器,目前在Linux和Windows下都有不同版本;但是国内大多数应用介绍都是基于Linux等开放源代码的开放性软件组织,而且讲解的也不系统,让人摸不着头脑;Windows下的CVS使用介绍更是了了无几。
本文是针对Windows的LAN环境下使用CVS的经验介绍,一步一步的向您介绍如何配置和使用CVS的服务器端和客户端。同时,本文只使用到了CVS当中最基本的东西,还有很多更为高级的东西,本文暂不涉及。下面是本文的另一个连接映射,欢迎大家讨论使用,共同进步。
文章连接http://www.kuihua.net/book/list.asp?id=66
论坛连接http://www.kuihua.net/bbs/dispbbs.asp?boardID=1&;RootID=670&ID=670
2、安装版本:
2.1、服务器端(CVSNT)
1. 本文使用的是CVSNT-2.0.4,这是一个比较稳定的版本,不要使用最新的CVSNT-2.1.1,本人在使用中发现有比较严重的Bug。
2. 下载连接http://www.cvsnt.org 目前,它提供2.0.6和2.1.1版本的下载。
3. 上面连接还提供源代码,有兴趣的朋友还可以下载下来仔细研究:)。
4. 有心的朋友,仔细观察就会发现http://www.cvsnt.org 并没有提供任何客户端的下载,那是因为CVS.exe既可以用于服务器端又可以用于客户端,WinCVS是为了客户端使用的方便而定制的外壳。(关于这一点,本人未得到任何证实,只是本人在使用过程中的一种体会,欢迎大家讨论。)
2.2、客户端(WinCVS)
1. 本文使用的是WinCVS-1.3b13,这应该是一个最新版本:),本人在使用过程中并没有发现有任何严重的Bug。
2. 下载连接http://sourceforge.net/projects/cvsgui/
3. 此网站还提供丰富的CVS文档和相关源代码,以及多个OS下面的相关文档和代码;有收藏癖的朋友有福了:)。
4. WinCVS-1.3b13 使用的CVSNT的版本是CVSNT-2.0.2,在与服务器端的CVSNT-2.0.4 版本配合使用时,未发现任何不兼容或冲突现象。
5. 在本人的系统中用cvs version命令显示的结果如下:
Client: Concurrent Versions System (CVSNT) 2.0.2 (client/server)
Server: Concurrent Versions System (CVSNT) 2.0.4 (client/server)
3、服务器端(CVSNT)的安装与配置:
3.1、服务器端机器和环境配置:
1. 操作系统:Windows 2000 Professional SP2中文版
2. 机器名称:Server
3. 机器地址:192.168.0.6 (内部IP)
4. 网络环境:100兆交换局域网
5. 硬盘分区格式:FAT32与NTFS都可以。
6. 准备2个CVSNT的工作目录:
F:KHRoot (存放自己源代码的根目录)
F:KHTemp (存放CVS出错信息的目录)
7. 本机上存在有的用户列表:(由NT或本机的使用者创建)
Administrator (系统管理员)
Jackey (普通用户)
Goury (普通用户)
Riolee (普通用户)
3.2、安装CVSNT:
1. 下载CVSNT-2.0.4;使用administrator登陆到Server机器上。
2. 双击自解压的exe文件,选择Full Install,其它按照默认方式安装;安装完毕后可以在服务控制器中发现多了2个服务:cvsnt与cvslocking
3. 发送Service Control Panel到桌面,形成快捷方式。
4. 安装程序会自动将CVS安装路径,设置到系统的Path环境变量当中,因此使用者可以在控制台(cmd)中任意位置执行cvs.exe,这一点对下面的配置很重要!!
3.3、配置CVSNT服务器:
1. 双击Service Control Panel快捷方式,在Service Status页面,确认2个服务正常和稳定运行。
2. 选择Repository页面,点按Add按钮,选择已经准备好的F:KHRoot这个目录,确认,OK,Yes,这时会在F:KHRoot下面建立CVSRoot目录,这是CVS默认的管理目录(默认模块)。如果报错,那是系统Path路径未设置正确。
3. 选择Advanced页面,勾上Use local users for pserver ...,(Why? I don’t know!J),在Temporary栏选择已经准备好的F:KHTemp,确认,OK。
4. 点按【应用】按钮,确认,退出,OK,搞定!!
3.4、小结:
1. 至此,CVSNT服务器端基本配置完毕,下面进行WinCVS的使用和管理。
2. 由于CVS支持远程管理,也就是客户端与服务器集成的特性,因此,我们将添加用户、权限控制、模块维护等所有的管理工作都放到远端(WinCVS)进行管理,服务器端这时可以Ctrl+Atl+Del进入锁定状态了,下面的所有工作都交给远端的WinCVS来进行管理。
4 客户端(WinCVS)的安装与配置:
4.1 客户端机器和环境配置:
1. 操作系统:Windows 2000 Professional SP2中文版
2. 机器名称:YCW2000
3. 机器地址:192.168.0.2 (内部IP)
4. 网络环境:100兆交换局域网,可以直接访问到Server
5. 硬盘分区格式:FAT32与NTFS都可以。
4.2 安装WinCVS:
1. 下载WinCVS 1.3b13,全部按照默认安装就可以了。
2. 启动WinCVS,开始使用。特别注意:以下的所有操作都是在YCW2000(192.168.0.2)这台机器上远程完成的,此时的Server(192.168.0.6)主机已经进入了锁定状态。
5 管理员使用WinCVS进行远程管理:
5.1 配置WinCVS成管理员状态:
1. 准备管理员工作目录:(在YCW2000机器上)
E:CVSClientAdmin (管理员工作目录)
E:CVSTemp (WinCVS临时目录)
2. 第一次启动WinCVS时会自动弹出Preferences配置页面,也可以通过Admin=>Preference菜单进入;第一次使用时需要配置如下的3个页面:
General页面设置:
注:按照图示方式输入即可,需要注意的是Path部分的格式是Unix路径格式,它指的是CVSNT端设置的工作根目录。
CVS页面设置: 注:Home路径是设置密码等文件的存放位置,必须指定,否则在登陆时,WinCVS也要弹出设置框。这个Home路径需要Python.exe这个外挂程序才有效。这里选择已经准备好的路径:ECVSTemp
WinCVS页面设置:
注:此页面设置WinCVS的外挂编辑程序,通常使用UltraEdit比较方便。
3. 设置管理员的工作路径:可以点按图标 ,或View=>Browse Location=>Change…菜单进行设置,选择已经准备好的路径:E:CVSClientAdmin,确认,OK,这时此目录将出现在WinCVS的左边导航栏【Workspace】内。
4. 至此,WinCVS就被配置成了远程的管理员使用状态,下面进行一般管理员需要的基本操作演练。演练的内容为:Administrator需要管理Jackey,Goury,Riolee三个用户,分别为这3个用户建立工作目录,每个人只能访问自己的工作目录。同时,只有Administrator能够进行权限分配,其它人没有任何管理权限。
5.2 管理员进行管理演练:
1. 登陆远程CVSNT:
◇ 选择Admin=>Login菜单,默认设置,OK。
◇ 弹出密码输入框,确认,OK。注意观察输出框【OutPut】的返回结果。
2. Checkout默认模块:(CVSRoot管理模块)
◇ 在左边导航栏【Workspace】内,选择【Admin】点按右键,选择【Checkout
modules…】,在【Checkout settings】中输入CVSRoot,确定,OK。如下图:
◇ 如果成功的话,会在【Admin】栏下增加一个【CVSRoot】目录。表示您已经将【
CVSRoot】这个管理模块下载到本地了。
3. CVS中目录权限介绍:
◇ 系统支持的目录权限列表:
r (读取权限)
w (写入权限)
c (创建和删除权限)
n (没有任何权限)
◇ 默认情况下,任何用户都拥有任何目录的所有权限。
◇ 任何情况下只有目录的拥有者和Administrator才有权力更改目录的使用权限。下面将会介绍如何修改目录权限和目录的拥有者。
4. 修改CVSRoot的权限:只让Administrator拥有rcw三种全部权限。
◇ 选中刚刚下载的【CVSRoot】模块,【Ctrl+L】或Admin=>Command Line…,弹出Command Line Settings对话框,直接执行CVS命令。
◇ 取消所有用户的默认权限:cvs chacl default:n 回车,OK,完成。
◇ 设置Administrator拥有所有权限:cvs chacl administrator:rcw 回车,OK,完成。
◇ 更改【CVSRoot】的拥有者:cvs chown administrator 回车,OK,完成。
◇ 查看【CVSRoot】的权限状态:cvs lsacl 回车,OK,在【Output】中显示:
Owner: administrator
default:n
administrator:rwc
◇【CVSRoot】的权限配置完毕。
5. 编写代码库中的模块文件,便于多用户下载方便。
l 需要自己编写的模块文件格式如下:(实现基本功能)
【模块一的描述】【n个空格或参数】【相对目录路径一(DirA)】
【模块二的描述】【n个空格或参数】【相对目录路径二(DirB)】
……
【模块X的描述】【n个空格或参数】【相对目录路径X(DirX)】
◇【描述信息】与【相对路径】在字面上不一致时,需要使用-a参数。
◇ 【相对路径】指的是CVS会自动带上根路径,这里是F:KHRoot,所以上面例子的完整路径为:F:KHRootDirA
◇ 了解了模块文件结构,现在来实际操作一把:双击【CVSRoot】模块下的modules文件,用UltraEdit打开进行编辑。
◇ 为Jackey,Goury,Riolee三个用户分配工作目录和完成其它模块描述。
CVSRoot CVSRoot
Jackey工作目录 -a Jackey
Goury工作目录 -a Goury
Riolee工作目录 -a Riolee
◇ 编辑完毕,存盘。回到WinCVS,选中modules这个文件【Ctlr+M】或右键选择【Commit selection…】,默认设置,【确认】,OK,完成上传。
6 . 为三个用户分别上传工作目录:
◇ 在YCW2000机器上的E:CVSClientAdmin分别建立三个目录分别名为:Jackey,Goury,Riolee,作为临时交换目录。
◇ 在新创建的每个目录中用UltraEdit或拷贝一个Readme.txt作为引子文件!!:)
◇ 然后,回到WinCVS,在【Workspace】栏的【Admin】目录下形成如下的目录结构:
◇ 分别选中Goury,Jackey,Riolee,右键,点按【Import Module】,选择【Continue】,其它全部使用默认值,【确定】,OK,完成上传工作。
◇ 仔细观察【Output】窗口,确认都成功上传了。
◇ 转移到系统的Explore程序中,删除E:CVSClientAdmin目录下的Jackey,Goury,Riolee三个目录。然后回到WinCVS当中。(一定要删除!!!:)
◇ 至此,就完成了工作目录的上传工作。
7. 【Checkout】下载3个用户的工作目录到【Admin】目录下:
◇ 在【Workspace】栏选择【Admin】目录,右键,点按【Checkout Module…】,如下图:
◇ 选择【…】,得到CVSNT上最新的模块配置情况,弹出如下的信息框:
◇ 这个结构图就是刚才在modules当中编写的模块文件格式信息。选择【Jackey工作目录】,下载到YCW2000机器的E:CVSClientAdmin目录下。
◇ 按照以上操作,依次分别下载【Goury工作目录】和【Riolee工作目录】。形成如下状态:
8. 为三个用户分别设置各自目录的访问权限。(只有自己才能访问自己的工作目录)
◇ 选中【Goury】目录,【Ctrl+L】或Admin=>Command Line…,弹出Command Line Settings对话框,直接执行CVS命令。
◇ 取消所有用户的默认权限:cvs chacl default:n 回车,OK,完成。
◇ 设置Goury拥有所有权限:cvs chacl goury:rcw 回车,OK,完成。
◇ 查看【CVSRoot】的权限状态:cvs lsacl 回车,OK,在【Output】中显示:
Owner: administrator
default:n
goury:rwc
◇ 按照以上的方法依次分别设置【Jackey】与【Riolee】的工作目录访问权限。
◇ 至此,完成了3个用户的目录权限分配。注意,虽然Administrator也没有权力再次【Checkout】那3个用户的工作目录,但是它是这些目录的拥有者又是Administrator,因此,只有它才有权力更改这些目录的访问权限。
9. CVSNT系统中的用户管理原则:
◇ CVSNT的用户与本机(这里是Server机器)上的NT用户是相关联的,即CVSNT用的全是本机上存在的已有用户,因此在默认情况下可以不用设置任何用户名,只要使用本机上已经存在的用户名就可以用WinCVS进行登陆。
◇ 只有用Administrator身份登陆到CVSNT系统中,才有权力进行新用户的创建和删除。
◇ 使用CVS创建的新用户,必须与服务器端机器上的NT用户相绑定,才能生效;因此,这个新用户实际上是绑定它的NT用户的一个替身,在CVS系统中称为“别名”。
◇ 一个NT用户可以有多个‘替身’或‘别名’,充当多个CVS用户。
10. 用WinCVS进行新用户的添加和删除。(确保使用Administrator登陆)
◇ 【Ctrl+L】或Admin=>Command Line…,弹出Command Line Settings对话框,直接执行CVS命令。
◇ 添加新用户【Killer】:cvs passwd -a Killer 回车,设置密码,OK,完成。
◇ 绑定【Killer】到【Jackey】:cvs passwd -r Jackey Killer 回车,设置密码,OK,完成。
◇ 两次输入的密码可以不同,但以第二次输入的密码为最终密码。
◇ 删除用户【Killer】:cvs passwd -X Killer 回车,OK,完成。
◇ 其它特殊的功能查看passwd命令的帮助。
11.使用完毕后,一定要【Logout】,因为WinCVS退出时并不会自动注销自己在远端的会话;这样做是为了防止其它人接着打开WinCVS,不用登陆就可以完成你能进行的所有操作了。
6 WinCVS中常见的特殊操作:
6.1 如何删除下载的文件或目录:
1. 选中下载的某个或多个文件,执行【Remove】命令。
2. 再次选中这些文件,执行【Commit】命令就完成了删除文件的操作。
3. 本质上CVS是不会删除任何文件和目录的,即使是执行了以上操作,删除了某些文件,远端CVS实际执行的是将提交删除的文件放到了一个叫【Attic】的目录下,因此,这些被删除的文件是可以通过一定的方法恢复的。
6.2 如何恢复已经删除的文件或目录:
1. 在执行了【Remove】命令之后恢复文件。
◇ 【Ctrl+L】直接输入命令cvs add xxxxx,或执行【Add Selection】界面操作。
◇ 这样就可以直接恢复还未提交的删除文件。
2. 在执行了【Commit】命令之后恢复文件。
◇ 只能用【Ctrl+L】直接输入命令cvs add xxxxx,这时会得到一个空的文件。
◇ 选中这个空文件,执行【Update】操作,得到这个文件的实体。
◇ 再次选中这个文件,执行【Commit】操作,得到这个文件最新版本。
3. 由于CVS系统中本质上不会删除任何目录,因此,谈不上对目录的恢复,但是CVS系统默认情况下是要在用户本机上(如:YCW2000)要删除空目录,因此,可以用如下方法得到已被删除的空目录:cvs checkout -p xxx,也可以在Admin=>Preference的【Globals】页面进行设置。
4. 可见,CVS系统能够保证:只要上传到服务器的文件,无论你怎么在远程进行如何的操作,正常的或非正常的操作,都可以用Administrator登陆上去,通过以上的方法找到丢失的文件。除非用户进入到远端服务器,将文件手动删除,那就没办法了:)
6.3 如何得到以前版本的文件:
1. 有时我们需要得到以前版本的文件,而WinCVS默认方式只传递最新的版本。
2. 选中某个文件,【Ctrl+G】或右键,点按【Graph selection…】,使用默认设置,就可以得到该文件所以版本的图形结构描述。
3. 选中一个版本,右键,点按【Retrieve revision】,就可以得到相应的老版本文件。当然也可以得到最新版本的文件:)
6.4 有时WinCVS会变得异常缓慢,怎么办?
1. 确认安装了WinCVS的机器上没有安装CVSNT服务器端,因为它们使用的版本有可能不一致。
2. 只安装了WinCVS,但以前安装过其它版本的WinCVS,怎么办?
3. 先卸载所有的WinCVS系统,删除安装目录下的残留文件。
4. 打开注册表编辑器,全程查找cvs关键字,找到一个删除一个,一直到找不到为止!!:)
5. 重新安装WinCVS,这个问题基本上就可以解决了,我就是这样解决,不晓得你那里如何?:)
7 其它说明:
1. 本文的重点在介绍如何让使用者搭建CVSNT+WinCVS这个系统,因此重点介绍了管理员的常用操作,至于一般用户使用到的操作,相对比较简单和单一,使用WinCVS的次数多了,很快就会熟悉它了。
2. 这篇文档只是窥探了CVS的一点皮毛而已,CVS当中还有很多高级的用法,以及上百个命令,还有很多新鲜的管理源代码的方法,比如:tag,branch等模式;因此,热烈欢迎大家积极探索,不断共享,不断进步。。。。。。。。
3. 另外,cvs.html这个帮助,里面的信息也很丰富,但是,很多地方写得不够清楚,需要不断猜测和实践才能知道怎么回事,本文的很多经验都是看这个帮助,如此这般,采用这个笨办法得到的。。。。。。
4. 最后,祝愿看到此文的人,得到的帮助、提高等好处大于或等于浪费的时间、反而退步等坏处!!
From: http://www.kuihua.net/wendang/win1.asp