clearcase安装使用快速入门

ClearCase

安装使用快速入门

1 概述

1.1 目的

本手册列出了一般正常情况下，Rational ClearCase的安装使用方法。本手册以简便明了为原则，方便实用为指导思想，只覆盖了正常情况下，Rational ClearCase常用的操作。

1.2 范围

本手册面向Rational ClearCase的入门使用者，包括新手上路的配置管理员、应用集成人员及开发人员。

1.3 术语定义

VOB：A VOB(versioned object database) is a data repository that holds the files, directories, and any objects that collectively represent a product or a development effort.

VIEW

Stream

Integration

Replica，an instance of a VOB, located at a particular site. Includes the VOB database and data containers

1.4 参考文档

2 ClearCase安装手册

2.1 安装前的准备

2.1.1 Windows

2.1.1.1 硬件环境

ClearCase可以单机使用和供网络用户使用，本配置指明了在Intel结构机器上可安装环境的最低的配置

安装ClearCase时，系统必须要与网络正常连接，即“本地连接”处在已连接状态。如果是不联网的单机，必须安装支持本地回路的驱动器（见附录）。

硬件必须带有网卡。

2.1.1.2 软件环境

2.1.1.3 安装准备

在ClearCase安装前必须作如下准备：

2.1.1.

3.1 软件介质

ClearCase 安装介质；

如果打算使用UCM，需要准备ClearQuest 安装介质以及ClearQuest使用的数据库的安装介质；

如果没有安装好主域服务器，需要准备与已安装的安装机上的操作系统版本一致的操作系统的安装介质（单机使用除外）

2.1.1.

3.2 安装主域服务器

ClearCase是典型的C/S结构软件，使用了Windows的域用户管理机制，它要求所有用户登陆到域中工作，因此，安装前要准备好域环境。这样在各地要建立一个域控制器，之后各用户加入域开始工作。

一般情况下，一地应该建一个主域服务器和一个和多个备份域服务器，在主域服务器出现问题后，将其中的一个备份域服务器升为主域服务器，必须保证任何时刻都有一个备份域服务器。主域服务器最好是单独的一台机器，如不能实现，也最好和vob服务器及ClearQuest 的数据库服务器分开。

DNS服务安装：

公司的DNS服务器在192.168.2.8上，如果在公司工作，不需要安装DNS服务器。

安装域控制器必须先有DNS服务，如果公司已有DNS服务器，则可以在域控制器的网络设置中设置DNS服务器为已有的DNS服务器。如果没有，按下步骤安装DNS服务器。

选择“程序-〉管理工具-〉配置服务器-〉联网-〉DNS-〉安装DNS”，开始DNS的安装。在DNS服务安装后，建立正向搜索区和反向搜索区。

域控制器设置：

公司的域控制器在192.168.2.8上，如果在公司工作，不需要安装域控制器。

选择“开始”|“运行”，输入dcpromo，开始安装，安装过程中按照向导提示，使用默认配置即可。

在“新的域名”一步，输入新域的DNS全名，如https://www.360docs.net/doc/f19702142.html,,这是公司的域名；

在“数据库和日志文件位置”一步，选择数据库和日志文件的存放位置；

在“共享的系统卷”一步，选择sysvol文件夹的存放位置；

其余页面均使用向导提示的默认配置即可。

系统管理员在主域控制器安装成功后，需要在主域控制器上建立使用ClearCase的所有用户的用户帐号和用户分组。

2.1.1.

3.3 添加用户组和用户

安装域控制器后，根据实施方案，进行有关用户组及用户的设置，并赋予相应的权限。

添加用户组和用户的工作在主域控制器上实施。

添加用户组的操作为：

控制面板--〉管理工具—〉Active Directory 用户管理-〉新建-〉组

添加用户的操作为：

控制面板--〉管理工具—〉Active Directory 用户管理-〉新建-〉用户

将整个系统的配置管理员加入到clearcase组并设置为域的Administraters。

2.1.1.

