ClearQuest® 连接器安装向导通过对模式应用 JazzInterop 包并接着将用户数据库升级到该模式的新版本来配置
IBM® Rational® ClearQuest 环境。但是,在 ClearQuest Multisite
环境中,您必须以手动方式将该包应用于副本模式并升级用户数据库副本。此向导仅将该包应用于
ClearQuest 网关所连接的副本。
关于此任务
JazzInterop 包将添加全局 Perl 脚本 ChangeHistoryScripts,并且将对模式添加下列记录类型:
- JazzConnectorChangeEvents
- JazzConnectorQueryInfo
- JazzConnectorSyncHistory
请参阅
Rational ClearQuest MultiSite
帮助,以了解有关应用包和升级用户数据库时应执行的步骤序列的详细信息。
您应该始终对模式应用最新版本的 JazzInterop 包(编号最大的版本)。如果先前已对模式应用低版本的包,那么请以递增方式升级到最新版本。例如,如果 1.06 是最新版本,那么要从 1.03 升级到 1.06,请执行下列任务:
- 对模式应用 JazzInterop 1.04。
- 升级用户数据库。
- 对模式应用 JazzInterop 1.05。
- 升级用户数据库。
- 对模式应用 JazzInterop 1.06。
- 升级用户数据库。
要对模式应用 JazzInterop 包并升级用户数据库,请执行下列操作:
- 在运行 Windows® 的计算机上,复制 install-directory/gateway/cqPackage/JazzInterop
文件夹并将其粘贴到 cq-install-dir/packages 文件夹。
- 转到 cq-install-dir 文件夹。使用 packageutil 命令向 ClearQuest 注册
JazzInterop 包。如果需要对模式应用多个版本的包以升级到最新的包版本,请将此命令运行多次并且每次指定不同的包版本,然后再执行下一个步骤。例如:
packageutil registerpackage JazzInterop package-version "C:\Program Files\Rational\ClearQuest\packages\JazzInterop\package-version"
- 运行以下命令,以使 JazzInterop 包能够更新您先前通过对模式应用其他包添加到该模式的记录类型。
packageutil enablepackageediting -dbset dbset_name clearquest_login clearquest_password -enable user
您使用
clearquest_password 参数指定的用户必须具有模式设计者特权。admin
用户帐户具有超级用户特权,这些特权包括模式设计者特权。例如:
packageutil enablepackageediting -dbset my_schema_repo admin "" -enable admin
- 通过单击,打开
ClearQuest Designer。在“模式存储库浏览器”视图中,右键单击模式版本,然后选择。展开 JazzInterop
文件夹,然后选择要应用的程序包的版本。单击下一步。选择要启用同步的记录类型。单击完成。检入该模式的新版本。
- 再次使用 packageutil enablepackageediting 命令,并指定 -disable 选项将记录类型恢复为只读状态。例如:
packageutil enablepackageediting -dbset my_schema_repo admin "" -disable admin
- 单击。右键单击要升级的用户数据库,然后单击升级数据库。此时将打开“升级用户数据库”窗口。从“版本”列表中选择新的模式版本,然后单击确定。
下一步做什么
以后,如果您决定将 JazzInterop 包应用于同一模式中的另一个有状态记录类型,那么请先运行
packageutil enablepackageediting 命令并指定 -enable 选项。打开
ClearQuest Designer 并检出该模式。在“模式存储库浏览器”视图中,展开
记录类型文件夹。右键单击记录类型,然后选择
为包设置记录类型。选择
JazzInterop 包,然后单击
确定。检入该模式的新版本。运行
packageutil enablepackageediting 命令并指定 -disable 选项。将用户数据库升级到该模式的新版本。
要对另一个无状态记录类型应用 JazzInterop 包,那么必须使用另一个过程。打开
ClearQuest Designer 并检出该模式。在“模式存储库浏览器”视图中,展开记录类型 - 无状态文件夹。展开无状态记录类型的文件夹。双击操作。单击新建操作。在操作名称操作名称中输入
Change_History。在类型字段中选择
BASE。关闭“操作”对话框以保存变更。在 Change_History 操作的通知单元格中单击。再次单击,然后选择
。双击该单元格,以打开脚本编辑器。将下面这一行粘贴到编辑器中的最后一个注释行之后:JazzCQConnector($actionname, $actiontype);。保存变更,然后关闭编辑器。关闭“操作”矩阵。检入该模式。将用户数据库升级到该模式的新版本。