开发人员手册doc.docx
《开发人员手册doc.docx》由会员分享,可在线阅读,更多相关《开发人员手册doc.docx(13页珍藏版)》请在冰豆网上搜索。
开发人员手册doc
一、安装前检查
1、硬件环境
cpu
P2500MHz以上
内存
≥128M
硬盘
≥10G
2、软件环境
操作系统
windows2000sp3
windowsxpprofessionalsp1
windowsserver2003
其它软件
IE5.5sp2以上
Acrobat5以上
3、从管理员处已经获取信息
a)所在域名称;
b)加入域的账号、口令;
c)dns服务器地址;
d)Releasearea路径。
4、网络设置
以管理员的身份进入你的本机,修改dns设置。
方法:
选择桌面>网上邻居,右键菜单选择属性,在网络和拨号连接窗口,选择本地连接,右键菜单选择属性,在本地连接属性对话框中,双击Internet协议(TCP/IP),修改首选dns服务器,设置为dns服务器地址。
5、用户设置
以管理员的身份进入你的本机,将所获取的域用户加入到本机的管理员组。
方法:
选择我的电脑,右键菜单选择管理,在计算机管理窗口,在系统工具下面打开本地用户和组,选择用户,右键菜单选择新用户,用户名为管理员所提供的域账号,建立用户后,选中该用户,右键菜单选择属性,在账号属性窗口选择隶属于页面,添加administrators组。
6、域设置
以管理员的身份进入你的本机,加入域。
域账号和口令由管理员提供。
方法:
选择我的电脑,右键菜单选择属性,在系统特性窗口,选择网络标识页面,点击更改按钮,选择域,输入口令。
注意:
加入域时,写域的全称,如。
另外上面的方法针对win2000,对于xp用户,略有不同,在系统特性窗口,选择计算机名页面。
7、备份
导出邮件、地址簿、保存网络设置。
重启动机器。
二、安装
1、以域用户登陆到本机。
2、访问clientreleasearea所在机器,进入clientreleasearea的文件夹。
3、运行安装程序,开始安装。
4、安装时选择默认设置,完成后重启机器。
5、运行clearcasedoctor进行安装诊断,按照提示的解决方法去解决问题。
三、安装后设置
以域用户登陆到域:
1.安装邮件程序、导入地址簿,导入邮件。
2.重装非系统自带输入法。
3.快捷方式、桌面的调整。
4.设置代理服务器。
以域用户登陆到本机:
5.在本地建立viewstorage,共享权限要求:
本机\域账号、域\域账号、域\clearcase完全控制,everyone只读。
注,前4条设置是由于登陆域后,个人工作环境发生了变化,以致某些程序不能使用,需要重新设置。
另外,对于本机安装了ccserver做练习,要登陆公司cc服务器进行日常开发工作的开发人员,除前面已有设置,额外的,需要作如下设置,以域账号登陆本机:
6.该用户设为ccadmin成员。
7.打开控制面板>管理工具>服务>AtriaLocationBroker,右键打开属性,在“登陆”页面将账号改为:
域名\clearcase_albd,输入对应域用户口令;
8.编辑注册表(开始>运行>regedit),选择注册表项HKEY_LOCAL_MACHIN\SOFTWARE\atria\clearcase\currentversion\clearcasegroupname,修改其值为“域名\clearcase”。
9.如果想使用本机ccserver,只需:
AtriaLocationBroker登陆账号改为“.\clearcase_albd”,注册表项HKEY_LOCAL_MACHIN\SOFTWARE\atria\clearcase\currentversion\clearcasegroupname,其值为“本机名\clearcase”。
四、基本概念
1、元素,element,是一个版本系列的基本组成,能有机的形成一个版本树,任何能存放于Windows系统的文件都可以作为一个元素存放于ClearCase的版本控制系统中,如:
源文件、二进制文件、目录、中间文件、文档等。
2、VOB是一个存储你的项目所有版本信息的空间。
包括文件和目录,文件可以是任何类型。
在VOB库中不只存有元素,还有记录元素的事件、元素变更的增量、编译时产生的中间文件(二进制文件)等等信息。
取得VOB库中的资料可以通过NT系统、win2000系统或是UNIX系统(VisualSourSafe是不可以的)。
PVOB,存储与项目有关信息的空间,一个PVOB可以包含多个项目。
3、版本和版本树,元素的每一次修改都作为一个版本保存,每个元素都有自己的版本树,版本树看到元素的每个版本的变更情况。
4、视图,view,视图是独立的开发人员的工作空间,根据不同的视图规则从VOBs库中选择版本、目录,也可以看到私有文件和导出对象(即中间文件)。
开发人员对VOB中任意元素的操作都是通过视图完成的。
两种类型的视图:
动态视图、静态视图。
5、动态视图,dynamicview,元素在VOB服务器中。
可以通过Clearcase的文件系统,使您实时的、透明的访问VOB,每个成员的工作信息可实时的反映到版本树中。
6、静态视图,snapshotview,元素被拷贝到客户端,只能定期更新,通常不与服务器实时连接。
可以在本地进行建立(Build)操作,可用于任何WINDOWS操作系统
7、活动,activity,追溯了为完成一个变更请求而对工件所做的修改,clearcase管理工件的修改,clearquest管理并追溯活动。
如修改一个bug、实现一个新功能都是一个活动。
8、构件,component,一系列相关元素的集合,一个项目可以有一个或多个构件,一个构件可以被多个项目共享使用。
9、开发工作空间,Developmentworkspace,由开发流和开发视图组成,是开发人员的独立空间。
开发视图包括了开发人员为完成活动所需的一系列文件/目录的版本。
开发流,可以理解为集成流上的一个分支。
10、集成工作空间,Integrationworkspace,由集成流和集成视图组成。
集成流,项目成员都具有访问权限,共享了开发人员完成了的活动,维护基线。
对应项目集成流,每个开发人员拥有一个集成视图,用来编译和测试开发人员的工作。
11、基线,baseline,一组文件/目录版本的集合。
五、开发人员常用操作
1、Mount&unmountVOB
mountvob
进入clearcaseexplore,选择当前视图的根目录,右键选择”mountvob”,在弹出的对话框中,选择需要mount的vob,点击OK,如果选中ReconnectatLogon,那么每次登陆系统,都会自动mount该vob。
这样在视图中就可以对vob的元素进行操作了。
unmountvob
进入clearcaseexplore,选择当前视图的根目录,右键选择”unmountvob”,在弹出的对话框中,选择需要unmount的vob,点击OK。
unmount后,vob在当前视图将不可见了。
2、Updatesnapshotview
进入clearcaseexplore,右键点击snapshotview的根目录,选择updateview,在startupdate对话框进行设置,更新snapshotview的内容。
3、Removeview
对于不再使用的view,要remove掉,进入clearcaseexplore>toolbox>removeview,在removeview对话框中,选择需要删除的view,点击OK。
4、Addtosourcecontrol
进入clearcaseexplore,在右侧browserpane,选择文件/目录(privatefile),右键选择addtosourcecontrol,输入活动、注释,点击OK。
在clearcaseexplore中,按F5,刷新,刚才加入的文件在视图中以版本文件/目录方式呈现。
5、Checkin&out
Checkout
进入clearcaseexplore,在右侧browserpane,选择要检出的文件/目录,右键选择checkout,在随后的checkout对话框中,输入活动、注释,选中unreserved,点击OK。
文件/目录检出后,在其前面有一个绿色的标志。
检出包括reserved和unreserved两种,开发人员以reserved方式checkout后,别的开发人员对该文件只能做unreserved检出,而且第一个检出者具有绝对的优先检入的权利,即该检出者不做检入操作,任何人都不能检入。
在做unreserved检出后修改了文件,检入时,如果已经有人做了检入操作,这时需要与已有版本文件做merge。
Checkin
检出的文件,修改完毕保存后,需要检入。
进入clearcaseexplore,在右侧browserpane,选择要检入的文件/目录,右键选择checkin,在随后的checkin对话框中,确认在检出时输入的活动、注释,点击OK。
文件/目录检入后,检出标志消失,该文件/目录的版本增加。
6、Findcheckouts
进入clearcaseexplore,右键选择一个文件,选择findcheckouts,在findcriteria中选中相应规则,点击OK。
7、Cancelcheckout
选中检出的文件,右键选择undocheckout,如果想保留一个备份,在confirmundocheckout对话框中,选中savecopyofthefilewitha.keepextension。
选择yes,取消检出。
8、查看History
进入clearcaseexplore,右键选择一个文件,点击history。
9、查看活动的变更集
进入clearcaseexplore>myactivities,选择一个活动,右键选择属性。
10、Merge
在开发人员deliver或是rebase时,如果源文件和目标文件间有差异时,引发merge操作。
Merge操作涉及四个算子,from、to、base、result。
算法:
六、开发流程
进行开发之前,首先从项目经理处获取以下信息:
Ø所在项目名称
Ø活动名称
Ø集成流名称
1、加入项目,建立你的工作空间
进入clearcaseexplore,点击toolbox>UCM>JoinProject
1)选择项目,下一步;
2)输入开发流名称,选择集成流,下一步;
3)开发视图和集成视图都选择snapshot,下一步;
4)指定开发视图的root位置,点击advancedoptions,指定viewstorage位置,下一步;
5)指定集成视图的root位置,点击advancedoptions,指定viewstorage位置,下一步;
6)选择需要下载到snapshot视图中的component,完成。
2、findandsetactivity
进入clearcaseexplore,在开发视图的根目录下面,打开myactivities文件夹,可以看到已经分配给你的活动,选中活动前面的checkbox。
这样,视图中的工作就与activity联系在一起了。
在做addtosourcecontrol,以及检入、检出操作时,均需要选中活动。
在删除视图前,清除myactivities文件夹中每个活动前的checkbox。
3、workonactivities
检出文件,执行checkout操作,在checkout对话框中选择活动,并输入检出操作的注释信息。
在检出的文件上执行任务,本过程可能涉及,查看历史信息,版本之间的比较,这些操作可以通过选中元素,右键菜单中clearcase上下文中获取。
取消检出,或者是检入文件。
检入时,确认检出时所选择的活动,以及注释信息。
检入操作之后,在你的集成视图中做编译和测试工作。
启动clearquest,选择Workspace>PublicQueries>UCMUserQueries,运行MyToDoListquery,在querybuilder中,选择一条记录,在recordform中,点击actions>modify,修改信息,完毕后点击apply。
如果分配给你的活动的相关工作都完成了,需要关闭活动。
4、Deliveractivities
Deliver前准备:
a)如果项目经理新建了一条推荐基线,开发人员需要先rebase。
b)需要deliver的文件/目录已经检入。
c)Update个人的集成视图。
d)在个人的集成视图中测试自己的工作。
Deliver过程
a)进入clearcaseexplore,右键点击开发视图的根目录,选择deliverfromstreamtodefault,点击OK。
b)如果要提交的文件与目标流中的文件有冲突,将引发mergemanager进行merge操作。
c)点击complete,点击close。
4、Rebase
Rebase前准备
在开发视图中选择findcheckouts,将所有检出文件做checkin操作或undocheckout。
在FindCriteria对话框,选择规则:
Includesubfolders、Searchonlyforyourcheckouts、Searchonlyforcheckoutsinthecurrentview。
Rebase过程
进入clearcaseexplore,右键点击开发视图的根目录,选择rebasestream,在rebasestreampreview对话框中,确认mergeworkintothefollowingview显示的是你的开发视图,点击OK。
如果rebase的文件与开发视图中的文件有冲突将引发mergemanager进行merge操作。
在你的开发视图中测试。
取消rebase
cleartoolrebase-cancel
七、常见场景的解决方案
1、场景:
开发人员的一天日常工作流程
方案:
1)以域账号登陆到域。
2)打开clearquest,选择“/PublicQueries/开发人员工作区”,双击mytodolist,右侧窗体中resultset页面即显示了项目经理分配给该开发人员的活动,在resultset中选中要从事的一项活动,该活动的信息便详细显示在右下方窗体中,选择action下的打开,apply,活动的状态变为已打开,表示开发人员已经开始处理。
3)打开rationalclearcaseexplore,将活动中需要的工件(文件、目录),load到本地。
方法:
选中开发视图,右键选择Propertiesofview,在属性窗体中,选择loadrules属性页,点击editloadrules,在chooseelementstoload窗口中,选中showallvobs,从左侧选择需要的工件,点击add按钮,选择好后,点击ok,点击确定后,在startupdate窗口中点击确定。
4)检出所需文件,选中所需文件,右健菜单中选择checkout,在checkout对话框中,在activity列表框中选择相应的活动,如果列表框中没有对应的活动,则点击browse,打开activityentitybrowse界面,在开发人员工作区中,双击mytodolist,从下面的活动列表中选择活动,点击ok即可。
在checkout对话框中,在checkout对应的编辑框中,可输入该次检出操作的说明信息。
输入完信息后,点击OK,则所需文件被检出。
5)修改文件,保存。
6)开发人员每天的工作都要检入clearcase,选中所需文件,右健菜单中选择checkin,在checkin对话框中,确认在检出时选择的活动,以及输入的说明信息,如果信息有误,可以修改,否则,点击OK即可。
2、场景:
一个活动的处理流程
方案:
1)以域账号登陆到域。
2)打开clearquest,选择“/PublicQueries/开发人员工作区”,双击mytodolist,右侧窗体中resultset页面即显示了项目经理分配给该开发人员的活动,在resultset中选中要从事的一项活动,该活动的信息便详细显示在右下方窗体中,选择action下的打开,apply,活动的状态变为已打开,表示开发人员已经开始处理。
3)为完成一项活动,开发人员需要做检出、修改、检入操作,可能重复很多次。
4)rebase前期准备。
一项活动所涉及的工作全部完成,开发人员需要检查自己的开发视图,对已检出的文件执行检入操作。
在windowsexplore中,选中开发视图的viewroot目录,右键菜单中选择findcheckouts,在findcriteria对话框中选中:
includesubfolders
Searchonlyforyourcheckouts
Searchonlyforcheckoutsinthecurrentview
点击OK后,findcheckouts窗体中就会列出检出的文件或目录,对列表中的文件或目录执行checkin或undocheckout操作。
5)执行rebase操作。
选中开发视图,右键菜单中选择rebasestream,随即打开了rebasestreampreview窗口,在rebasethe“”streamtothefollowingbaseline的列表中选择要rebase的baseline,在mergeworkintothefollowingview中确认该view为rebase操作所在的view。
点击OK,开始rebase。
6)测试。
Rebase后,开发人员需要在自己的工作区内执行测试工作。
7)deliver前期准备。
检查开发视图,对已检出的文件,执行检入或undocheckout操作,方法同4)所述。
对集成视图执行update操作,选中集成视图,右键菜单中选择updateview,在startupdate对话框中,点击OK即可。
8)执行deliver。
在clearcaseexplore中,选中开发视图,右键菜单中选择deliverfromstreamtodefault,将活动提交到集成流中。
在deliverfromstreampreview对话框中,列出了开发流中未提交的活动,开发人员可以选择本次提交哪些活动,点击OK,即开始deliver。
9)修改clearquest信息。
打开clearquest的mytodolist,选中已完成的活动,选择action下的处理,输入完成任务的相关信息:
任务时间完成时间和实际工作量,点击apply,确认,活动的状态变为已处理。
3、场景:
长沙的开发人员带着自己的机器出差到济南,加入济南的域控制器。
方案:
济南的管理员:
在域控制器上为该开发人员添加用户组,添加账号,账号名称与开发人员在长沙的一致;
开发人员:
修改dns服务器地址为本地域控制器IP
修改其它网络配置(IP,DNS,代理服务器)
加入本地域
打开“控制面板>clearcase”,在registry页面修改registryserver为济南的registryserver,windowsregion选择济南的windowsregion,licensing页面修改licenseserver为济南的licenseserver,在servicesstartup中startclearcase。
测试clearcase是否正常工作。
长沙的管理员
将该开发人员所在的开发流的mastership传给济南这边的replica。
济南的管理员
接收replica的同步。
开发人员
在replica开发流上工作。
4、场景:
开发人员转换项目。
方案:
开发人员检入其原项目工作,在开发视图中做rebase操作,测试,然后将测试完成的活动deliver到集成流。
由原项目组配置管理员将该开发人员从该项目的相关用户组中删除。
在新项目组中,由配置管理员为分配相应权限。
如果两个项目组间跨region,该开发人员打开“控制面板>clearcase”,在registry页面修改windowsregion选择新项目所在的windowsregion。
开发人员加入新项目。
5、场景:
项目开发过程中,开发人员A离职,由开发人员B接管其工作。
方案:
在开发人员A的机器上检入其工作,在开发视图中做rebase操作,测试,然后将测试完成的活动deliver到集成流。
开发人员B在集成流上建立包含A工作的开发流,及相应的开发视图,开始工作。
由项目组配置管理员将该开发人员A从该项目的相关用户组中删除。