3.4 配置其他服务器

其他服务器以及客户机必须加入到域中，因此，需要在其他服务器以及客户机上配置域，配置域的步骤为：

本机管理员的身份进入你的本机，在“开始-〉所有连接-〉本地连接-〉属性-〉Internal 协议，将DNS服务器设为配置域时所用的DNS服务器，公司的域服务器为192.168.2.8，除掉其他的DNS服务器(否则会很慢)，“高级”-〉DNS，选中“在DNS中注册此连接的地址”；在高级-〉WINS中，加入域控制器的IP（公司的域控制器的IP为192.168.2.8），选中“启用LMHOSTS查询”，选择“启用TCP/IP上的NetBIOS‖，重起计算机。

本机管理员的身份进入你的本机，在我的电脑-〉属性-〉网络标识），加入域。域名，域账号和口令由管理员提供，公司内的域名为此xxx, 域账号和口令为邮件的账号和口令。

本机管理员的身份进入你的本机，将域账号加为你的机器的系统管理员。操作步骤为：程序（或计算机管理）-〉管理工具-〉计算机管理-〉系统工具-〉本地用户和组，选中“Administrators,右键选择“添加到组”，此时用户列表窗口，按“添加”按钮添加，选择搜索范围为：https://www.360docs.net/doc/f19702142.html,，查找用户，选中你的域用户帐号，将域用户帐号加入到本机的Administrators组。

重启机器。

2.1.2 Unix

略。

2.2 ClearCase 安装

2.2.1 ClearCase client release area的安装

登陆本机，运行ClearCase安装程序：

1)在“deployment method”一步选择Enterprise deployment。

2)在“client or server”一步选择client。

3)在“service account”一步选择所属域，输入用于启动clearcase的域账号信息。

4)在“registry and mail servers”一步，“registry server host name”输入ClearCase服务器

机器名，“windows registry region”输入要加入的region名字，如“windows”，必须是在ClearCase服务器中已经建立的。

5)在“license server”一步，“where is your license server”选择“on a remote host”，在下面

的“enter remote host name”里输入ClearCase license server机器名。

6)在“rational license server”一步，输入“27000@ClearCase license server机器名”。

7)在“description”一步输入必要的提示信息，该信息在客户端安装过程中显示。

8)在“create release area”一步，在第一个编辑框中输入该release area的存放路径，该路

径应对安装用户及clearcase用户组为完全共享，路径格式为UNC形式，即\\机器名\\共享目录名，共享目录要有意义，如client_releasearea。在第二个编辑框中输入一个*.dat 文件名，该文件记录了上述过程中所配置的一些参数。该文件名也要有意义，如cc_client_setup.dat。点击“Next”后，会弹出创建快捷方式成功的对话框，点击OK即可。

9)在“launch installation”一步，不选中“launch installstion using these settings.”，如果想在

本机安装clearcase客户端，可选中。

10)其它的步骤按照默认配置即可。

2.2.2 ClearCase服务器（license server、registry server、vob

server）的安装

1)以域用户登陆本机，运行ClearCase安装程序，安装过程中以下步骤需进行选择：

2)在“deployment method”一步选择Desktop installation from CD image。

3)在“client or server”一步选择install server and client。

4)在“service account”一步选择所属域，输入用于启动clearcase的域账号信息。

5)在“registry and mail servers”一步，“registry server host name”输入registry server机器

名，“windows registry region”输入要建立的region名字，如“windows”。

6)在“license server”一步，“where is your license server”选择“on a remote host”。

7)在“rational license server”一步，输入“27000@license server机器名”。

8)其它的步骤按照默认配置即可。

2.2.3 ClearCase客户端的设置

1)以域账号登陆本机，访问client release area所在机器，进入client_releasearea文件夹，运

行cc_client_setup安装程序，开始安装。

2)安装时选择默认设置，完成后，重启机器。

2.3 安装成功的测试

