如果您使用 Rational® Engineering Lifecycle Manager,需要其他的配置步驟來將產品設定為 TRS 提供者,以提供「生命週期查詢引擎」存取其資料。如果您不是使用 Rational Engineering Lifecycle Manager,則不需要完成本節的步驟。
在您安裝及配置所有應用程式,並建立遠端伺服器上之各應用程式之間的夥伴關係之後,您必須將每個應用程式設定為「已追蹤資源集 (TRS)」提供者,以便「生命週期查詢引擎」在建立索引時能夠存取它們的資料。
指派 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 和 Derby 隨附了若干可供啟用 TRS 的預設使用者和密碼。
您必須依照下列程序所說明來編輯與這些使用者相關聯的配置參數。
這項整合使用下列使用者:
- LQE 功能使用者。
這個使用者會處理整合 TRS 消費者應用程式向 Rational DOORS Web Access 發出的 LQE 要求。
這個使用者必須在 Rational DOORS 資料庫中。您必須在 festival.xml 檔中指定這個使用者的參數。
- trs.db.user。這是有權存取 TRS 資料庫資料的 Derby 資料庫使用者。
Rational DOORS Web Access 利用它來擷取資料庫中的資料。
您必須在 festival.xml 檔及 Derby 內容檔中指定這個使用者的密碼。
- derby.user.admin。這是 Derby 資料庫管理者。
目前,這個使用者不提供 Rational DOORS Web Access 或 Derby 資料庫的功能。
您可以在 Derby 內容檔中,設定這個使用者的密碼。
- 開啟 [DWA_path]\server\festival\config\festival.xml。
- 搜尋可配置的系統內容區段。
- 在 oauth.domain 內容之下,
新增下表所列的內容,替換成您的 DOORS 管理 ID 和密碼,然後選取一個消費者金鑰和密碼。
這些內容的格式應該如下:
<f:property name="functional.user.consumer.key" value="consumer_key" />
表 1. TRS 和 LQE 的 Festival.xml 檔內容內容 |
說明/值 |
ForceHttpsForAuthenticationForOAuth |
將這個值設為 true。 |
oauth.domain |
將這個值設為 https://server:port/dwa,其中 server 是伺服器網域名稱或 IP 位址。 |
functional.user.consumer.key |
與「LQE 功能使用者」相關聯的消費者金鑰。
「生命週期查詢引擎」利用它來存取「DOORS 已追蹤資源集 (TRS)」。
這個金鑰必須在 Rational DOORS 配置本端金鑰標籤上。
預設值是 LQE 功能使用者金鑰。 |
functional.user.consumer.secret |
與「LQE 功能使用者」相關聯的消費者密碼。
「生命週期查詢引擎」利用它來存取「DOORS 已追蹤資源集 (TRS)」。
這個密碼必須在 Rational DOORS 配置本端金鑰標籤上。
預設值是 qwert6。 |
functional.user.name |
「LQE 功能使用者」的使用者名稱。
這個使用者名稱必須是有效的 Rational DOORS 使用者。
預設值是 LQE 功能使用者。 |
functional.user.password |
「LQE 功能使用者」的密碼。
預設值是 qwert6。 |
trs.db.user |
啟用 TRS 的使用者名稱。
為了簡單,請使用預設使用者名稱 trs.db.user。 |
trs.db.password |
trs.db.user 的密碼。
您也必須在 Derby 內容檔中指定這個密碼。 |
trs.page.size |
要併入頁面中的 TRS 資源數目。預設值是 250。 |
trs.enable |
將這個值設為 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。 |
- 執行下列批次檔:dwa_install/derby.start.bat。
- 執行下列批次檔:dwa_install/derby/scripts/init_trs.bat。
- 啟用「資料變更通知 (DCN)」參數,配置 Rational DOORS 資料庫伺服器來與 Rational DOORS Web Access 分配管理系統及 Rational DOORS Web Access 伺服器通訊。如需這個主題的相關資訊,請參閱:http://publib.boulder.ibm.com/infocenter/doorshlp/v9/index.jsp?topic=/com.ibm.rational.dwa.install.doc/topics/c_setupddbs.html
- 依照下列順序,重新啟動 DOORS Web Access 伺服器:
- 分配管理系統
- 交互作業能力
- 資料庫伺服器
- Web 應用程式伺服器
- 利用這些認證來登入 Rational DOORS:
- 使用者名稱:LQE 功能使用者,或您在 festival.xml 檔中指定的功能使用者名稱。
- 密碼:qwert6,或您在 festival.xml 檔中指定的功能使用者密碼。
- 在檔案功能表中,選取 OSLC...本端金鑰,然後按一下新增。
按一下登錄,然後按確定。
- 從檔案功能表中,選取 OSLC...工作集。
- 在選取專案窗格中,尋找需求資料夾,然後在選取模組窗格中選取此資料夾包含的所有模組。按一下套用。
配置 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 檔中的值。
<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
- 選取一個專案範例。從查詢功能表中,選取共用查詢。
- 展開「範例」節點,然後選取所有構件。
系統可能會提示您對所查詢的所有應用程式進行授權。
在您想要查詢的每個應用程式旁,按一下授權。
- 查詢結果應該會顯示您建立的產品範例。
配置 Jazz Team Server 使用者的 TRS
- 開啟「生命週期查詢引擎」管理頁面:https://lqe_host_name:port/lqe/web。
- 按一下管理 > 資料來源 > 新增資料來源。
- 在新增資料來源對話框中,選取 http://host_name:port/jts/trsUsers,然後新增使用者標籤。接受其餘預設值,然後按一下完成。