Base ClearCase与ClearQuest的集成

4.2.2 在ClearCase VOBs上安装触发器(Triggers)

CCCQ的集成应用到了针对cleartool checkin, checkout和uncheckout操作的触发器，触发器的安装与配制需要在Windows端配制，该Windows的Registry Server必须与UNIX上建VOBs的那台Server指向同一台Registry Server。具体配置过程如下所述：

4.2.2.1 同步UNIX与Windows上的ClearCase Regions

1) 在Windows上新建一个Region，名称与需要同步的UNIX上的Region名称相同，这时UNIX上的Region就在Registry Server上注册了。

2) 运行 -> cleartool -> mkregion -tag <UNIX region>

3) 开始 -> 程序 -> Rational Software ->

4) Rational ClearCase'Administration'Region Synchronizer

图 (02) 导入Unix服务器上的VOB

5) 选择需要同步的Windows Region和UNIX Region, 在Import Type一项上选择"VOB Tags"并且选中"Show full storage directory paths.

6) 在"Unix VOB tags not found in the Windows region"列表中选择需要引入的VOB，点击"Import"，这时"Create VOB Tag"对话框会显示出来。在"Global Storage"一项中输入在UNIX服务器上的VOB的网络存储路径，并且在"Hostname"一项中输入在Region内能够解析的主机名。

图 (03) 创建Tag

4.2.2.2 将一个VOB安装上Trigger

当一个VOB被引入（Import）后，我们可以对其安装Trigger 在ClearCase中，点击开始 -> 程序 -> Rational Software'Rational ClearCase'Administration'Integrations'ClearQuest Integration Configuration. 这时出现如下图所示的对话框。

图 (04) 应用Trigger

在"ClearCase - ClearQuest Integration Configuration"对话框中，我们可以看到所有在UNIX服务器端建立好的VOBs，并且可以对其中任何一个VOB安装trigger。在这里，我们对VOB int4安装Checkout和Checkin的trigger。Trigger的配制文件在config.pl中有详细说明，关于trigger选择的详细内容可以参看上一章节。

提示：

• 触发器使用config.pl配制文件来控制本地集成的配制参数。当选择V2触发器时，配置应用程序会将config.pl文件路径设为CQCC/config.pl，在这个路径中CQCC代表了本地的cc-home-dir/lib/perl5/CQCCTrigger/CQCC这个路径，用户可以根据需要将这个路径改变为一个UNC路径，因此所有的集成操作将调用一个中心配制文件config.pl。
• 在安装触发器时，只有VOB的所有者才可以对自己创建的VOB安装触发器。如果一个用户e.g. Harry登陆Windows，他想对Andy在UNIX上创建的VOB安装触发器，这时会出现"无法得到触发器类型"等警告。如果Harry希望可以对VOB安装触发器，那么需要执行以下两步：
• 在DOS模式下运行Runas /user:RATIONALCC\Andy cmd.exe命令，这个命令将以Andy的身份打开一个DOS窗口，并提示输入用户名和密码。
• 在验证通过登陆后，另一个DOS窗口将会打开，在这个窗口中，运行"cqconfig"来以Andy的身份在VOB上安装触发器。

4.2.3 核心文件config.pl的配置

config.pl文件的配置在Base ClearCase与ClearQuest集成的操作中起到重要的作用。config.pl文件中包含了一系列变量及参数的设置，设置的描述，以及在哪里可以配制这些参数（是在config.pl文件本身中设置还是在系统环境变量中设置）。

config.pl文件在不同操作系统上的存储路径：
Windows:C:\Program Files\Rational\Clearcase\lib\perl5\CQCCTrigger\CQCC\config.pl
UNIX: /usr/atria/sun5/lib/perl/CQCCTrigger/CQCC/config.pl

下面就一些重要的参数配置进行详细的说明：

4.2.3.1 定义用户数据库

&SetConfigParm("CQCC_DATABASE_ENTITY_LIST","SAMPL: defect");
CQCC_DATABASE_ENTITY_LIST参数定义了一个或多个数据库和数据库所支持的数据纪录类型。当定义多个数据库时，参数的使用格式为：dbname1: entity1,entity2; dbname2: entity3,entity4。值得注意的是数据纪录类型必须为在schema中已定义好的内容。

4.2.3.2 定义DBsets

&SetConfigParm("CQCC_DATABASE_SET", "<db_set_name>");
在ClearQuest中，当建立有多个DBsets时，即有多个schema存储空间时，CQCC_DATABASE_SET参数用来指定一个当前可以使用的schema存储空间。

4.2.3.3 选择集成模式: 文本模式或图形模式

&SetConfigParm("CQCC_GUI_ENABLE", "OFF");
此参数是一个开启Perl/TK GUI图形界面的开关。如果设置为"ON"（默认情况下），那么图形界面会在需要的情况下显示，例如，在运行xclearcase时。如果设置为"Always"，那么图形界面会在命令行操作的形式也显示。如果设置为"OFF"，那么图形界面将永远不显示，因此只可以用命令行操作。

4.2.3.4 开启DEBUG模式

&SetConfigParm("CQCC_DEBUG", "1");

此参数用来控制在运行时模式下DEBUG报告的输出级别。0 - 代表没有输出；1 - 代表基本输出（针对高级别的操作）；2 - 代表细节输出。

提示：其他参数设置的详细说明请参看config.pl文件。

4.2.4 执行Base CCCQ集成的最后检验

此时，根据以上所提供的信息，我们应能够完成cqcc检验，检验ClearCase与ClearQuest是否能够很有效的结合，并可以开始完成一些简单的操作。

在UNIX客户端运行：cqcc_launch -test

此时，cqcc_launch命令将会调用config.pl里的参数并试图连接ClearQuest，如果连接成功，exit_status会显示0，否则将显示1（如下图所示）

图 (05) 验证配置

5 在Windows的平台上的操作范例

可以说，Base ClearCase的基本操作，就是Check Out和Check in两个操作，下面就简单介绍一下这两个操作。