安装完成后，在“开始|程序|Rational SoftWare|Rational ClearCase|Administration”下面有ClearCase Doctor，运行ClearCase Doctor进行安装诊断。从界面上可以查看ClearCase的安装信息。如果安装成功，将无Problem显示。如果有问题，会从‘Problem’页中显示出，可以按照提示解决。

3 使用案例

下面，以如下例子为线索，讲述项目的移植创建过程。

3.1 问题

假设有一个产品InforX,它已经开发了版本InforX 1.0 InforX 1.1,目前，有两个版本正在开发中，一个是以修改以前产品中的缺陷为目的版本InforX 1.2，另一个是增加了较多功能的版本InforX 2.0. 其中现有的归档文件都是使用cvs管理，cvs存放在机器Inforx_cvs上，路径为/InforX，用户cvs_user 可以访问，其口令为cvs_user，为方便在例子中的说明，假设该项目具有较少的归档文件（源代码及文档），分别存放在/InforX的子目录src和doc中，可以对应到ClearCase中的两个V ob InforX_Src_V ob和InforX_Doc_V ob。现在，我们需要将cvs中的所有的内容都移植到ClearCase中，并保留以前的版本、基线、分枝。

假设InforX产品开发组共有开发人员manager、integrator、admin、dev1、dev2、dev3、test等七个开发人员，其中，manager有一些特殊的东西要放在InforX_Secret_V ob中的目录中，不容许其他人看。

要求按照能清晰标出产品流、受控流和开发流的方式设置流、项目、VOB。

3.2 解决方案

假设我们已经按第二章中所述，建立好了主域https://www.360docs.net/doc/f19702142.html,, 主域服务器192.168.2.28，需要安装vob服务器、License和Registry服务器、和ClearQuest数据库服务器。设vob服务器为vobserver. https://www.360docs.net/doc/f19702142.html,, License和Registry服务器为License. https://www.360docs.net/doc/f19702142.html,，数据库服务器为database. https://www.360docs.net/doc/f19702142.html,.。

在此基础上，建立region,vobstorage, component,project, stream,view等

具体实施步骤如下：

3.2.1 安装环境

3.2.1.1 服务器安装与配置

1．用户管理，公司的clearcase的管理权限分为三级，所有的clearcase用户的权限组ccusers，项目组的权限组（项目名简称_grp）和项目组管理员的权

限组（项目名简称_manager）。

2．在主域服务器上建立用户组Inforx_Grp,建立用户manager、integrator、admin、dev1、dev2、dev3、test，将这些用户加入到用户组Inforx_Grp，并把Inforx_Grp

设为他们的主组，将组everyone或domain users从他们的组中删除。建立用

户组Inforx_Mgr_Grp,将manager加入到用户组Inforx_Mgr_Grp（操作见第

二章）；

3．将vob服务器加入主域https://www.360docs.net/doc/f19702142.html,，并设置为域中的服务器，安装ClearCase 服务器（操作见第二章）;

4．将License和Registry服务器加入到主域https://www.360docs.net/doc/f19702142.html,（可选），安装License和Registry服务（操作见第二章）；将ClearQuest License 服务器安装到License

和Registry服务器上，操作见ClearQuest手册；

5．将数据库服务器加入到主域https://www.360docs.net/doc/f19702142.html,（可选），安装数据库服务器；在数据库服务器上建立两个空database,如果是oracel，则建两个空色user.

6．将vob服务器上的License和Registry服务器指向192.168.2.8。控制面板->clearcase->Registry,选定Use Registry server on 在输入框填入192.168.2.8，

按“确定”按钮，设置Registry服务器。控制面板->clearcase->License，选

定Use License server on 在输入框填入192.168.2.8，按“确定”按钮，设置

License服务器。

7．在vob服务器上安装数据库的客户端；

8．在vob服务器上安装ClearQuest,用维护工具建立ClearQuest的基本连接“2003.06.00”(该连接必须存在)；建立ClearQuest的新连接Inforx以及存

放数据的数据库X.(操作见ClearQuest手册)，倒出profile文件到cqprofile.ini;

