如果您使用 Rational® Engineering Lifecycle Manager,則需要配置步驟來將產品設為 TRS 提供者,以提供「生命週期查詢引擎」存取其資料。
安裝並配置所有應用程式之後,以及在遠端伺服器上的應用程式之間建立夥伴關係之後,將每一個應用程式設為「已追蹤資源集 (TRS)」提供者,以便「生命週期查詢引擎 (LQE)」可以存取其資料以建立索引。
必要條件:
重要: 如果應用程式位於 LQE 之外的 Jazz™ Team Server 上,則此作業中產生的金鑰會在稍後將資料來源新增至「生命週期查詢引擎」時重複使用,如
產生 LQE 索引中所述。請格外注意每個金鑰的名稱和密碼。
指派 TRS 消費者內部授權
將「TRS 消費者內部授權」指派給 lqe_user 和 jts_user 功能使用者。
- 開啟 JTS 管理主控台,位置如下:https://host_name:port/jts/admin
- 選取使用者 > 作用中使用者。
- 按一下 lqe_user 鏈結。在 lqe_user 頁面上,跳至用戶端存取授權區域,選取 TRS 消費者內部,然後按一下儲存。
- 回到作用中使用者頁面。
按一下 jts_user 鏈結。
在 jts_user 頁面上,跳至用戶端存取授權區域,然後選取 TRS 消費者內部。
- 按一下儲存。
針對 CLM 應用程式來配置 TRS
如果這些應用程式是部署在與 LQE 相同的 Jazz Team Server 上,則不需要建立入埠消費者。只有當 CCM、QM 和 RM 應用程式位於個別 Jazz Team Server 上時,才完成這些步驟。
- 建立 CCM 的「LQE 入埠消費者」金鑰。開啟 CCM 管理頁面:https://host_name:port/ccm/admin
- 在應用程式頁面中,選取通訊 >消費者(入埠), 建立一個 LQE 的新 「OAuth 消費者」金鑰:
按一下登錄。
- 移至授權金鑰清單,按一下鉛筆圖示來編輯 LQE 項目。
- 在編輯消費者金鑰內容對話框中,按一下選取使用者... 鏈結。
- 在過濾器欄位中,輸入 lqe,從符合使用者清單中選取 lqe_user。
按一下新增和關閉,然後按一下完成。
- 建立 QM 的「LQE 入埠消費者」金鑰。開啟 QM 管理頁面:https://host_name:port/qm/admin,然後再次完成步驟 7 到 10。
- 如果這是您的 RM 應用程式,請建立 DOORS® Next Generation 的「LQE 入埠消費者」金鑰。開啟 RM 管理頁面:https://host_name:port/rm/admin,然後再次完成步驟 7 到 10。
- 將應用程式登錄為 TRS 提供者,然後產生它的索引。開啟「生命週期查詢引擎」管理頁面:https://host_name:port/lqe/web。
- 按一下管理 > 資料來源 > 新增資料來源。
- 在新增資料來源對話框中,選取 https://host_name:port/ccm/oslc/workitem/trs,然後新增 RTC 標籤。接受其餘預設值(如果您有大量要編製索引的資料,請增加執行緒數目,起始索引為 4),然後按一下完成。
- 將 QM 登錄為 TRS 提供者,產生它的索引。
在資料來源頁面中,按一下新增資料來源。
- 在新增資料來源對話框中,選取 https://host_name:port/qm/trs,然後新增 RQM 標籤。接受其餘預設值,然後按一下完成。
- 將 RM 登錄為 TRS 提供者,產生它的索引。在資料來源頁面中,按一下新增資料來源。
- 在新增資料來源對話框中,選取 https://host_name:port/rm/trs,然後新增 DNG 標籤。接受其餘預設值,然後按一下完成。
現在您的 Rational Team Concert™、Rational Quality Manager 和 Rational DOORS Next Generation 應用程式已編製索引,可供 Rational Engineering Lifecycle Manager 使用。如需持續編製索引之喜好設定的相關資訊,請參閱:利用生命週期查詢引擎編製您的資料索引
將 DOORS 和 DOORS Web Access 配置成 TRS 提供者
Rational DOORS Web Access 隨附了若干可供啟用 TRS 的預設使用者和密碼。您必須依照下列程序所說明來編輯與這些使用者相關聯的配置參數。這項整合使用下列使用者:
- LQE 功能使用者。
這個使用者會處理整合 TRS 消費者應用程式向 Rational DOORS Web Access 發出的 LQE 要求。
這個使用者必須在 Rational DOORS 資料庫中。您必須在 festival.xml 檔中指定這個使用者的參數。
- trs.db.user。這是有權存取 TRS 資料庫資料的 Derby 資料庫使用者。
Rational DOORS Web Access 利用它來擷取資料庫中的資料。
- derby.user.admin。這是 Derby 資料庫管理者。
目前,這個使用者不提供 Rational DOORS Web Access 或 Derby 資料庫的功能。
您可以在 Derby 內容檔中,設定這個使用者的密碼。
- 開啟 [DWA_path]\server\festival\config\festival.xml。
- 搜尋可配置的系統內容區段。
- 新增在下表中列出的內容。
內容格式化:
<f:property name="property_listed_in_table" value="appropriate_value_or_default_listed_in_table" />
表 1. TRS 及 LQE 的 Festival.xml 檔內容| 內容 |
說明/值 |
| functional.user.consumer.key |
與「LQE 功能使用者」相關聯的消費者金鑰。
「生命週期查詢引擎」利用它來存取「DOORS 已追蹤資源集 (TRS)」。
這個金鑰必須在 Rational DOORS 配置本端金鑰標籤上。 |
| functional.user.consumer.secret |
與「LQE 功能使用者」相關聯的消費者密碼。
「生命週期查詢引擎」利用它來存取「DOORS 已追蹤資源集 (TRS)」。
這個密碼必須在 Rational DOORS 配置本端金鑰標籤上。 |
| functional.user.name |
「LQE 功能使用者」的使用者名稱。
這個使用者名稱必須是有效的 Rational DOORS 使用者。
確保您在 festival.xml 檔中使用的 DOORS 使用者 ID 存在,且具有對您在工作集中顯示之專案及構件的完整存取權。 |
| functional.user.password |
「LQE 功能使用者」的密碼。 |
| trs.db.user |
啟用 TRS 的使用者名稱。
為了簡單,請使用預設使用者名稱 trs.db.user。如果未指定此內容,則系統會使用預設值。 |
| trs.db.password |
trs.db.user 的密碼。
您也必須在 Derby 內容檔中指定這個密碼。預設值是 dwaTrsPa11word。如果未指定此內容,則系統會使用預設值。 |
| trs.page.size |
要併入頁面中的 TRS 資源數目。預設值是 250。如果未指定此內容,則系統會使用預設值。 |
| trs.enable |
將這個值設為 true。 |
下列自
festival.xml 檔的擷取顯示與 TRS 相關之內容的範例:
<f:property name="functional.user.consumer.key" value="xyz" />
<f:property name="functional.user.consumer.secret" value="xyz" />
<f:property name="functional.user.name" value="Administrator" />
<f:property name="functional.user.password" value="qwert6" />
<f:property name="trs.enable" value="true" />
- 選用項目:在編輯器中開啟 derby.properties 檔。此檔案位於 dwa_install/derby 目錄中。
- 選用項目:取代下表中各參數的密碼值。
表 2. TRS 的 Derby 內容檔參數| 參數 |
說明 |
| derby.user.trs |
您在 festival.xml 檔中指定的 trs.db.user 的密碼。預設值是 dwaTrsPa11word。 |
| derby.user.admin |
Derby 資料庫管理者的密碼。
目前,這個使用者不提供 Rational DOORS Web Access 或 Derby 資料庫的功能。
預設值是 dwaTrsPa11word。 |
- 起始設定 TRS 資料庫。執行下列 Script:
- 以類型為「資料庫管理員」的使用者身分或「管理者」身分登入 Rational DOORS 用戶端。
- 選取。在「本端金鑰」視窗中,按一下新增。使用在 festival.xml 檔中指定的值。
- 消費者名稱:任何名稱。建議使用 LQE。
- 消費者金鑰:為 functional.user.consumer.key 內容設定的值。
- 消費者密碼:為 functional.user.consumer.secret 內容設定的值。
按一下登錄,然後按確定。
- 選取。在「選取專案」視窗中,選取您想要顯示給 LQE 的專案、資料夾及模組。
- 在選取模組窗格中選取所有必要模組。按一下套用。
配置 LQE 來使用 DOORS Web Access 作為資料來源
- 瀏覽至 https://hostname:port/lqe/web
- 在工具列功能表中選取管理。
- 在資料來源頁面中,選取新增資料來源
- 在新增資料來源對話框中,選取「根服務」文件 URL 選項。輸入 DOORS 根服務 URL。選取 TRS URL。輸入一個標籤,並選取指定鑑別詳細資料。
- 根服務 URL:https://doorsserver:port/dwa/public/rootservices
- 選取 https://doorsserver:port/dwa/rm/trs
- 標籤:DOORS
- 輸入消費者金鑰和密碼。
註: 「消費者金鑰」和「密碼」必須符合 DOORS Web Access
festival.XML 檔中的值。在下方的範例中,值
xyz 是一個範例。
<f:property name="functional.user.consumer.key" value="xyz"/>
<f:property name="functional.user.consumer.secret" value="xyz"/>
- 將第一次及增量編製索引的執行緒數目設為 1,然後按一下完成。
如果使用多個執行緒來編製索引,則有時可能會發生錯誤。
配置 Rhapsody Design Manager 應用程式的 TRS
- 跳至 https://hostname:port/jts/admin
註: Design Manager 入埠消費者是在 Jazz Team Server 管理主控台中定義,而不是 Design Manager 主控台。
- 選取伺服器 > 消費者(入埠),輸入下列內容,然後按一下登錄:
- 跳至授權金鑰清單,按一下鉛筆圖示來編輯 LQE 項目。
- 在編輯消費者金鑰內容對話框中,按一下選取使用者... 鏈結。
- 在過濾器欄位中,輸入 lqe,從符合使用者清單中選取 lqe_user。
按一下新增和關閉,然後按一下完成。
- 跳至 https://hostname:port/dm/web
- 以管理使用者的身分登入。
- 選取您的專案區域,然後從管理下拉功能表(齒輪圖示)中,選取管理專案內容。選取預設 OSLC 環境定義,然後按一下選取。按一下專案名稱,再按確定,然後按儲存。
- 將 Rhapsody® DM 登錄為 TRS 提供者,並產生它的索引。開啟「生命週期查詢引擎」管理頁面:https://lqe_host_name:port/lqe/web。
- 按一下管理 > 資料來源 > 新增資料來源。
- 在新增資料來源對話框中,選取 http://rdm_host_name:9443/dm/trs,然後新增 RDM 標籤。
接受其餘預設值(如果您有大量要編製索引的資料,請增加執行緒數目,起始索引為 4),然後按一下完成。
配置 Rational Engineering Lifecycle Manager 應用程式的 TRS
如果是新建安裝,則不會有任何資料可供編製索引。您可以建立一個專案和產品範例,以便可以驗證是否已順利編製索引。
- 開啟「生命週期查詢引擎」管理頁面:https://lqe_host_name:port/lqe/web。
- 按一下管理 > 資料來源 > 新增資料來源。
- 在新增資料來源對話框中,選取 http://relm_host_name:port/productdef/resource/tracked_resource_set,然後新增 RELM 標籤。接受其餘預設值(如果您有大量要編製索引的資料,請增加執行緒數目,起始索引為 4),然後按一下完成。
- 如果要測試索引,請開啟 Rational Engineering Lifecycle Manager:https://relm_host_name:port/relm/web
- 選取一個專案範例。從查詢功能表中,選取共用查詢。
- 展開「範例」節點,然後選取所有構件。
系統可能會提示您對所查詢的所有應用程式進行授權。在「使用者授權」頁面(https://relm_host_name:port/lqe/web/auth)上,按一下您想要查詢之每一個應用程式旁邊的授權。
- 查詢結果會顯示您建立的產品範例。
配置 Jazz Team Server 使用者的 TRS
- 開啟「生命週期查詢引擎」管理頁面:https://lqe_host_name:port/lqe/web。
- 按一下管理 > 資料來源 > 新增資料來源。
- 在新增資料來源對話框中,選取 http://host_name:port/jts/trsUsers,然後新增使用者標籤。接受其餘預設值,然後按一下完成。
下一步
將應用程式配置為 TRS 提供者之後,遵循執行查詢來測試或除錯中的步驟,以驗證您的配置。