ClearCase指南基础篇翟朋伟.docx
《ClearCase指南基础篇翟朋伟.docx》由会员分享，可在线阅读，更多相关《ClearCase指南基础篇翟朋伟.docx（22页珍藏版）》请在冰豆网上搜索。
ClearCase指南基础篇翟朋伟
ClearCase指南-基础篇（连载一）
第1章前言
. 本文档凡斜体字即代表高级内容、高级概念、或可选内容，仅作粗略了解用，暂不必深入理会。
. 如下如无特别说明，缩写“CC”即代表RationalClearCase；缩写“VS”即代表MicrosoftVisualStudio2003/2005/Whidbey；缩写“VSS”即代表MicrosoftVisualSourceSafe。
. 对于代码开发人员，绝大部分配置管理工作是通过集成了ClearCase的VS.NET来进行的，除却部分操作，大部分操作在VS集成环境下进行应该更便当些。
但本文档是CC的基础，也包含部分VS集成环境无法进行的操作，所以，开发人员必须仔细阅读本文档–单纯依靠集成了ClearCase的VS.NET是无法解决所有问题的。
第2章ClearCase安装
2.1准备工作
.客户机器必须加入Windwos域，客户必须用Windows域账户登录到自己的机器（即登录到域中），你的ClearCase客户端才可以正常访问ClearCase服务器、你的ClearCase客户端才可以正常工作。
ClearCase使用Windows账户作为自己权限管理的基础，切！
.网络部分、WINS设置：
网络连接、属性、TCP/IP、属性、高级、WINS、添加（A）…，加入2个WINS地址：
192.168.8.4、192.168.8.6。
否则安装可能失败，提示如下：
.如果客户端是Windows2000AdvancedServer，可能因为权限问题而无法创建视图，这是我们公司域服务器帐号同步故障所致。
请先退出PDOMAIN域，然后再加入PDOMAIN域，问题应该可以解决。
注：
其他类型操作系统也可能出类似故障（有时报告“…与域服务器的信任关系失败…”），解决办法同此。
.工作方便起见，你的Windows域账户应该同时是你本机的管理员（Administrators组）。
一切Ok，开始安装工作。
2.2安装工作
. 注意：
ClearCase必须在VisualStudio.NET（含Whidbey）、RationalRose之后安装，否则ClearCase与以上2者的集成将失败。
. 注意：
以后如果需要重装VisualStudio（如Whidbey版本升级）或Rose，ClearCase也必须卸掉重装、同样是后装ClearCase！
. 注意：
VS.NET+ClearCase安装、配置好后，如果因为目种原因又安装了SourceSafe，则VS.NET+ClearCase的集成关系失败、自动变为VS.NET+SourceSafe的集成关系。
如欲返回使用VS.NET+ClearCase集成，则必须卸载重装ClearCase。
. 注意：
关于原SourceSafe客户端：
1、对于VisualStudio（平台技术部、应用开发部），客户端原SourceSafe可以保留、不必卸载、以备浏览原SourceSafe库；
2、对于Rose（应用设计部），客户端原SourceSafe可以暂时保留，以备浏览原SourceSafe库；当SourceSafe到ClearCase的迁移工作彻底完成后，最好卸载客户端SourceSafe，否则Rose与ClearCase的绑定可能（而非绝对）会受到干扰，每次启动Rose都需要重置RoseAdd-InManager，以重新绑定到ClearCase!
----目前来看，部分人机器环境可能有本绑定毛病。
.ClearCaseClient安装启动路径：
\\uf-net\ClearCaseNetSetup，启动Setup.exe......可能遇到的、需要干涉的步骤及解决如下：
1、LicenseAgreement…步骤：
当然选择Iaccept…、我同意……
2、最后一步，提示是否阅读有关及是否要进入Rational有关网址，不必要，勾掉2个CheckBox。
3、除却安装路径（默认：
c:
\programfiles\rational\clearcase）可以修改外，其他配置一律不得修改、须保持默认值！
.安装完ClearCase后必须重新登录（即Windows注销操作）----最好重启机器、以刷新你的权限到ClearCaseServer，否则不能操作ClearCase客户端！
第3章各部目录结构
特别提醒：
在ClearCaseExplore中，你可以看到自己熟悉的目录、文件等概念。
但其实，其中有些结点、目录是特殊的ClearCase后台对象（视图名、VOB、Component），你不要试图在CCExplore或WindowsExplore中对这些特殊的CCObject进行删除、移动、重命名等变更操作，否则肯定只会自讨苦吃！
这些概念你不必太了解，记着别变更之即可。
这些概念在CCExplore中View的节点等级关系为：
视图名\VOB\Component\普通目录、文件。
即Root节点代且仅代视图名，1级节点代且仅代VOB，2级节点代且仅代Component，其他为普通目录、文件。
客户端只能对Component之下的常规目录、文件作入库、CheckOut、CheckIn、重命名、删除等操作。
这些概念在CCExplore中的体现参下节：
“平台技术部目录结构”。
3.1平台技术部
3.2应用开发部
3.3应用设计部
ClearCase指南-基础篇（连载二）
第4章ClearCase基础
鉴于大家多少已经使用过一段时间ClearCase或是其他的版本控制工具（如VisualSourceSafe、CVS等），关于软件配置管理SCM的基础概念如WorkingSpace（工作空间，SourceSafe叫WorkingFolder、CC叫View–视图）、AddtoSourceControl、CheckOut、CheckIn、GetLatestVersion（SourceSafe）/UpdateView（ClearCase）、…等，此处只作简单介绍或即Pass，不作深入讲解。
4.1ClearCase模式
ClearCase一共有2种模式：
Base模式、UCM模式。
不必深究、不必理解、不必区分此2种模式。
我们使用的是UCM模式。
4.2受控元素
ClearCase管理2种对象：
目录，进入CC后称DirectoryVersion；文件，进入CC后称FileElement。
2者在CC中统称为Element（元素）。
注意：
对于个人的私有文件、目录，CCExplore中标示为“Private”类型，CC对私有文件/目录不做任何包装、限制及特殊处理。
在ClearCaseExplore（CC客户端工具）中也可以对之作常规操作如重命名、删除、移动等，如同WindowsExplore中一样、没有任何例外！
4.3静态视图
StaticView：
静态视图，就如SourceSafe，本地有一套CC服务器上文件/目录的副本，可离线工作。
静态视图下，他人为看到你的CheckIn成果，必须在自己的客户端执行一下UpdateView命令。
创建视图时（参后续有关章节），记着让视图名字前缀上你的大名，以便于管理！
4.4动态视图
DynamicView：
动态视图，相对SourceSafe等版本控制工具，动态视图概念为CC所独有。
动态视图下，本机通过网络驱动器来直接访问CC服务器上的文件/目录，本机没有CC服务器上文件/目录的副本，一旦脱离CC服务器环境即无法工作，即不能离线。
一旦你CheckIn，他人如果工作在动态视图下，可立即看到你的最新成果，他人无需执行UpdateView命令、Refresh（F5）一下即可。
同理，如果你使用的是动态视图，无须UpdateView、Refresh一下你即可看到他人的最新提交成果。
注意：
对于动态视图，CC会在客户端创建一虚拟驱动器（M、X、Y、…），WindowsExplore下访问该虚拟驱动器，将会看到该视图的完整目录、文件结构，与CCExplore（后续章节介绍）中看到的一样。
甚至，……
创建视图时（参后续有关章节），记着让视图名字前缀上你的大名，以便于管理！
4.5活动：
Activity
ClearCase中有一个重要的概念：
Activity----活动。
签出（CheckOut）一个文件或目录、把一个文件或是目录AddtoSourceControl（加入版本控制库）前，必须首先建立一个活动（可以使用一个固有的活动，也可以New一个新的活动），用于记录你的后续操作之用（未来，通过活动可以反查你对哪些文件/目录作过哪些修改）。
在该活动基础上所做的一切修改称之为该活动的“变更集”。
1、活动命名规范：
a、“人名”用Windows域帐号；“日期”为YYMMDD格式。
b、代码类：
人名__模块_活动简述_日期，如：
zpw_Workflow_条件转移接口定义_040205
c、PubRef共享引用、资源文件提交：
PubRef_人名__模块_日期_......，如：
PubRef_Lyguo_Workflow_040324_WfEngine表李玉国提交工作流的Engine组件。
d、文档类：
Doc_人名__模块_日期_......，如：
Doc_fjz_Service_050124_设计文档
e、……
2、定义活动时，不仅应该命名规范、有意义，还应当给予适当注释。
第5章CC客户端：
ClearCaseExplore
本章包括如下内容：
创建视图、配置项入库、签出、签入、更新视图、活动创建。
通过本章学习，普通客户端将可以借助ClearCase实现常规的配置管理工作。
当然，借助CC与VS、Rose的集成功能可能更方便些，但严格来说，CC与VS、Rose的邦定集成不属配置管理范畴！
常规人员和CC打交道的工具只有一个：
ClearCaseExplore----CC的客户端GUI工具。
如下为CC客户端、ClearCaseExplore主界面：
通过CCExplore，不仅可以实现配置管理的常规操作（创建视图、配置项入库、签出、签入、更新视图、…），还可以直接进行普通文件/目录的常规操作：
创建、删除、移动、重命名等。
5.1创建视图
客户端必须首先建立视图才能展开日常配置管理工作。
客户端通过ClearCaseExplore.Toolbox\BaseClearCase\CreateView实用工具，把服务器端一个配置好的ClearCaseProject所包含的有关文件、目录元素下载到本地，建立起自己的视图。
5.1.1步骤零：
创建个人ViewStorage
CC中，每个View都必须关联一个ViewStorage，服务器需要通过ViewStorage与客户端通信。
ViewStorage很简单，就是一个普通的Windows共享目录。
每个人都需要在自己的机器上创建自己的ViewStorage共享目录（共享权限应仅对自己开放），创建视图时，输入该共享路径即可！
方便起见，所有人的ViewStorage的共享目录名字统一为：
“ViewStorage”：
5.1.2步骤一：
启动CreateView
启动CreateView实用工具（ClearCaseExplore、“Toolbax”Tab页、“BaseClearCase”Panel、“CreateView”Button）：
5.1.3步骤二：
选择Project
选中目标Project（本步骤及后续步骤截图为讲解用，实际工作中，需要加入或基于合适的CCProject如：
平台技术：
U9.UBF.***、应用设计：
U9.Design.***、应用开发：
U9.App.***）
，下一步继续：
ClearCase指南-基础篇（连载三）
5.1.4步骤三：
开发流、整合流
关于开发流（DevelopmentStream）、整合流（IntegrationStream）：
开发流、整合流为服务器端概念，可简单理解为服务器上的2个独立存储空间，特定阶段、特定版本集的文件、目录即存放在流中。
开发流概念用于分支、隔离开发用，目前不使用，所以要勾掉“Createadevelopmentstream”
5.1.5步骤四：
视图类型
决定视图类型：
选择生成静态整合视图（我们暂不使用开发流，也就无开发视图类型选择问题，所以下截图上半部开发视图部分为空），下一步继续：
5.1.6步骤五：
View本地存放路径及ViewStorage设置
本步骤非常关键，请大家务必重视：
默认视图名字前系统会自动前缀上你的名字，便于监控、管理，不要删除，切切！
客户端每建一个视图，服务器端即会作相应登记（Register）。
如果你是第一次基于某个Stream（我们的例子是U9.UBF.Mailline流）创建一个View，则此次视图名字应该是形如“zpw_U9.UBF.Mainline_int”、名字中无“_2、_3、_4、…”等字样。
如果你以前基于某个Stream已经创建过一个View，则此次视图名字中会包含创建次数信息、名字中将包含“_2、_3、_4、…”等字样（如本例截图）。
对同一个流（CC后台存储区）创建多个视图虽然不违法，但可能给你带来意想不到的麻烦–除非你出于一定的目的有意识这样做：
你的本机可能有多个副本，而你可能无意识地选择工作于任何一个View，多处修改代码还不自知，等到知道，可能已经很难处理了！
注：
第一个截图中，点击“AdvancedOptions…”按钮后，第二个截图中点击“Browse…”按钮，找到你的ViewStorage共享目录（也可以在上ViewStorage文本框直接输入共享目录路径如：
\\zpw\ViewStorage），当找到一个合法的共享目录后，ViewStorageTextBox中内容自动改变为View名字（如上图的zpw_U9.UBF.Mainline_2_int），不要修改之，级次Ok后返回确定即可……
5.1.7步骤六：
ChooseComponent
Component系CC后台概念，简单理解为目录树即可。
选择你需要访问的Component（一般是全部选择），然后继续：
5.1.8步骤七：
盘点结果
一切Ok……，转ClearCaseExplore，会发现View\下增加了一个与你所Join的Project同名的选项卡（我们的例子中叫“U9.UBF.Mainline”）。
其中建有我们刚刚建立的整合视图（zpw_U9.UBF.Mainline_int）：
视图创建完毕，你就（才）可以基于视图展开常规的配置管理工作：
进配置库、签出、签入、更新视图等工作。
5.2配置项入库：
AddtoSourceControl
视图创建完毕，该是配置项入库的时候了。
所谓配置项入库，即把本机私有文件、目录加入ClearCase使之变为ClearCase受控元素。
步骤如下：
注：
命令行有批量入库命令，很简单，略。
WindowsExplore中Copy需要入库的配置项。
ClearCaseExplore中Paste到目的地（Component根下或Component的某子孙目录下，普通目录可以在CCExplore中直接创建）
选中需要入库的文件或目录（可多选），执行右键菜单“AddtoSourceControl”…如下图，一次把2个文件加入ClearCase使受控：
弹出窗体中需要选择一既有活动或可创建一新的活动，以关联本次动作。
最后确定即可。
如下图：
注意：
A.把一个目录下任何一个Private文件加入ClearCase后，该目录均将同时自动加入ClearCase变为受控元素–目录私有的话。
B.把一个目录AddtoSourceControl…后，其中子目录及文件均不会受影响–如为Private则仍将保持Private状态。
C.子影响父，父不影响子：
一个文件如加入ClearCase，其所在父目录必被自动加入ClearCase（至于爷爷目录，CC不考虑处理）；反之则No。
D.对于代码类或Rose模型，在VisualStudio、Rose中借助与ClearCase的集成功能可实现批量入库（及自动过滤），应该更简单些。
后续章节专题介绍。
ClearCase指南-基础篇（连载四）
5.3签出：
CheckOut
CheckOut出ClearCase受控元素，然后修改之，最后CheckIn提交之，其他人员通过UpdateView命令即可获得该元素的最新结果（仅静态视图需要，动态视图不必UpdateView）！
VS、Rose中，有相应ClearCase集成，功能一样，专题介绍。
CheckOut一个文件，如下图，既可以继续使用一个既存的活动，也可以使用New按钮定义一个新的活动（很简单的一个窗体，略）：
ReservedCheckBox：
独占式、非多签出，只要你不签入提交，其他人就不能再签出修改该文件、目录。
特别提醒：
除非实在有必要，绝对不要CheckOut出来一个（普通）目录，除非你能记着及时CheckIn之，否则可能导致很多文件、目录的状态异常，很难处理。
5.4签入：
CheckIn
提交个人成果到服务器。
批量提交：
寻找整个视图所有被修改（正常修改及Hijacked文件）的文件，以实现批量签入提交。
涉及FindModifiedFiles、FindCheckouts右键快捷命令。
选择提交：
如果只是想提交个别文件、目录，可选中目标，然后右键执行CheckIn……本手册不做详细讲解。
VS、Rose中，有相应ClearCase集成，功能一样，专题介绍。
5.4.1Hijacked文件
本节非常重要，所有人必须重视：
文件即未经CheckOut即被强制修改，ClearCase即置其为Hijacked状态。
Hijacked文件将影响到UpdateView等操作，具体参随后章节。
文件变成Hijacked状态有2大类原因：
不正常、非故意、不小心所致：
忘记CheckOut，WindowsExplore中直接打开强制修改（通过相应工具如Word改文件内容或是使用Copy/Paste命令覆盖原文件）。
正常、故意所致：
如网络断、回家、出差在外，无法访问CCServer，而修改工作需要继续，又希望未来提交强制修改结果。
对Hijacked文件可以有2种处理办法：
认可强制修改，先转CheckOut接着再CheckIn；放弃该强制修改：
UndoHijackedFile。
5.4.2FindModifiedFiles
5.4.2.1FindModifiedFiles步骤一：
查找
对整个视图寻找所有被修改（正常修改及Hijacked文件）的文件（注：
必须选中视图名，否则右键菜单中无“FindModifiedFiles”命令！
）：
5.4.2.2FindModifiedFiles步骤二
查找结果如下（我们的结果中有Hijacked文件（红线提示部分））：
5.4.2.3FindModifiedFiles步骤三
Close上图后进入如下界面，提示有Hijacked文件，要否先直接CheckOut出来。
因为不好判断该非法修改（没有CheckOut的修改）是否有意义、值得接受，先选择No（小心，默认是Yes！
！
！
），此时进入FindModifiedFiles汇总界面（下图后面界面）。
左侧CheckdOut文件夹指示被CheckOut出来并被修改过的文件集合（存在于右侧），Hijacked文件夹指示未经CheckOut而被非法修改的文件集合（点该文件夹后，所有Hijacked文件将刷新于右侧）：
因为下节还有FindCheckouts操作，二者的Find结果的处理方法一样，所以对Find结果的具体处理参下下节。
5.4.3FindCheckouts
（FindModifiedFiles命令）Find不到的CheckOut文件处理。
有时候还有一些被CheckOut（可能没有修改的）文件通过上述FindModifiedFiles方式竟然找不到（以前ClearCase的Bug?
?
?
!
!
!
）！
为此，必须用其他方式继续查找遗漏的（？
）CheckOut文件。
查找方法是选中视图的第一级目录（而非视图本身！
），然后执行右键FindCheckouts命令–〉Ok–〉进入一个FindCheckouts窗口，类同于上FindModifiedFiels命令结果窗口，处理手法完全相同，略：
5.4.4Find结果处理—有修改CheckOut文件
普通CheckOut文件有2种处理方式，CheckIn（修改认同、提交）或UndoCheckOut（放弃该修改版本），2个命令均可处理单个文件或批量处理：
5.4.5Find结果处理—未修改CheckOut文件
还有一种CheckOut文件比较特殊，就是CheckOut出来了，但是没有修改，如此有2种处理办法：
强制性CheckIn（增加一个和前版本完全相同的版本，浪费）或是UndoCheckOut。
为此需要先知道它有没有被修改，然后才能作决定，问题是没有直观办法知道它到底有没有被修改！
所以，正确做法是如上面的界面一样先CheckIn所有CheckOut文件，对于没有修改的文件ClearCase将在CheckIn的过程中提示你该文件内容同于上一个版本，不能CheckIn（下图），则确定之，继续。
当所有CheckIn完毕后，上图FindModifiedFiles的结果窗体将刷新，剩下的仍为CheckOut状态的文件即为无实质修改的文件，全部选中，UndoCheckOut即可！
如果你足够懒，不想如此麻烦，不管三七二十一所有CheckOut文件均想CheckIn进去，也可以，方法是CheckIn时（会弹出一个选项设置窗体）选中一个选项，参下图：
5.4.6Find结果处理—Hijacked文件
对Hijacked文件可以有2种处理办法：
认可强制修改，先转CheckOut接着再CheckIn。
放弃该强制修改：
UndoHijackedFile。
5.5更新视图：
UpdateView
仅限静态视图。
对于动态视图，系统会自动定时更新到本地（特殊文件保存），Refresh一下即可。
更新整个视图：
点击CC
升级会员 