如果开发1.2和开发1.5的活动需要存放在不同的数据库中，则要创建两个

数据库X12和X15(详细见ClearQuest手册).

3.2.1.2 客户端配置

在各项目组成员使用的客户机上：

1．用本机管理员用户登陆，将本机加入到https://www.360docs.net/doc/f19702142.html,，操作见第二章；

2．重新启动计算机，用本机管理员用户登陆，将管理员分配给自己的域用户加为本机管理员用户；

3．用域用户登陆客户机，移植相应的软件；

4．安装ClearCase；

5．配置ClearCase的License和Registry服务器，操作见上节“服务器安装与配置”第五步；

6．安装数据库的客户端，并进行相关配置。

7．安装ClearQuest,并将上节“服务器安装与配置”第七步倒出的cqprofile.ini文件倒入。

操作见ClearQuest手册；

3.2.1.3 建立备份服务器

1．在主域服务器上建立ClearQuest备份的数据库服务器；

2．在ClearQuest数据库服务器上建立ClearCase的License和Registry服务器和ClearQuest License 服务器的备份服务器；

3．ClearCase的License和Registry服务器和ClearQuest License 服务器上建立备份域服务器；

4．ClearQuest数据库服务器上建立备份域服务器。

3.2.2 倒入历史数据

1.以配置管理员身份登陆到V ob服务器；

2.在Vob服务器上，建立region inforx_win,将当前region配置为inforx_win（操作见第

四章）

3.在Vob服务器的准备存放数据的盘上创建目录inforx,在inforx下创建目录：viewstore

和vobstore,将viewstore共享为x_view ,将vobstore共享为x_vob;在“资源管理器”

->目录->共享->权限->共享权限->组或用户名称中，将everyone或domain users去掉，加入Inforx_grp和clearcase, 并具有读写改的权限；在“资源管理器”->目录->共享

->安全->组或用户名称中，将everyone或domain users去掉，加入Inforx_grp和

clearcase，并具有读写改的权限。

4.创建基本的VOB InforX_Src_Vob和InforX_Doc_V ob及InforX_Secret_Vob,在命令

行下，使用cleartool pretectvob –add_group Inforx_grp vobtag 命令将Inforx_grp 组加

入VOB InforX_Src_V ob和InforX_Doc_V ob的additional group，同样方法，将

Inforx_mgr_grp 组加入VOB InforX_Secret_Vob的additional group.

5.创建view base_view(见第四章view操作)；

6.将cvs path /inforx下目录src或doc下的数据分别倒入InforX_Src_V ob的目录\src和

InforX_Doc_V ob的目录\doc中；（具体步骤见CVS数据倒入）

CVS数据倒入过程

1．在cvs服务器上，将cvs数据的根目录（即与配置中CVSROOT DATA的Path相对应的目录）共享出来，如：把服务器cvs 上的d:\cvs\cvsdata\inforeai（存放Inforeai项目数据）共享为\\ cvs\ inforeai，

2．把共享目录\\ cvs\ inforeai的读写权限付给everyone，检查目录d:\cvs\cvsdata\inforeai 的本地权限，保证准备everyone具有读写

3．在clearcase服务器上，将服务器cvs 上的共享目录\\ cvs\ inforeai映射到clearcase服务器上的一个虚拟盘，如：V:，注意：映射时输入的用户必须具有2中所说的权限。

4．将虚拟盘作如下操作：subst W: V:\ 如果已有，应先使用subst W: /d删除.

5．设置CVSROOT变量set CVSROOT=:local:W:\.

6．如果设置了环境变量HOMEDRIVE HOMEPA TH,应检查是否有目录% HOMEDRIVE%\% HOMEPATH%\CVS\Root存在，如果存在，系统将先倒出% HOMEDRIVE%\% HOMEPATH%\CVS\Root目录下与指定目录或文件名相同的目录或文件。

7．设置当前盘为W: ，倒出cvs数据索引到指定文件

