WinCVS与CVSNT简明使用手册.doc

wincvs与cvsnt简明使用手则 1、前言：cvs是版本控制的利器，目前在linux和windows下都有不同版本；但是国内大多数应用介绍都是基于linux等开放源代码的开放性软件组织，而且讲解的也不系统，让人摸不着头脑；windows下的cvs使用介绍更是了了无几。 本文是针对windows的lan环境下使用cvs的经验介绍，一步一步的向您介绍如何配置和使用cvs的服务器端和客户端。同时，本文只使用到了cvs当中最基本的东西，还有很多更为高级的东西，本文暂不涉及。下面是本文的另一个连接映射，欢迎大家讨论使用，共同进步。 文章连接/book/list.asp?id=66 论坛连接/bbs/dispbbs.asp?boardid=1&;rootid=670&id=670 2、安装版本：2.1、服务器端(cvsnt) 1. 本文使用的是cvsnt-2.0.4，这是一个比较稳定的版本，不要使用最新的cvsnt-2.1.1，本人在使用中发现有比较严重的bug。 2. 下载连接 目前，它提供2.0.6和2.1.1版本的下载。 3. 上面连接还提供源代码，有兴趣的朋友还可以下载下来仔细研究：）。 4. 有心的朋友，仔细观察就会发现 并没有提供任何客户端的下载，那是因为cvs.exe既可以用于服务器端又可以用于客户端，wincvs是为了客户端使用的方便而定制的外壳。（关于这一点，本人未得到任何证实，只是本人在使用过程中的一种体会，欢迎大家讨论。） 2.2、客户端(wincvs) 1. 本文使用的是wincvs-1.3b13，这应该是一个最新版本：），本人在使用过程中并没有发现有任何严重的bug。 2. 下载连接/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. 机器地址： (内部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 dont 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. 机器地址： (内部ip) 4. 网络环境：100兆交换局域网，可以直接访问到server 5. 硬盘分区格式：fat32与ntfs都可以。 4.2 安装wincvs： 1. 下载wincvs 1.3b13，全部按照默认安装就可以了。 2. 启动wincvs，开始使用。特别注意：以下的所有操作都是在ycw2000()这台机器上远程完成的，此时的server()主机已经进入了锁定状态。 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登陆上去，通过以上的方法找到丢失的文件。除非用户进入到远端服务器，将文