任何支援 TRS 規格的生命週期工具都可以用來作為資料來源,來建立「已鏈結生命週期資料索引」。此主題說明如何使用根服務文件,在不同於 LQE 的 JTS 上,為生命週期工具產生索引。這是針對遠端 Jazz™ Team Server 上的應用程式,將資料來源新增至 LQE 的最簡單方法。
關於這項作業
如果應用程式具有的根服務文件宣告了專屬 OAuth URL,則可以透過根服務 URL 來登錄 TRS。如果向不同於 LQE 的 JTS 登錄了應用程式,則此方法通常是偏好的方法。如果 LQE 與 TRS 提供者(應用程式)通訊,則 LQE 將直接與應用程式通訊,並且直接向應用程式鑑別。因此,必須在應用程式中,給 LQE 建立「OAuth 消費者密碼/金鑰」配對。該入埠消費者必須受信任,並且必須具有功能使用者 (lqe_user)。必須將「TRS 內部授權」指派給功能使用者。
程序
- 在 LQE 管理畫面中,選取資料來源畫面。 這個畫面顯示 LQE 所連接之任何資料來源的即時狀態。
- 選取新增資料來源,然後按一下根服務 URL。
- 為您要新增的應用程式輸入根服務文件。此文件的預設格式為:https://server:port/tool/rootservices。
- 此根服務文件中列出的資料來源,是以類似於下列格式的格式來列出:https://server:port/tool/trs。請選取要新增的資料來源。
- 新增標籤作為資料來源的 ID。
- 排程欄位可讓您設定起始編製索引的時機。將欄位保留空白會導致只要精靈一完成就建立索引。在測試實驗室環境中,LQE 可在 1 個小時內檢索 50 000 個構件 - 視您的硬體與配置而定,檢索速率可能較慢。
註: 您可以同步編製多個資料來源的索引。每一個都會在自己的執行緒執行。或者,您也可以排程多個 TRS 資料來源的起始編製索引作業,使其一個接著一個執行。
- 因為應用程式位在不同於 LQE 的 JTS 上,所以您將需要指定 OAuth 鑑別。按下一步。
- 在指定鑑別詳細資料畫面上,輸入應用程式的「OAuth 消費者金鑰」及「密碼」。
- 在另一個瀏覽器視窗中,於登錄應用程式作為 Lifecycle Query Engine 的 TRS 提供者中,找到您為 LQE 產生的金鑰。在此範例中,您要新增 QM 應用程式,因此將移至 QM 管理畫面:https://server:port/QM/admin#action=com.ibm.team.repository.admin.configureOAuth。
註: 除非將鑑別委派給 Jazz Team Server,否則應該移至應用程式的管理畫面,而不是 Jazz Team Server 管理畫面。
- 在授權金鑰清單下,找到並複製 lqe_user 金鑰及密碼。
- 回到 LQE 瀏覽器視窗,並輸入消費者金鑰及密碼。
- 選取資料來源配置選項。
- 更新頻率指定 LQE 嘗試存取資料來源以持續重新整理其索引的頻率。相較於持續更新的資料來源,未經常更新的資料來源可以有較低的更新頻率。增加更新頻率會影響效能。
- 起始編製索引的執行緒數通常應該設為 2 和 4 之間。每一個執行緒大致上相等於一個使用 LQE 伺服器的使用者。若為 Intel 機器,至少需要超過 4 個執行緒才能改善資料擷取速率。
- 持續編製索引的執行緒數通常應該設為 2 和 4 之間。每一個執行緒大致上相等於一個使用 LQE 伺服器的使用者。若為 Intel 機器,至少需要超過 4 個執行緒才能改善資料擷取速率。
- 如果略過的資源允許 LQE 記載錯誤,會持續進行漸進式更新;如果發現無法編製索引的資源,其會繼續編製索引。依預設會選取此選項。如果停用,只要資源無法編製索引,編製索引程序即會停止。
- 完成精靈之後,畫面上會顯示這個資料來源隨時可配置的資料。按一下儲存來開始編製索引。 編製索引程序的即時狀態會顯示在主要資料來源畫面中。
按一下狀態欄位中的鏈結會顯示編製索引程序的深度狀態報告。
下一步
如果您需要在任一點停止編製資料來源的索引或暫停編製索引程序,請在主要「資料來源」視窗將滑鼠移至動作欄位,以顯示暫停、停止或刪除索引的圖示。