w:>clearexport_cvs [-r] –A –V –o 倒出文件名路径

倒出文件名不能为已存在的文件名

路径为目录名或文件名，在为目录名时，--r代表包含所有子目录

8．进入一个view路径，如：z:

cd 目标vob目录

clearimport –verbose w:\ 倒出文件名

倒入数据到Vob

3.2.3 建立项目

建立项目前的准备

1．建立PV ob. 建立存放项目数据的vob Inforx_pvob;(操作见第五章PVOB);

2．使用project explorer->component->import -> vob as a component 将vob inforx_doc_vob 和inforx_src_vob倒入为component doc 和src;

3．使用import Label as baseline将cvs中的倒为Label基线；

4．建立空的component prj 作为复合基线的component；

5．将用户manager、integrator、admin、dev1、dev2、dev3、test等设置到clearquest 中。

3.2.4 项目设置

1．创建project inforx,以版本1.1的label为基线；

2．建立project inforx的集成流作为产品的release流inforx_release，并将项目的策略设置为可跨项目deliver；

3．创建project inforx1.2,以版本1.2的倒入label为基线,其集成流为inforx1.2_int,根据需要，设置项目数据库为x或x12;

4．创建project inforx2.0,以版本2.0的倒入label为基线,其集成流为inforx2.0_int, 根据需要，设置项目数据库为x或x20;

3.2.5 加入项目

1.使用域用户登陆本机，mount inforx_src_vob和inforx_doc_vob;

2.使用project explorer->project->join project 或clearcase explorer->tools->ucm-> join

project,在集成流上加入到project inforx1.2或project inforx2.0，创建自己的开发流及集成view和开发view；(操作见第五章)

3.设置该机上的clearquest登陆用户。

3.2.6 建立clearcase Multisite

在使用了ucm之后，在做Multisite时必须是PVOB,component VOB 以及clearquest备份数据库一起做Multisite，才能达到正常的两边可并行开发的效果。

在做multisite之前，另一边的环境也必须准备好，这里假设已经准备好了并且vob服务安装在机器192.168.2.231上,且ship server在这台机器上，并且共享了x_vobstore存放vob.

在上例中，步骤如下：

1．Mount inforx_pvob.如果inforx_pvob不含component，在正常状态下，inforx_pvob 没有被Mount；

2．从一个view进入inforx_pvob目录，键入：

multitool mkreplica –export –workdir c:\work –fship 192.168.2.231:jn_inforx_pvob

这里c:\work为工作目录，jn_inforx_pvob为目标replica的名称

3．在192.168.2.231服务器上，已管理员用户登陆，使用如下命令创建replica，jn_inforx_pvob

multitool mkreplica –import –workdir c:\work –tag inforx_pvob –vob \\192.168.2.231\x_vobstore\ inforx_pvob.vbs –npreserve –nc 收到的包的全路径

该命令创建了

4．同样，建立inforx_doc_vob及inforx_src_vob在192.168.2.231上的replica 3.2.7 建立clearquest Multisite

建立clearquest Multisite的步骤如下：

1.已管理员登陆vob服务器；

2.激活clearquest Multisite设置，命令如下：

multiutil activate –dbset dbset_name –clan clan_name –site site_name –u user password

其中dbset_name为使用的连接名，如2003.06.00, clan_name 为部落名，此名用户可以指定,如inforx，site_name为本地站点名，如jn, cs; user clearquest的连接用户，password 为user对应的密码。

在激活之后，打开clearquest 维护工具，上述命令中–dbset dbset_name中连接名改为CQMS. clan_name. site_name,如果使用的原dbset_name为2003.06.00，为防止clearcase 出错，需要复制CQMS. clan_name. site_name连接，并改名为2003.06.00。

3.创建创建Multisite的包。命令格式为：

multiutil mkreplica –export –clan clan_name –site site_name –family family_name –u user password –fship –workdir c:\temp 192.168.2.231:jn

