WinCVS与CVSNT简明使用手则

WinCVS与CVSNT简明使用手则
            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:\CVSClient\Admin (管理员工作目录)
            E:\CVSTemp (WinCVS临时目录)
            2.
            第一次启动WinCVS时会自动弹出Preferences配置页面，也可以通过Admin=>Preference菜单进入；第一次使用时需要配置如下的3个页面：

            General页面设置：
            注：按照图示方式输入即可，需要注意的是Path部分的格式是Unix路径格式，它指的是CVSNT端设置的工作根目录。
            CVS页面设置：
            注：Home路径是设置密码等文件的存放位置，必须指定，否则在登陆时，WinCVS也要弹出设置框。这个Home路径需要Python.exe这个外挂程序才有效。这里选择已经准备好的路径：E\CVSTemp

            WinCVS页面设置：
            注：此页面设置WinCVS的外挂编辑程序，通常使用UltraEdit比较方便。
            3. 设置管理员的工作路径：可以点按图标 ，或View=>Browse
            Location=>Change…菜单进行设置，选择已经准备好的路径：E:\CVSClient\Admin，确认，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:\KHRoot\DirA
            ◇ 了解了模块文件结构，现在来实际操作一把：双击【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:\CVSClient\Admin分别建立三个目录分别名为：Jackey，Goury，Riolee，作为临时交换目录。

            ◇ 在新创建的每个目录中用UltraEdit或拷贝一个Readme.txt作为引子文件！！：）
            ◇ 然后，回到WinCVS，在【Workspace】栏的【Admin】目录下形成如下的目录结构：
            ◇ 分别选中Goury，Jackey，Riolee，右键，点按【Import
            Module】，选择【Continue】，其它全部使用默认值，【确定】，OK，完成上传工作。
            ◇ 仔细观察【Output】窗口，确认都成功上传了。
            ◇
            转移到系统的Explore程序中，删除E:\CVSClient\Admin目录下的Jackey，Goury，Riolee三个目录。然后回到WinCVS当中。(一定要删除！！！：)

            ◇ 至此，就完成了工作目录的上传工作。
            7. 【Checkout】下载3个用户的工作目录到【Admin】目录下：
            ◇ 在【Workspace】栏选择【Admin】目录，右键，点按【Checkout Module…】,如下图：
            ◇ 选择【…】，得到CVSNT上最新的模块配置情况，弹出如下的信息框：
            ◇
            这个结构图就是刚才在modules当中编写的模块文件格式信息。选择【Jackey工作目录】，下载到YCW2000机器的E:\CVSClient\Admin目录下。

            ◇ 按照以上操作，依次分别下载【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. 最后，祝愿看到此文的人，得到的帮助、提高等好处大于或等于浪费的时间、反而退步等坏处！！