第一部分 CVS服务器的配置(以1.10版) 作者：吴炎溪 Email:Yanxi-Wu@21cn.com 1、CVS简述与CVS服务器的安装： CVS是目前比较流行与优秀的版本管理与控制工具，它深受大多数开发人员与系统管理的喜爱，同时也是用来管理其它日常文档（如word工作文档之类）的一个强有力的工具。这一部分将对CVS服务器的安装、配置与使用方法进行简单、扼要的介绍，以帮助大家尽快的使用CVS来进行一些版本的管理与控制工作。 2、CVS服务器的安装 CVS服务器版可以从网上的很多地方下载到，也可以到CVS的官方网站进行下载。根据你所使用的系统，下载相应的版本，然后进行安装。因为当前大部分人是在Linux下使用CVS服务器进行版本管理，并且Redhat Linux是目前最流行的一个Linux发行版之一，所以本文将主要基于Redhat Linux进行介绍。首先下载CVS服务器的rpm包，当然也可以下载其它方式的包如源程序包，这也就是Linux的一个优点之一。然后采用以下命令进行安装： rpm -ivh cvs-1.10.8-3.i386.rpm 3、配置/etc/services文件： 安装完之后的第一件事就是要配置CVS服务器的配置文件，使其能正常的工作。首先在services文件中添加cvspserver，使其成为Linux的一种服务也就是cvs服务器例程的入口，配置如下： cvspserver 2401/tcp # cvs client/server operations cvspserver 2401/udp # cvs client/server operations 4、配置xinetd，用xinetd来启动CVS服务器： 进入到/etc/xinetd.d/目录，然后编辑一个文本文件，名字一定要与/etc/services中的入口名字cvspserver一致，所以这里用cvspserver作为文件名，文件的内容如下所示： service cvspserver { disable = no socket_type = stream wait = no user = root env = HOME= server = /usr/bin/cvs server_args = -f --allow -root=/home/cvsroot pserver //指定认证方式为pserver，注意：-f } 注意：a、service后面的名称一定要和你在/etc/service文件中的cvs服务名称一样； b、env = HOME=这一行的目的就是为了解决在执行一些cvs操作时产生的读取/root/.cvsignore文件的错误，上面env那行的意思就是在运行cvs服务的时候将环境变量HOME置空，这样虽然执行cvs的用户是root，但是由于没有了HOME这个环境变量，所以cvs就不会在去读取/root/.cvsignore文件了。 5、配置CVS用户与cvsroot的属主与属组： 首先建立一个用户组cvs，可以使用groupadd或者addgroup命名，也可以直接编辑/etc/group文件添加这个组，然后添加一个用户cvsroot， 然后修改/etc/passwd文件使cvsroot用户的缺省组是cvs组，而不是cvsroot组（也就是修改）。在/home目录下建立cvsroot目录（也可以在其它你喜欢的目录下建），然后修改/home/cvsroot的属主及属性： #chown cvsroot.cvs /home/cvsroot #chmod 771 /home/cvsroot 6、vs进行初始化： 安装完CVS服务器之后的另一件重要的事情就是要初始化CVS服务器的根目录，以后创建的CVS项目都将建立在这个目录下，采用的命令如下： ＃cvs -d /home/cvsroot init 这样目录/home/cvsroot就成为CVS服务器的根目录，以后创建的目录都将默认的存放在这个目录下。 7、登录cvs服务器（在Linux或其它Unix系统下进行登录的情况）： a、如果是远程登录，采用以下语法： #cvs -d :pserver:cvsroot@host:/home/cvsroot login CVS password：//输入用户cvsroot的口令； 如果没有出现其它的任何提示就表示登录成功了，否则要根据提示进行相应的修改。 下面对登录命令的语法进行说明： 其中，:pserver表示采用pserver方式进行用户登录认证，一般的CVS服务器都采用这 种方式，当然也可以采用其它方式，具体参考相应的资料； :cvsroot表示要登录的用户名，只要是cvs组的成员都可以，如：cather； @host表示要登录的服务器，可以是DNS名，也可以是IP地址，如：10.104.1.204； :/home/cvsroot表示CVS在服务器上的目录，也可以是其它目录（由第6中你所 指定的用来做init初始化的目录决定）； 提示：也可以把export CVSROOT=:pserver:jchuang@192.168.0.8:/home/cvsroot这一句直 接写在用户的初始化文件中（如：.bash_profile），这样用户每次登录时，只需输入： ＃cvs login 然后输入相应的口令就可以登录到cvs服务器上。 b、如果是本地登录，可以直接把export CVSROOT=/home/cvsroot这一句写在用户的初 始化文件如：.bash_profile中；然后直接 8、向CVS添加新的项目模块 一般我们都已经有一个或多个项目了，这样我们可以用下面步骤生成一个新的CVS项目。将一个工程文件置于CVs中进行版本控制，在CVS 术语中称作导入(import)。从名字上就可以看出，在导入前需要为此作些准备工作。 输入操作的基本要求是有个"干净"的目录结构。"干净"的意思是不需要版本控制的文件都被移走了（如编译生成的文件，备份文件等等）。如果工程已经开始一段时间了，这就显得很重要。在目录中也许有些是不打算将其置于版本控制下的文件，但是又想将他们放在这里，这种情况下，你要在输入之前将它们移走，然后再移回来。 　　注意的是CVS 认为空目录是不存在的。如果想增加一个既不包含文件又不包含子目录的目录，需要在其下创建一个哑文件。建议你创建一个名为 README.txt 的文件，其内容为对目录的简要说明。 　　进入到已有项目的目录，比如叫 cvstest： 　　$cd cvstest 　　运行命令将项目文件导入到cvs仓库中： 　　$cvs import -m "this is a cvstest project" cvstest v_0_0_1 start 　　说明：import 是cvs的命令之一，表示向cvs仓库输入项目文件． 　　-m参数后面的字串是描述文本，对项目进行描述，如果不加 -m 参数，那么cvs会自动运行一个编辑器（一般是vi，但是可以通过修改环境变量EDITOR来改成你喜欢用的编辑器）让你输入信息，cvstest 是项目名称（实际上是仓库名，在CVS服务器上会存储在以这个名字命名的仓库里） 　　v_0_0_1是这个分支的总标记．没啥用（或曰不常用） 　　start 是每次 import 标识文件的输入层次的标记，没啥用。 　　这样我们就在用户指定进行初始化的目录/home/cvsroot下建立了一个名字叫cvstest的CVS模块了，然后，我们可以把这个测试项目的文件删除，试验如何从仓库获取文件这会在后面的客户端文章进行说明。 (注：本小节主要引用自http://linuxaid.com.cn何伟平的“CVS服务器快速指南”) 9、从cvs本地服务器上checkout相应的模块： a、如果是在CVS服务器所在计算机上，可以直接采用如下命令： #cvs checkout stw 这样将把stw项目模块checkout到当前目录下。 b、如果是在远程运行Linux或其它Unix系统上，在第7中登录之后也可以用上边的命 令把相应的项目模块checkout到当前目录下。 另外，如果是在windows端进行checkout，可以采用WinCVS，那么还要对WinCVS进行其它的一些配置，下一部分将具体介绍它的配置方法。 第二部分 WinCVS的配置与使用方法 1、WinCVS简介： WinCVS是CVS的一个客户端软件，它运行在Windows上，用来在Windows上登录CVS服务器，然后进行一些CVS相关的操作与管理。由于当前很多的企业内部都采用Linux/Unix做服务器，而用Windows做客户端，所以，WinCVS与CVS服务器配合使用将组成最强有力的版本控制与管理的系统之一。 2、WinCVS的下载与安装； 最新的WinCVS可以从http://sourceforge.net/project/showfiles.php?group_id=10072地址下载到，也可以在http://sourceforge.net/project 上下载到最新的或其它版本的WinCVS。 下载到相应的版本后根据向导进行安装，已经要使用CVS的用户，安装这个WinCVS应该没什么问题吧！ 3、配置WinCVS： a、一般选项的设置，选择Admin->Preferences…，出现如下界面： 第一、Authentication：用来配置cvs服务器的认证方式，可以从下拉框中选择其它的认证方式，不过一般只要选择默认的pserver方式就可以，要注意的是必须与cvs服务器配置时所指定的认证方式一致； 第二、Path：用来配置cvs在服务器上的主目录路径，也就是服务器上用进行cvs初始化的目录，如：/home/cvsroot； 第三、Host Address：用来配置cvs服务器所在服务器的地址，可以是IP地址，也可以是DNS名，如：10.104.1.204； 第四、User name：用来配置要使用些WinCVS来登录CVS服务器的用户名，如：cvsyxwu，用户的登录必须由管理员把其添加cvs用户组中； 第五、CVSROOT：此项一般都不需要用户进行修改，用户在输入上边的几个选项时，系统将自动根据用户的输入生成此项的相应内容。 b、全局选项的设置，在上一个界面上选择“Globals”： 此项的配置主要是要注意这几选项： 第一，Checkout read-only不要选上，否则，checkout出来的源代码将不允许用户进行 修改，并且此选项默认是选中的； 第二，Prune (remove) empty directories也不要选上，否则，会自动删除空目录； 第三，对一般配置没有特殊要求的，把Dirty files support、Supply control when adding 与TCP/IP compression选项选中； 4、登录服务器： 选择Admin->login，将出现如下对话框要求用户输入登录口令 输入口令后，选择“OK”按钮，如果CVS服务器与WinCVS的配置都没出错的话，将在CVS的状态栏中提示： cvs -z9 -d :pserver:cvsyxwu@10.104.1.204:/home/cvsroot login Logging in to :pserver:cvsyxwu@10.104.1.204:2401/home/cvsroot ***** CVS exited normally with code 0 ***** code 0表示正确的登录；而如果出错的话，将是code 1，那么要根据错误的提示进行相应的修改。 5、从CVS服务器上check out相应的模块： 第一，在workspace中的Modules选中要存放checkout模块的目录； 第二，选择Create->Checkout Modeles，将出现如下对话框： 其中，Module name and path on the server就是要存放checkout 内容的目录，由用户输入；而Local folder to checkout to就是第一中用户所选择的目录。 6、修改之后把文件提交到CVS服务器 a)、只有一个用户对文件进行修改的情况 用自己喜欢的编辑器对checkout出来的文件进行修改，修改之后的文件在没有提交之前会是红色的，如下图example.h文件： 选中红色的文件example.h后右击选择“Commit Selection”选项，如果没有其它用户也对其进行修改并已经提交到CVS服务器上，一切正常的话将把example.h文件提交到CVS服务器并把图标恢复成原来的颜色。 b)、两个或两个以上的用户对同一文件的不同部分进行修改的情况 这种情况就是如用户A与用户B都checkout了文件example.h，内容如下： int callby (int count) { printf("ExcelStor!/n"); } void main(int argv,char *argc) { //added by my cvs printf("I am Cather/n"); } int mainexample() { printf("OK/n"); } 然后用户A修改成如下，并提交到CVS服务器（一般将正常提交）： int callby (int count) {//add printf("ExcelStor!/n"); } void main(int argv,char *argc) { //added by my cvs printf("I am Cather/n"); } int mainexample() {//add printf("OK/n"); } 接着用户B修改成如下： int callby (int count) {//add printf("ExcelStor!/n"); } void main(int argv,char *argc) { //modified printf("I am Cather/n"); } int mainexample() {//add printf("OK/n"); } 当用户B选择“Commit Selection”时将提示： cvs server: Up-to-date check failed for `example.h' cvs [server aborted]: correct above errors first! 此时表明已经有用户对同一个文件example.h进行修改并提交到CVS服务器，这时 要先选择“Update Selection”对本地example.h与CVS服务器上的example.h文件进行 同步与合并，不用选中出现的任何选项，直接选择“OK”，这时将显示如下： cvs -z9 update example.h (in directory C:/my cvs/STW/src/) RCS file: /home/cvsroot/STW/src/example.h,v retrieving revision 1.5 retrieving revision 1.6 Merging differences between 1.5 and 1.6 into example.h M example.h ***** CVS exited normally with code 0 ***** 表明用户B与用户A的修改已经合并成功，同时文件example.h的图标也将变成红色，合并后的文件是存放在用户B的本地机上，为了更新到CVS服务器还必须选中example.h并右击选择“Commit Selection”才能把用户A与用户B的修改合并后的结果提交到CVS服务器上。注：M表示此文件已经被修改过。 c)、两个或两个以上的用户对同一个文件的相同部分进行修改的情况 这种情况就是如用户A与用户B都下载了文件example.h，内容如下： void main(int argv,char *argc) { printf("I am Cather/n"); } 然后用户A把文件修改成如下，并提交到CVS服务器（一般将正常提交）： void main(int argv,char *argc) { printf("I am Cather/n"); printf("I am Pat/n"); } 接着用户B又把文件修改成如下： void main(int argv,char *argc) { printf("I am Cather/n"); printf("I love you Cather/n"); } 如果用户B这时选择“Commit Selection”准备把修改结果提交到CVS服务器，此 时将显示如下的错误提示： cvs -z9 commit -m "update in 11:20" example.h (in directory C:/my cvs/STW/src/) cvs server: Up-to-date check failed for `example.h' cvs [server aborted]: correct above errors first! ***** CVS exited normally with code 1 ***** 表明用户B的修改与其它用户的修改冲突，这时要先选择“Update Selection”，将显示如下提示： cvs -z9 update example.h (in directory C:/my cvs/STW/src/) RCS file: /home/cvsroot/STW/src/example.h,v retrieving revision 1.9 retrieving revision 1.10 Merging differences between 1.9 and 1.10 into example.h rcsmerge: warning: conflicts during merge cvs server: conflicts found in example.h C example.h ***** CVS exited normally with code 0 ***** example.h前面的C表示与其它用户的修改有冲突，并且文件的图标会加显示一个“C”，如下所示： 双击example.h将显示example.h的内容，如下： void main(int argv,char *argc) { printf("I am Yanxi/n"); printf("I am Cather/n"); <<<<<<< example.h printf("I love you Yanxi,too!/n"); //这部分为你的修改 ======= printf("I love you Cather!/n"); //这部分为其它用户的修改 >>>>>>> 1.10 } 这时你应该与用户A进行协商以决定最终要怎样修改。比如，可以修改成： void main(int argv,char *argc) { printf("I am Yanxi/n"); printf("I am Cather/n"); printf("I love you Yanxi,too!/n"); //这部分为你的修改 printf("I love you Cather!/n"); //这部分为其它用户的修改 } 然后选择“Commit Selection”进行提交，将显示如下的提示信息： cvs -z9 commit -m "update in 11:20" example.h (in directory C:/my cvs/STW/src/) Checking in example.h; /home/cvsroot/STW/src/example.h,v <-- example.h new revision: 1.11; previous revision: 1.10 done ***** CVS exited normally with code 0 ***** 表明用户A与用户的修改已经合并成功。 这样，向CVS服务器提交文件所会遇到的问题也基本上就是这些，用户要根据所遇到的实际问题进行修改。 7、向CVS服务器添加新文件 在本地添加文件后，要提交到服务端。先选中文件，然后点击“添加按钮”，添加文件后，再在右键菜单中选择提交命令“Commit Selection”即可。 如图，选中文件example.h.bak，因为example.h.bak当前不是CVS的文件，此时“添加按钮”将由不可选状态变成可选状态，所以Status中显示为“NonCvs file”，选择“添加按钮”之后example.h.bak图标将变成红色并增加了一个A字母，如下： 然后选中example.h.bak，右击，选择“Commit Selection”把文件example.h.bak提交到CVS服务器上而成为CVS的一个文件。 8、结束语 来到这里，你基本上已经能为自己或公司配置一个实用的CVS服务器与WinCVS客户端，配合使用CVS进行系统开发或其它文档的版本管理与控制。 [size=2]文字[/size]