其中family_name为clearquest连接中的database名，c:\temp为工作目录，jn为对方站点名，其他同上；

4.在另一方，以管理员登陆vob服务器，使用如下命令创建replica：

multiutil mkreplica –import –site jn –repo db-info –vendor vendor db-param –u user password –data db-info –vendor vendor db-param –workdir c:\temp收到的包的全路径

其中，–repo 之后的db-info –vendor vendor db-param 为存放MASTR数据库的数据库连接参数，–data 之后的db-info –vendor vendor db-param为存放复制过来的数据库的数据库连接参数，各连接参数的详细写法在命令中有说明，而且连接不同的数据库时写法不同，键入multiutil mkreplica –import回车，系统会详细解释各参数的写法。对于ORACLE 数据库，一定要写连接方式–con ―SERVER_VER=8.1;CLIENT_VER=8.1;

LOB_TYPE=LONG‖.

3.2.8 B地的开发

至此，B地的人员可以通过在A地传送过来的项目的流的基线上建集成流或项目的方式来完成开发，但是，如果B地的人员需要将开发的结果合并的集成流上去，则必须要按如下步骤实现：

1．将开发结果提交到集成流上，集成测试完成后，打基线BL_Inforx_20041225，推荐基线BL_Inforx_20041225；

2．将集成流的mastership改为A地，将基线BL_Inforx_20041225的mastership改为A地；

3．倒出clearquest数据库增量；命令如下：

multiutil syncreplica –export –clan clan_name –site site_name –family family_name –u user password –fship A地站点名

4．倒出需要同步的vob增量. 操作如下：

●从view进入vob的目录

●multitool syncreplica –export –fship –nc A地replica名

●反复使用上述命令倒出所有的vob增量

5．倒入clearquest数据库增量；命令如下

multiutil syncreplica –import –clan clan_name –site site_name –u user password -receive 6．倒入需要同步的vob增量. 操作如下：

multitool syncreplica –import -receive

7．使用deliver操作将流的基线deliver到相应的流上。

8．使用完成后，只需改动B地的集成流和基线的mastership，同步pvob,就能将B 地的集成流和基线的mastership传回去。

3.2.9 A地开发的增量传送

A地开发采用同步的方式，同步到B地，到达B地，在B地所设的集成流可以采用rebase 的方式，将新的结果更新到集成流上（此时不需要mastership），注意，如果B地所设的集成流上的内容有更新而且没有传送到A地集成，这样做会冲掉B地的开发，建议小心。

4 基本的ClearCase操作4.1 Region

1、创建region

2、删除region

3、设置

4.2 VOB操作

VOB的类型：

Public VOB和Private VOB，两者的主要区别是，pulic vob可以通过命令cleartool mount –all被mount，而Private VOB必须被显示指定的被mount。

Administrative VOB

Admin VOB(Administrative VOB)可以创建global types，其子VOB可以继承使用。在创建VOB时可指定其Admin VOB。

UCM VOB

PVOB(Project VOB)存储一个或多个项目的信息和活动。

Component VOB存储项目的源代码和元素，一个项目可以有多个component VOB，一个component VOB可以被多个项目共享。

1、创建VOB：

使用VOB creation wizard创建VOB。在开始菜单、Administration Console、ClearCase Explorer都可以打开VOB creation wizard。

选择“开始＞程序＞Rational SoftWare＞Rational ClearCase＞Administration＞Create VOB”

2、mount&unmount VOB

VOB建立之后，自动mount。如果要mount其他VOB，需要手动mount。

通过windows explore的clearcase上下文菜单、clearcase explore、administration console、cleartool commands均可以mount&unmount vob。

3、删除VOB

删除VOB之前，要在所有mount了该VOB的机器上unmount该VOB。

4.3 View操作

1、创建View

使用View creation wizard创建VOB。在开始菜单、Administration Console、ClearCase Explorer都可以打开View creation wizard。

选择“开始＞程序＞Rational SoftWare＞Rational ClearCase＞Create View”