「ClearQuest® Connector 設定精靈」
會將 JazzInterop 套件套用至綱目,然後將使用者資料庫升級至綱目新版本,來配置您的 IBM® Rational® ClearQuest 環境。但是在 ClearQuest Multisite 環境中,您必須手動將套件套用至抄本綱目,並升級使用者資料庫抄本。精靈只會將套件套用至連接
「ClearQuest 閘道」的抄本。
執行這項作業的原因和時機
JazzInterop 套件會新增一個廣域 Perl Script (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 參數中指定的使用者必須具備綱目設計者專用權。具有管理權的使用者帳戶具備超級使用者專用權,而其中亦包含綱目設計者專用權。例如: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 動作的通知資料格。再按一下選取 。按兩下資料格,開啟 Script 編輯器。將下列字行貼到編輯器中的最後一行備註行後面:
JazzCQConnector($actionname,
$actiontype);。儲存變更,並關閉編輯器。關閉「動作」矩陣。移入綱目。以新版本的綱目升級使用者資料庫。