CVS服务器与WinCVS的配置与使用

第一部分 CVS服务器的配置(以1.10版)
作者：吴炎溪 Email:[e-mail]
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模块了，然后，我们可以把这个测试项目的文件删除，试验如何从仓库获取文件这会在后面的客户端文章进行说明。
(注：本小节主要引用自何伟平的“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可以从地 址下载到，也可以在 上下载到最新的或其它版本的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! ");
}
void main(int argv,char *argc)
{
//added by my cvs
printf("I am Cather ");
}
int mainexample()
{
printf("OK ");
}
然后用户A修改成如下，并提交到CVS服务器（一般将正常提交）：
int callby (int count)
{//add
printf("ExcelStor! ");
}
void main(int argv,char *argc)
{
//added by my cvs
printf("I am Cather ");
}
int mainexample()
{//add
printf("OK ");
}
接着用户B修改成如下：
int callby (int count)
{//add
printf("ExcelStor! ");
}
void main(int argv,char *argc)
{
//modified
printf("I am Cather ");
}
int mainexample()
{//add
printf("OK ");
}
当用户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 cvsSTWsrc)
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 ");
}
然后用户A把文件修改成如下，并提交到CVS服务器（一般将正常提交）：
void main(int argv,char *argc)
{
printf("I am Cather ");
printf("I am Pat ");
}
接着用户B又把文件修改成如下：
void main(int argv,char *argc)
{
printf("I am Cather ");
printf("I love you Cather ");
}
如果用户B这时选择“Commit Selection”准备把修改结果提交到CVS服务器，此
时将显示如下的错误提示：
cvs -z9 commit -m "update in 11:20" example.h (in directory C:my cvsSTWsrc)
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 cvsSTWsrc)
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 ");
printf("I am Cather ");
<<<<<<< example.h
printf("I love you Yanxi,too! "); //这部分为你的修改
=======
printf("I love you Cather! "); //这部分为其它用户的修改
>>>>>>> 1.10
}
这时你应该与用户A进行协商以决定最终要怎样修改。比如，可以修改成：
void main(int argv,char *argc)
{
printf("I am Yanxi ");
printf("I am Cather ");
printf("I love you Yanxi,too! "); //这部分为你的修改
printf("I love you Cather! "); //这部分为其它用户的修改
}
然后选择“Commit Selection”进行提交，将显示如下的提示信息：
cvs -z9 commit -m "update in 11:20" example.h (in directory C:my cvsSTWsrc)
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进行系统开发或其它文档的版本管理与控制。